org.apache.commons.dbutils.handlers
Class BeanHandler

java.lang.Object
  org.apache.commons.dbutils.handlers.BeanHandler

All Implemented Interfaces:

ResultSetHandler

public class BeanHandler

extends Object

implements ResultSetHandler

ResultSetHandler implementation that converts the first ResultSet row into a JavaBean. This class is thread safe.

Author:

Juozas Baliuka, David Graham

See Also:

ResultSetHandler

Field Summary

private RowProcessor	convert The RowProcessor implementation to use when converting rows into beans.
private Class	type The Class of beans produced by this handler.

Constructor Summary

BeanHandler(Class type)
Creates a new instance of BeanHandler.

BeanHandler(Class type, RowProcessor convert)
Creates a new instance of BeanHandler.

Method Summary

Object

handle(ResultSet rs) Convert the first row of the ResultSet into a bean with the Class given in the constructor.

Methods inherited from class java.lang.Object

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

Field Detail

type

private Class type

The Class of beans produced by this handler.

convert

private RowProcessor convert

The RowProcessor implementation to use when converting rows into beans.

Constructor Detail

BeanHandler

public BeanHandler(Class type)

Creates a new instance of BeanHandler.

Parameters:

type - The Class that objects returned from handle() are created from.

BeanHandler

public BeanHandler(Class type,
                   RowProcessor convert)

Creates a new instance of BeanHandler.

Parameters:

type - The Class that objects returned from handle() are created from.

convert - The RowProcessor implementation to use when converting rows into beans.

Method Detail

handle

public Object handle(ResultSet rs)
              throws SQLException

Convert the first row of the ResultSet into a bean with the Class given in the constructor.

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 initialized JavaBean or null if there were no rows in the ResultSet.

Throws:

SQLException

See Also:

ResultSetHandler.handle(java.sql.ResultSet)