org.jdbi.v3.core.mapper

Interface RowMapper<T>

Type Parameters:

T - the mapped type.

All Known Implementing Classes:

BeanMapper, ConstructorMapper, FieldMapper, JoinRowMapper, MapEntryMapper, MapMapper, SingleColumnMapper

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface RowMapper<T>

Maps result set rows to objects.

See Also:

RowMappers, RowMapperFactory, ResultBearing.map(RowMapper), Configurable.registerRowMapper(RowMapper), Configurable.registerRowMapper(Type, RowMapper)

Method Summary

Modifier and Type	Method and Description
T	map(ResultSet rs, StatementContext ctx) Map the row the result set is at when passed in.
default RowMapper<T>	specialize(ResultSet rs, StatementContext ctx) Returns a specialized row mapper, optimized for the given result set.

Method Detail

map

T map(ResultSet rs,
      StatementContext ctx)
throws SQLException

Map the row the result set is at when passed in. This method should not cause the result set to advance; allow Jdbi to do that, please.

Parameters:

rs - the result set being iterated

ctx - the statement context

Returns:

the value to return for this row

Throws:

SQLException - if anything goes wrong go ahead and let this percolate; Jdbi will handle it

specialize

default RowMapper<T> specialize(ResultSet rs,
                                StatementContext ctx)
                         throws SQLException

Returns a specialized row mapper, optimized for the given result set.

Before mapping the result set from a SQL statement; Jdbi will first call this method to obtain a specialized instance. The returned mapper will then be used to map the result set rows, and discarded.

Implementing this method is optional; the default implementation returns this. Implementors might choose to override this method to improve performance, e.g. by matching up column names to properties once for the entire result set, rather than repeating the process for every row.

Parameters:

rs - the result set to specialize over

ctx - the statement context to specialize over

Returns:

a row mapper equivalent to this one, possibly specialized.

Throws:

SQLException - if anything goes wrong go ahead and let this percolate; Jdbi will handle it

See Also:

for an example of specialization.