org.apache.commons.dbutils
Interface RowProcessor

All Known Implementing Classes:

BasicRowProcessor

public interface RowProcessor

RowProcessor implementations convert ResultSet rows into various other objects. Implementations can extend BasicRowProcessor to protect themselves from changes to this interface.

See Also:

BasicRowProcessor

Method Summary

java.lang.Object[]	toArray(java.sql.ResultSet rs) Create an Object[] from the column values in one ResultSet row.
<T> T	toBean(java.sql.ResultSet rs, java.lang.Class<T> type) Create a JavaBean from the column values in one ResultSet row.
<T> java.util.List<T>	toBeanList(java.sql.ResultSet rs, java.lang.Class<T> type) Create a List of JavaBeans from the column values in all ResultSet rows.
java.util.Map<java.lang.String,java.lang.Object>	toMap(java.sql.ResultSet rs) Create a Map from the column values in one ResultSet row.

Method Detail

toArray

java.lang.Object[] toArray(java.sql.ResultSet rs)
                           throws java.sql.SQLException

Create an Object[] from the column values in one ResultSet row. The ResultSet should be positioned on a valid row before passing it to this method. Implementations of this method must not alter the row position of the ResultSet.

Parameters:

rs - ResultSet that supplies the array data

Returns:

the newly created array

Throws:

java.sql.SQLException - if a database access error occurs

toBean

<T> T toBean(java.sql.ResultSet rs,
             java.lang.Class<T> type)
         throws java.sql.SQLException

Create a JavaBean from the column values in one ResultSet row. The ResultSet should be positioned on a valid row before passing it to this method. Implementations of this method must not alter the row position of the ResultSet.

Type Parameters:

T - The type of bean to create

Parameters:

rs - ResultSet that supplies the bean data

type - Class from which to create the bean instance

Returns:

the newly created bean

Throws:

java.sql.SQLException - if a database access error occurs

toBeanList

<T> java.util.List<T> toBeanList(java.sql.ResultSet rs,
                                 java.lang.Class<T> type)
                             throws java.sql.SQLException

Create a List of JavaBeans from the column values in all ResultSet rows. ResultSet.next() should not be called before passing it to this method.

Type Parameters:

T - The type of bean to create

Parameters:

rs - ResultSet that supplies the bean data

type - Class from which to create the bean instance

Returns:

A List of beans with the given type in the order they were returned by the ResultSet.

Throws:

java.sql.SQLException - if a database access error occurs

toMap

java.util.Map<java.lang.String,java.lang.Object> toMap(java.sql.ResultSet rs)
                                                       throws java.sql.SQLException

Create a Map from the column values in one ResultSet row. The ResultSet should be positioned on a valid row before passing it to this method. Implementations of this method must not alter the row position of the ResultSet.

Parameters:

rs - ResultSet that supplies the map data

Returns:

the newly created Map

Throws:

java.sql.SQLException - if a database access error occurs