NestedBeanPropertyRowMapper (hammer-sqldb 0.5.4 API)

java.lang.Object
- cn.featherfly.hammer.sqldb.jdbc.NestedBeanPropertyRowMapper<T>

类型参数:

T - the result type

所有已实现的接口:

org.springframework.jdbc.core.RowMapper<T>
```
public class NestedBeanPropertyRowMapper<T>
extends java.lang.Object
implements org.springframework.jdbc.core.RowMapper<T>
```
RowMapper 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.
Column values are mapped based on matching the column name as obtained from result set meta-data 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.
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".
For 'null' values read from the database, we will attempt to call the setter, but in the case of Java primitives, this causes a TypeMismatchException. This class can be configured (using the primitivesDefaultedForNullValue property) to trap this exception and use the primitives default value. Be aware that if you use the values from the generated bean to update the database the primitive value will have been set to the primitive's default value instead of null.
Please note that this class is designed to provide convenience rather than high performance. For best performance, consider using a custom RowMapper implementation.

从以下版本开始:

2.5

字段概要

字段
限定符和类型字段和说明

protected org.slf4j.Logger logger
Logger available to subclasses.

字段
限定符和类型	字段和说明
`protected org.slf4j.Logger`	`logger` Logger available to subclasses.

构造器概要

构造器
构造器和说明
`NestedBeanPropertyRowMapper()` Create a new `BeanPropertyRowMapper` for bean-style configuration.
`NestedBeanPropertyRowMapper(java.lang.Class<T> mappedClass)` Create a new `BeanPropertyRowMapper`, accepting unpopulated properties in the target bean.
`NestedBeanPropertyRowMapper(java.lang.Class<T> mappedClass, boolean checkFullyPopulated)` Create a new `BeanPropertyRowMapper`.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`protected java.lang.Object`	`getColumnValue(java.sql.ResultSet rs, int index, java.beans.PropertyDescriptor pd)` Retrieve a JDBC object value for the specified column.
`org.springframework.core.convert.ConversionService`	`getConversionService()` Return a `ConversionService` for binding JDBC values to bean properties, or `null` if none.
`java.lang.Class<T>`	`getMappedClass()` Get the class that we are mapping to.
`protected void`	`initBeanWrapper(org.springframework.beans.BeanWrapper bw)` Initialize the given BeanWrapper to be used for row mapping.
`protected void`	`initialize(java.lang.Class<T> mappedClass)` Initialize the mapping meta-data 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.
`protected java.lang.String`	`lowerCaseName(java.lang.String name)` Convert the given name to lower case.
`T`	`mapRow(java.sql.ResultSet rs, int rowNumber)` Extract the values for all columns in the current row.
`static <T> NestedBeanPropertyRowMapper<T>`	`newInstance(java.lang.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`	`setConversionService(org.springframework.core.convert.ConversionService conversionService)` Set a `ConversionService` for binding JDBC values to bean properties, or `null` for none.
`void`	`setMappedClass(java.lang.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.
`protected java.lang.String`	`underscoreName(java.lang.String name)` Convert a name in camelCase to an underscored name in lower case.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - logger
```
protected final org.slf4j.Logger logger
```
    Logger available to subclasses.
- 构造器详细资料
  - NestedBeanPropertyRowMapper
```
public NestedBeanPropertyRowMapper()
```
    Create a new BeanPropertyRowMapper for bean-style configuration.
    
    另请参阅:
    
    setMappedClass(java.lang.Class<T>), setCheckFullyPopulated(boolean)
  - NestedBeanPropertyRowMapper
```
public NestedBeanPropertyRowMapper(java.lang.Class<T> mappedClass)
```
    Create a new BeanPropertyRowMapper, accepting unpopulated properties in the target bean.
    Consider using the newInstance(java.lang.Class<T>) factory method instead, which allows for specifying the mapped type once only.
    
    参数:
    
    mappedClass - the class that each row should be mapped to
  - NestedBeanPropertyRowMapper
```
public NestedBeanPropertyRowMapper(java.lang.Class<T> mappedClass,
                                   boolean checkFullyPopulated)
```
    Create a new BeanPropertyRowMapper.
    
    参数:
    
    mappedClass - the class that each row should be mapped to
    
    checkFullyPopulated - whether we're strictly validating that all bean properties have been mapped from corresponding database fields
- 方法详细资料
  - setMappedClass
```
public void setMappedClass(java.lang.Class<T> mappedClass)
```
    Set the class that each row should be mapped to.
    
    参数:
    
    mappedClass - the new mapped class
  - getMappedClass
```
@Nullable
public final java.lang.Class<T> getMappedClass()
```
    Get the class that we are mapping to.
    
    返回:
    
    the mapped class
  - setCheckFullyPopulated
```
public void setCheckFullyPopulated(boolean checkFullyPopulated)
```
    Set whether we're strictly validating that all bean properties have been mapped from corresponding database fields.
    Default is false, accepting unpopulated properties in the target bean.
    
    参数:
    
    checkFullyPopulated - the new check fully populated
  - isCheckFullyPopulated
```
public boolean isCheckFullyPopulated()
```
    Return whether we're strictly validating that all bean properties have been mapped from corresponding database fields.
    
    返回:
    
    true, if is check fully populated
  - setPrimitivesDefaultedForNullValue
```
public void setPrimitivesDefaultedForNullValue(boolean primitivesDefaultedForNullValue)
```
    Set whether we're defaulting Java primitives in the case of mapping a null value from corresponding database fields.
    Default is false, throwing an exception when nulls are mapped to Java primitives.
    
    参数:
    
    primitivesDefaultedForNullValue - the new primitives defaulted for null value
  - isPrimitivesDefaultedForNullValue
```
public boolean isPrimitivesDefaultedForNullValue()
```
    Return whether we're defaulting Java primitives in the case of mapping a null value from corresponding database fields.
    
    返回:
    
    true, if is primitives defaulted for null value
  - setConversionService
```
public void setConversionService(@Nullable
                                 org.springframework.core.convert.ConversionService conversionService)
```
    Set a ConversionService for binding JDBC values to bean properties, or null for none.
    Default is a DefaultConversionService, as of Spring 4.3. This provides support for java.time conversion and other special types.
    
    参数:
    
    conversionService - the new conversion service
    
    从以下版本开始:
    
    4.3
    
    另请参阅:
    
    initBeanWrapper(BeanWrapper)
  - getConversionService
```
@Nullable
public org.springframework.core.convert.ConversionService getConversionService()
```
    Return a ConversionService for binding JDBC values to bean properties, or null if none.
    
    返回:
    
    the conversion service
    
    从以下版本开始:
    
    4.3
  - initialize
```
protected void initialize(java.lang.Class<T> mappedClass)
```
    Initialize the mapping meta-data for the given class.
    
    参数:
    
    mappedClass - the mapped class
  - underscoreName
```
protected java.lang.String underscoreName(java.lang.String name)
```
    Convert a name in camelCase to an underscored name in lower case. Any upper case letters are converted to lower case with a preceding underscore.
    
    参数:
    
    name - the original name
    
    返回:
    
    the converted name
    
    从以下版本开始:
    
    4.2
    
    另请参阅:
    
    lowerCaseName(java.lang.String)
  - lowerCaseName
```
protected java.lang.String lowerCaseName(java.lang.String name)
```
    Convert the given name to lower case. By default, conversions will happen within the US locale.
    
    参数:
    
    name - the original name
    
    返回:
    
    the converted name
    
    从以下版本开始:
    
    4.2
  - mapRow
```
public T mapRow(java.sql.ResultSet rs,
                int rowNumber)
         throws java.sql.SQLException
```
    Extract the values for all columns in the current row.
    Utilizes public setters and result set meta-data.
    
    指定者:
    
    mapRow 在接口中 org.springframework.jdbc.core.RowMapper<T>
    
    抛出:
    
    java.sql.SQLException
    
    另请参阅:
    
    ResultSetMetaData
  - initBeanWrapper
```
protected void initBeanWrapper(org.springframework.beans.BeanWrapper bw)
```
    Initialize the given BeanWrapper to be used for row mapping. To be called for each row.
    The default implementation applies the configured ConversionService, if any. Can be overridden in subclasses.
    
    参数:
    
    bw - the BeanWrapper to initialize
    
    另请参阅:
    
    getConversionService(), ConfigurablePropertyAccessor.setConversionService(org.springframework.core.convert.ConversionService)
  - getColumnValue
```
@Nullable
protected java.lang.Object getColumnValue(java.sql.ResultSet rs,
                                                     int index,
                                                     java.beans.PropertyDescriptor pd)
                                              throws java.sql.SQLException
```
    Retrieve a JDBC object value for the specified column.
    The default implementation calls JdbcUtils.getResultSetValue(java.sql.ResultSet, int, Class). Subclasses may override this to check specific value types upfront, or to post-process values return from getResultSetValue.
    
    参数:
    
    rs - is the ResultSet holding the data
    
    index - is the column index
    
    pd - the bean property that each result object is expected to match
    
    返回:
    
    the Object value
    
    抛出:
    
    java.sql.SQLException - in case of extraction failure
    
    另请参阅:
    
    JdbcUtils.getResultSetValue(java.sql.ResultSet, int, Class)
  - newInstance
```
public static <T> NestedBeanPropertyRowMapper<T> newInstance(java.lang.Class<T> mappedClass)
```
    Static factory method to create a new BeanPropertyRowMapper (with the mapped class specified only once).
    
    类型参数:
    
    T - the generic type
    
    参数:
    
    mappedClass - the class that each row should be mapped to
    
    返回:
    
    new instance

类 NestedBeanPropertyRowMapper<T>

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

logger

构造器详细资料

NestedBeanPropertyRowMapper

NestedBeanPropertyRowMapper

NestedBeanPropertyRowMapper

方法详细资料

setMappedClass

getMappedClass

setCheckFullyPopulated

isCheckFullyPopulated

setPrimitivesDefaultedForNullValue

isPrimitivesDefaultedForNullValue

setConversionService

getConversionService

initialize

underscoreName

lowerCaseName

mapRow

initBeanWrapper

getColumnValue

newInstance