程序包 org.springframework.jdbc.core

类 BeanPropertyRowMapper<T>

  • 所有已实现的接口:
    RowMapper<T>
    public class BeanPropertyRowMapper<T>
extends Object
implements 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
    作者:
    Thomas Risberg, Juergen Hoeller

    • 字段详细资料

      • logger

        protected final Log logger
        Logger available to subclasses

    • 构造器详细资料

      • BeanPropertyRowMapper

        public BeanPropertyRowMapper​(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

      • BeanPropertyRowMapper

        public BeanPropertyRowMapper​(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​(Class<T> mappedClass)
        Set the class that each row should be mapped to.

      • 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.

      • isCheckFullyPopulated

        public boolean isCheckFullyPopulated()
        Return whether we're strictly validating that all bean properties have been mapped from corresponding database fields.

      • 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.

      • isPrimitivesDefaultedForNullValue

        public boolean isPrimitivesDefaultedForNullValue()
        Return whether we're defaulting Java primitives in the case of mapping a null value from corresponding database fields.

      • initialize

        protected void initialize​(Class<T> mappedClass)
        Initialize the mapping meta-data for the given class.
        参数:
        mappedClass - the mapped class

      • underscoreName

        protected String underscoreName​(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 String lowerCaseName​(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​(ResultSet rs,
                int rowNumber)
         throws SQLException
        Extract the values for all columns in the current row.

        Utilizes public setters and result set meta-data.

        指定者:
        mapRow 在接口中 RowMapper<T>
        参数:
        rs - the ResultSet to map (pre-initialized for the current row)
        rowNumber - the number of the current row
        返回:
        the result object for the current row (may be null)
        抛出:
        SQLException - if a SQLException is encountered getting column values (that is, there's no need to catch SQLException)
        另请参阅:
        ResultSetMetaData

      • newInstance

        public static <T> BeanPropertyRowMapper<T> newInstance​(Class<T> mappedClass)
        Static factory method to create a new BeanPropertyRowMapper (with the mapped class specified only once).
        参数:
        mappedClass - the class that each row should be mapped to