com.haulmont.bali.db

Class BeanProcessor

java.lang.Object

com.haulmont.bali.db.BeanProcessor

@ThreadSafe
public class BeanProcessor
extends java.lang.Object

BeanProcessor matches column names to bean property names and converts ResultSet columns into objects for those bean properties. Subclasses should override the methods in the processing chain to customize behavior.

This class is thread-safe.

Since:

DbUtils 1.1

See Also:

BasicRowProcessor

Constructor Summary

Constructors

Constructor and Description
BeanProcessor() Constructor for BeanProcessor.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	toBean(java.sql.ResultSet rs, java.lang.Class type) Convert a ResultSet row into a JavaBean.
java.util.List	toBeanList(java.sql.ResultSet rs, java.lang.Class type) Convert a ResultSet into a List of JavaBeans.

Methods inherited from class java.lang.Object

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

Constructor Detail

BeanProcessor

public BeanProcessor()

Constructor for BeanProcessor.

Method Detail

toBean

public java.lang.Object toBean(java.sql.ResultSet rs,
                               java.lang.Class type)
                        throws java.sql.SQLException

Convert a ResultSet row into a JavaBean. This implementation uses reflection and BeanInfo classes to match column names to bean property names. Properties are matched to columns based on several factors:

1. The class has a writable property with the same name as a column. The name comparison is case insensitive.
2. The column type can be converted to the property's set method parameter type with a ResultSet.get* method. If the conversion fails (ie. the property was an int and the column was a Timestamp) an SQLException is thrown.

Primitive bean properties are set to their defaults when SQL NULL is returned from the ResultSet. Numeric fields are set to 0 and booleans are set to false. Object bean properties are set to null when SQL NULL is returned. This is the same behavior as the ResultSet get* methods.

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

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

Convert a ResultSet into a List of JavaBeans. This implementation uses reflection and BeanInfo classes to match column names to bean property names. Properties are matched to columns based on several factors:

1. The class has a writable property with the same name as a column. The name comparison is case insensitive.
2. The column type can be converted to the property's set method parameter type with a ResultSet.get* method. If the conversion fails (ie. the property was an int and the column was a Timestamp) an SQLException is thrown.

Primitive bean properties are set to their defaults when SQL NULL is returned from the ResultSet. Numeric fields are set to 0 and booleans are set to false. Object bean properties are set to null when SQL NULL is returned. This is the same behavior as the ResultSet get* methods.

Parameters:

rs - ResultSet that supplies the bean data

type - Class from which to create the bean instance

Returns:

the newly created List of beans

Throws:

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