クラス BeanPropertyRowMapper<T>

メソッドの詳細

• setMappedClass

  public void setMappedClass(ClassSE<T> mappedClass)

  各行をマップするクラスを設定します。

• getMappedClass

  @Nullable public final ClassSE<T> getMappedClass()

  マッピングするクラスを取得します。

• setCheckFullyPopulated

  public void setCheckFullyPopulated(boolean checkFullyPopulated)

  すべての Bean プロパティが対応するデータベース列からマップされていることを厳密に検証するかどうかを設定します。

  デフォルトは false で、ターゲット Bean の未入力プロパティを受け入れます。

• isCheckFullyPopulated

  public boolean isCheckFullyPopulated()

  すべての Bean プロパティが対応するデータベース列からマップされていることを厳密に検証しているかどうかを返します。

• setPrimitivesDefaultedForNullValue

  public void setPrimitivesDefaultedForNullValue(boolean primitivesDefaultedForNullValue)

  ターゲットクラスの対応するプリミティブプロパティにマッピングするときに、NULL データベース列の値を無視するかどうかを設定します。

  デフォルトは false で、null が Java プリミティブにマップされると例外をスローします。

  このフラグが true に設定されていて、マップされた Bean から ignored プリミティブプロパティ値を使用してデータベースを更新すると、データベース内の値は NULL からそのプリミティブプロパティの現在の値に変更されます。この値は、プロパティの初期値 (それぞれのプリミティブ型に対する Java の既定値の可能性があります) である場合もあれば、既定のコンストラクター (または初期化ブロック) でプロパティに設定された他の値である場合、マップされた Bean 内の他のプロパティを設定することによる副作用である場合もあります。

• isPrimitivesDefaultedForNullValue

  public boolean isPrimitivesDefaultedForNullValue()

  primitivesDefaultedForNullValue フラグの値を取得します。

  関連事項:

  • setPrimitivesDefaultedForNullValue(boolean)

• setConversionService

  public void setConversionService(@Nullable ConversionService conversionService)

  JDBC 値を Bean プロパティにバインドするには ConversionService を設定し、なしの場合は null を設定します。

  デフォルトは、Spring 4.3 以降の DefaultConversionService です。これにより、java.time 変換およびその他の特殊な型がサポートされます。

  導入:

  4.3

  関連事項:

  • initBeanWrapper(BeanWrapper)

• getConversionService

  @Nullable public ConversionService getConversionService()

  JDBC 値を Bean プロパティにバインドするために ConversionService を返し、ない場合は null を返します。

  導入:

  4.3

• initialize

  protected void initialize(ClassSE<T> mappedClass)

  指定されたクラスのマッピングメタデータを初期化します。

  パラメーター:

  mappedClass - マッピングされたクラス

  関連事項:

  • setMappedClass(java.lang.Class<T>)
  • BeanUtils.getPropertyDescriptors(java.lang.Class<?>)
  • mappedNames(PropertyDescriptor)

• suppressProperty

  protected void suppressProperty(StringSE propertyName)

  指定されたプロパティをマップされたプロパティから削除します。

  パラメーター:

  propertyName - プロパティ名 (プロパティ記述子で使用される)

  導入:

  5.3.9

• mappedNames

  protected SetSE<StringSE> mappedNames(PropertyDescriptorSE pd)

  指定されたプロパティのマップされた名前を決定します。

  サブクラスは、このメソッドをオーバーライドして、マップされた名前をカスタマイズしたり、この基本メソッド (小文字およびアンダースコアベースの形式でプロパティ名を返す) によって決定されたセットに追加または削除したり、セットを完全に置き換えたりすることができます。

  パラメーター:

  pd - 初期化時に検出されたプロパティ記述子

  戻り値:

  マップされた名前のセット

  導入:

  6.1.4

  関連事項:

  • initialize(java.lang.Class<T>)
  • lowerCaseName(java.lang.String)
  • underscoreName(java.lang.String)

• lowerCaseName

  protected StringSE lowerCaseName(StringSE name)

  指定された名前を小文字に変換します。

  デフォルトでは、変換は米国ロケール内で行われます。

  パラメーター:

  name - 元の名前

  戻り値:

  変換された名前

  導入:

  4.2

  関連事項:

  • underscoreName(java.lang.String)

• underscoreName

  protected StringSE underscoreName(StringSE name)

  camelCase の名前を小文字のアンダースコア付きの名前に変換します。

  大文字は、前にアンダースコアを付けて小文字に変換されます。

  パラメーター:

  name - 元の名前

  戻り値:

  変換された名前

  導入:

  4.2

  関連事項:

  • JdbcUtils.convertPropertyNameToUnderscoreName(java.lang.String)

• mapRow

  public T mapRow(ResultSetSE rs, int rowNumber) throws SQLExceptionSE

  現在の行のすべての列の値を抽出します。

  パブリック setter と結果セットのメタデータを利用します。

  次で指定:

  インターフェース RowMapper<T> の mapRow 

  パラメーター:

  rs - マップする ResultSet (現在の行に対して事前に初期化済み)

  rowNumber - 現在の行の番号

  戻り値:

  現在の行の結果オブジェクト (null の場合があります)

  例外:

  SQLExceptionSE - 列値の取得中に SQLException が発生した場合 (つまり、SQLException をキャッチする必要はありません。)

  関連事項:

  • ResultSetMetaDataSE

• constructMappedInstance

  protected T constructMappedInstance(ResultSetSE rs, TypeConverter tc) throws SQLExceptionSE

  現在の行のマップされたクラスのインスタンスを作成します。

  パラメーター:

  rs - ResultSet をマップする (現在の行に対して事前に初期化済み)

  tc - この RowMapper の変換サービスを備えた TypeConverter

  戻り値:

  マップされたクラスの対応するインスタンス

  例外:

  SQLExceptionSE - SQLException が発生した場合

  導入:

  5.3

• initBeanWrapper

  protected void initBeanWrapper(BeanWrapper bw)

  行マッピングに使用される特定の BeanWrapper を初期化します。

  行ごとに呼び出されます。

  デフォルトの実装では、構成された ConversionService があれば適用されます。サブクラスでオーバーライドできます。

  パラメーター:

  bw - 初期化する BeanWrapper

  関連事項:

  • getConversionService()
  • ConfigurablePropertyAccessor.setConversionService(org.springframework.core.convert.ConversionService)

• getColumnValue

  @Nullable protected ObjectSE getColumnValue(ResultSetSE rs, int index, PropertyDescriptorSE pd) throws SQLExceptionSE

  指定された列の JDBC オブジェクト値を取得します。

  デフォルトの実装では、指定された PropertyDescriptorSE の型を使用して JdbcUtils.getResultSetValue(java.sql.ResultSet, int, Class) を呼び出します。

  サブクラスはこれをオーバーライドして、特定の値の型を事前にチェックしたり、getResultSetValue から返された値を後処理したりできます。

  パラメーター:

  rs - データを保持している ResultSet

  index - 列インデックスです

  pd - 各結果オブジェクトが一致すると予想される Bean プロパティ

  戻り値:

  オブジェクト値

  例外:

  SQLExceptionSE - 抽出に失敗した場合

  関連事項:

  • getColumnValue(ResultSet, int, Class)

• getColumnValue

  @Nullable protected ObjectSE getColumnValue(ResultSetSE rs, int index, ClassSE<?> paramType) throws SQLExceptionSE

  指定された列の JDBC オブジェクト値を取得します。

  デフォルトの実装は JdbcUtils.getResultSetValue(java.sql.ResultSet, int, Class) を呼び出します。

  サブクラスはこれをオーバーライドして、特定の値の型を事前にチェックしたり、getResultSetValue から返された値を後処理したりできます。

  パラメーター:

  rs - データを保持している ResultSet

  index - 列インデックスです

  paramType - ターゲットパラメーター型

  戻り値:

  オブジェクト値

  例外:

  SQLExceptionSE - 抽出に失敗した場合

  導入:

  5.3

  関連事項:

  • JdbcUtils.getResultSetValue(java.sql.ResultSet, int, Class)

• newInstance

  public static <T> BeanPropertyRowMapper<T> newInstance(ClassSE<T> mappedClass)

  新しい BeanPropertyRowMapper を作成する静的ファクトリメソッド。

  パラメーター:

  mappedClass - 各行がマップされるクラス

  関連事項:

  • newInstance(Class, ConversionService)

• newInstance

  public static <T> BeanPropertyRowMapper<T> newInstance(ClassSE<T> mappedClass, @Nullable ConversionService conversionService)

  新しい BeanPropertyRowMapper を作成する静的ファクトリメソッド。

  パラメーター:

  mappedClass - 各行がマップされるクラス

  conversionService - JDBC 値を Bean プロパティにバインドする場合は ConversionService、ない場合は null 

  導入:

  5.2.3

  関連事項:

  • newInstance(Class)
  • setConversionService(org.springframework.core.convert.ConversionService)