org.apache.commons.dbutils.handlers
Class ArrayListHandler

java.lang.Object
  org.apache.commons.dbutils.handlers.GenericListHandler
      org.apache.commons.dbutils.handlers.ArrayListHandler

All Implemented Interfaces:

ResultSetHandler

public class ArrayListHandler

extends org.apache.commons.dbutils.handlers.GenericListHandler

ResultSetHandler implementation that converts the ResultSet into a List of Object[]s. This class is thread safe.

See Also:

ResultSetHandler

Constructor Summary

ArrayListHandler()
Creates a new instance of ArrayListHandler using a BasicRowProcessor for conversions.

ArrayListHandler(RowProcessor convert)
Creates a new instance of ArrayListHandler.

Method Summary

java.lang.Object	handle(java.sql.ResultSet rs) Whole ResultSet handler.
protected java.lang.Object	handleRow(java.sql.ResultSet rs) Convert row's columns into an Object[].

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArrayListHandler

public ArrayListHandler()

Creates a new instance of ArrayListHandler using a BasicRowProcessor for conversions.

ArrayListHandler

public ArrayListHandler(RowProcessor convert)

Creates a new instance of ArrayListHandler.

Parameters:

convert - The RowProcessor implementation to use when converting rows into Object[]s.

Method Detail

handleRow

protected java.lang.Object handleRow(java.sql.ResultSet rs)
                              throws java.sql.SQLException

Convert row's columns into an Object[].

Parameters:

rs - ResultSet to process.

Returns:

Object[], never null.

Throws:

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

See Also:

GenericListHandler.handle(ResultSet)

handle

public java.lang.Object handle(java.sql.ResultSet rs)
                        throws java.sql.SQLException

Whole ResultSet handler. It produce List as result. To convert individual rows into Java objects it uses handleRow(ResultSet) method.

Specified by:

handle in interface ResultSetHandler

Parameters:

rs - The ResultSet to handle. It has not been touched before being passed to this method.

Returns:

An Object initialized with ResultSet data. It is legal for implementations to return null if the ResultSet contained 0 rows.

Throws:

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

See Also:

GenericListHandler.handleRow(ResultSet)