Package org.springframework.jdbc.core
Interface RowCallbackHandler
- All Known Implementing Classes:
RowCountCallbackHandler
public interface RowCallbackHandler
An interface used byJdbcTemplate
for processing rows of aResultSet
on a per-row basis. Implementations of this interface perform the actual work of processing each row but don't need to worry about exception handling.SQLExceptions
will be caught and handled by the calling JdbcTemplate.In contrast to a
ResultSetExtractor
, a RowCallbackHandler object is typically stateful: It keeps the result state within the object, to be available for later inspection. SeeRowCountCallbackHandler
for a usage example.Consider using a
RowMapper
instead if you need to map exactly one result object per row, assembling them into a List.- Author:
- Rod Johnson, Juergen Hoeller
- See Also:
JdbcTemplate
,RowMapper
,ResultSetExtractor
,RowCountCallbackHandler
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
processRow(ResultSet rs)
Implementations must implement this method to process each row of data in the ResultSet.
Method Detail
processRow
void processRow(ResultSet rs) throws SQLException
Implementations must implement this method to process each row of data in the ResultSet. This method should not callnext()
on the ResultSet; it is only supposed to extract values of the current row.Exactly what the implementation chooses to do is up to it: A trivial implementation might simply count rows, while another implementation might build an XML document.
- Parameters:
rs
- the ResultSet to process (pre-initialized for the current row)- Throws:
SQLException
- if a SQLException is encountered getting column values (that is, there's no need to catch SQLException)