Top Description Methods
org.springframework.jdbc.core

public Interface RowMapper<T>

Known Direct Implementers
org.springframework.jdbc.core.SimplePropertyRowMapper, org.springframework.jdbc.core.SingleColumnRowMapper, org.springframework.jdbc.object.MappingSqlQueryWithParameters.RowMapperImpl, org.springframework.jdbc.object.UpdatableSqlQuery.RowMapperImpl, org.springframework.jdbc.core.BeanPropertyRowMapper, org.springframework.jdbc.core.ColumnMapRowMapper
Annotations
@FunctionalInterface
Type Parameters
<T>
the result type
Imports
java.sql.ResultSet, .SQLException, org.springframework.lang.Nullable

An interface used by JdbcTemplate for mapping rows of a java.sql.ResultSet on a per-row basis. Implementations of this interface perform the actual work of mapping each row to a result object but don't need to worry about exception handling. SQLExceptions will be caught and handled by the calling JdbcTemplate.

Typically used either for JdbcTemplate's query methods or for out parameters of stored procedures. RowMapper objects are typically stateless and thus reusable; they are an ideal choice for implementing row-mapping logic in a single place.

Alternatively, consider subclassing org.springframework.jdbc.object.MappingSqlQuery from the jdbc.object package: instead of working with separate JdbcTemplate and RowMapper objects, you can build executable query objects (containing row-mapping logic) in that style.

Authors
Thomas Risberg, Juergen Hoeller
See Also
JdbcTemplate, RowCallbackHandler, ResultSetExtractor, org.springframework.jdbc.object.MappingSqlQuery

Method Summary

Modifier and TypeMethod and Description
public T

Returns:

the result object for the current row (may be null)
mapRow
(ResultSet
the ResultSet to map (pre-initialized for the current row)
rs
,
int
the number of the current row
rowNum
)

Implementations must implement this method to map each row of data in the ResultSet.

Method Detail

mapRowback to summary
public T mapRow(ResultSet rs, int rowNum) throws SQLException

Implementations must implement this method to map each row of data in the ResultSet. This method should not call next() on the ResultSet; it is only supposed to map values of the current row.

Parameters
rs:ResultSet

the ResultSet to map (pre-initialized for the current row)

rowNum:int

the number of the current row

Returns:T

the result object for the current row (may be null)

Annotations
@Nullable
Exceptions
SQLException:
if an SQLException is encountered while getting column values (that is, there's no need to catch SQLException)