ParameterizedBeanPropertyRowMapper

Class Overview

ParameterizedRowMapper implementation that converts a row into a new instance of the specified mapped target class. The mapped target class must be a top-level class and it must have a default or no-arg constructor.

Uses Java 5 covariant return types to override the return type of the mapRow(ResultSet, int) method to be the type parameter T.

Column values are mapped based on matching the column name as obtained from result set metadata to public setters for the corresponding properties. The names are matched either directly or by transforming a name separating the parts with underscores to the same name using "camel" case.

Mapping is provided for fields in the target class for many common types, e.g.: String, boolean, Boolean, byte, Byte, short, Short, int, Integer, long, Long, float, Float, double, Double, BigDecimal, java.util.Date, etc.

The mapper can be configured to use the primitives default value when mapping null values by setting the 'primitivesDefaultedForNullValue' flag to 'true'.

To facilitate mapping between columns and fields that don't have matching names, try using column aliases in the SQL statement like "select fname as first_name from customer".

Please note that this class is designed to provide convenience rather than high performance. For best performance consider using a custom RowMapper.

Summary

[Expand] Inherited Fields
From class org.springframework.jdbc.core.BeanPropertyRowMapper protected final Log logger Logger available to subclasses

[Expand] Inherited Methods
From class org.springframework.jdbc.core.BeanPropertyRowMapper Object getColumnValue(ResultSet rs, int index, PropertyDescriptor pd) Retrieve a JDBC object value for the specified column. final Class<T> getMappedClass() Get the class that we are mapping to. void initBeanWrapper(BeanWrapper bw) Initialize the given BeanWrapper to be used for row mapping. void initialize(Class<T> mappedClass) Initialize the mapping metadata for the given class. boolean isCheckFullyPopulated() Return whether we're strictly validating that all bean properties have been mapped from corresponding database fields. boolean isPrimitivesDefaultedForNullValue() Return whether we're defaulting Java primitives in the case of mapping a null value from corresponding database fields. T mapRow(ResultSet rs, int rowNumber) Extract the values for all columns in the current row. static <T> BeanPropertyRowMapper<T> newInstance(Class<T> mappedClass) Static factory method to create a new BeanPropertyRowMapper (with the mapped class specified only once). void setCheckFullyPopulated(boolean checkFullyPopulated) Set whether we're strictly validating that all bean properties have been mapped from corresponding database fields. void setMappedClass(Class<T> mappedClass) Set the class that each row should be mapped to. void setPrimitivesDefaultedForNullValue(boolean primitivesDefaultedForNullValue) Set whether we're defaulting Java primitives in the case of mapping a null value from corresponding database fields.
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
From interface org.springframework.jdbc.core.RowMapper abstract T mapRow(ResultSet rs, int rowNum) Implementations must implement this method to map each row of data in the ResultSet.