パッケージ org.springframework.beans

クラス AbstractPropertyAccessor

実装されたすべてのインターフェース:
ConfigurablePropertyAccessorPropertyAccessorPropertyEditorRegistryTypeConverter
既知の直属サブクラス
AbstractNestablePropertyAccessor

public abstract class AbstractPropertyAccessor extends TypeConverterSupport implements ConfigurablePropertyAccessor
PropertyAccessor インターフェースの抽象実装。すべての便利なメソッドの基本実装を提供します。実際のプロパティアクセスの実装はサブクラスに任されています。
導入:
2.0
作成者:
Juergen Hoeller, Stephane Nicoll
関連事項:
  • コンストラクターの詳細

    • AbstractPropertyAccessor

      public AbstractPropertyAccessor()
  • メソッドの詳細

    • setExtractOldValueForEditor

      public void setExtractOldValueForEditor(boolean extractOldValueForEditor)
      インターフェースからコピーされた説明: ConfigurablePropertyAccessor
      プロパティエディターをプロパティの新しい値に適用するときに、古いプロパティ値を抽出するかどうかを設定します。
      次で指定:
      インターフェース ConfigurablePropertyAccessorsetExtractOldValueForEditor 
    • isExtractOldValueForEditor

      public boolean isExtractOldValueForEditor()
      インターフェースからコピーされた説明: ConfigurablePropertyAccessor
      プロパティエディターをプロパティの新しい値に適用するときに、古いプロパティ値を抽出するかどうかを返します。
      次で指定:
      インターフェース ConfigurablePropertyAccessorisExtractOldValueForEditor 
    • setAutoGrowNestedPaths

      public void setAutoGrowNestedPaths(boolean autoGrowNestedPaths)
      インターフェースからコピーされた説明: ConfigurablePropertyAccessor
      このインスタンスが null 値を含むネストされたパスを「自動拡張」するかどうかを設定します。

      true の場合、null パスの場所にデフォルトのオブジェクト値が入力され、結果として NullValueInNestedPathException になる代わりに走査されます。

      デフォルトは、プレーンな PropertyAccessor インスタンスの false です。

      次で指定:
      インターフェース ConfigurablePropertyAccessorsetAutoGrowNestedPaths 
    • isAutoGrowNestedPaths

      public boolean isAutoGrowNestedPaths()
      インターフェースからコピーされた説明: ConfigurablePropertyAccessor
      ネストされたパスの「自動拡張」がアクティブになっているかどうかを返します。
      次で指定:
      インターフェース ConfigurablePropertyAccessorisAutoGrowNestedPaths 
    • setPropertyValue

      public void setPropertyValue(PropertyValue pv) throws BeansException
      インターフェースからコピーされた説明: PropertyAccessor
      指定した値を現在のプロパティ値として設定します。
      次で指定:
      インターフェース PropertyAccessorsetPropertyValue 
      パラメーター:
      pv - 新しいプロパティ値を含むオブジェクト
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyAccessException - プロパティは有効であるが、アクセサーメソッドが失敗したか、型の不一致が発生した場合
      BeansException
    • setPropertyValues

      public void setPropertyValues(MapSE<?,?> map) throws BeansException
      インターフェースからコピーされた説明: PropertyAccessor
      マップからバッチ更新を実行します。

      PropertyValues からの一括更新はより強力です: この方法は便宜上提供されています。動作は PropertyAccessor.setPropertyValues(PropertyValues) メソッドの動作と同じになります。

      次で指定:
      インターフェース PropertyAccessorsetPropertyValues 
      パラメーター:
      map - プロパティを取得するマップ。プロパティ名をキーとするプロパティ値オブジェクトを含みます
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyBatchUpdateException - バッチ更新中に特定のプロパティに対して 1 つ以上の PropertyAccessExceptions が発生した場合。この例外には、個々の PropertyAccessExceptions がすべてバンドルされています。他のすべてのプロパティは正常に更新されます。
      BeansException
    • setPropertyValues

      public void setPropertyValues(PropertyValues pvs) throws BeansException
      インターフェースからコピーされた説明: PropertyAccessor
      バッチ更新を実行するための推奨される方法。

      バッチ更新の実行は、単一の更新の実行とは異なります。このクラスの実装は、 回復可能なエラー(型の不一致など、無効なフィールド名ではないなど)が発生した場合にプロパティを更新し続けます。個々のエラーをすべて含む PropertyBatchUpdateException この例外を後で調べて、すべてのバインディングエラーを確認できます。正常に更新されたプロパティは変更されたままです。

      不明なフィールドや無効なフィールドは許可されません。

      次で指定:
      インターフェース PropertyAccessorsetPropertyValues 
      パラメーター:
      pvs - ターゲットオブジェクトに設定する PropertyValues
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyBatchUpdateException - バッチ更新中に特定のプロパティに対して 1 つ以上の PropertyAccessExceptions が発生した場合。この例外には、個々の PropertyAccessExceptions がすべてバンドルされています。他のすべてのプロパティは正常に更新されます。
      BeansException
      関連事項:
    • setPropertyValues

      public void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown) throws BeansException
      インターフェースからコピーされた説明: PropertyAccessor
      動作をより詳細に制御してバッチ更新を実行します。

      バッチ更新の実行は、単一の更新の実行とは異なります。このクラスの実装は、 回復可能なエラー(型の不一致など、無効なフィールド名ではないなど)が発生した場合にプロパティを更新し続けます。個々のエラーをすべて含む PropertyBatchUpdateException この例外を後で調べて、すべてのバインディングエラーを確認できます。正常に更新されたプロパティは変更されたままです。

      次で指定:
      インターフェース PropertyAccessorsetPropertyValues 
      パラメーター:
      pvs - ターゲットオブジェクトに設定する PropertyValues
      ignoreUnknown - 未知のプロパティを無視するべきか (Bean にはありません)
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyBatchUpdateException - バッチ更新中に特定のプロパティに対して 1 つ以上の PropertyAccessExceptions が発生した場合。この例外には、個々の PropertyAccessExceptions がすべてバンドルされています。他のすべてのプロパティは正常に更新されます。
      BeansException
      関連事項:
    • setPropertyValues

      public void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown, boolean ignoreInvalid) throws BeansException
      インターフェースからコピーされた説明: PropertyAccessor
      動作を完全に制御してバッチ更新を実行します。

      バッチ更新の実行は、単一の更新の実行とは異なります。このクラスの実装は、 回復可能なエラー(型の不一致など、無効なフィールド名ではないなど)が発生した場合にプロパティを更新し続けます。個々のエラーをすべて含む PropertyBatchUpdateException この例外を後で調べて、すべてのバインディングエラーを確認できます。正常に更新されたプロパティは変更されたままです。

      次で指定:
      インターフェース PropertyAccessorsetPropertyValues 
      パラメーター:
      pvs - ターゲットオブジェクトに設定する PropertyValues
      ignoreUnknown - 未知のプロパティを無視するべきか (Bean にはありません)
      ignoreInvalid - 無効なプロパティを無視する必要があります (見つかりましたがアクセスできません)
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyBatchUpdateException - バッチ更新中に特定のプロパティに対して 1 つ以上の PropertyAccessExceptions が発生した場合。この例外には、個々の PropertyAccessExceptions がすべてバンドルされています。他のすべてのプロパティは正常に更新されます。
      BeansException
    • getPropertyType

      @Nullable public ClassSE<?> getPropertyType(StringSE propertyPath)
      クラスからコピーされた説明: PropertyEditorRegistrySupport
      指定されたプロパティパスのプロパティ型を決定します。

      必須の型が指定されていない場合に PropertyEditorRegistrySupport.findCustomEditor(java.lang.Class<?>, java.lang.String) によって呼び出され、プロパティパスを指定しただけでも型固有のエディターを検索できるようにします。

      デフォルトの実装は、常に null を返します。BeanWrapperImpl は、BeanWrapper インターフェースで定義されている標準の getPropertyType メソッドでこれをオーバーライドします。

      次で指定:
      インターフェース PropertyAccessorgetPropertyType 
      オーバーライド:
      クラス PropertyEditorRegistrySupportgetPropertyType 
      パラメーター:
      propertyPath - 型を決定するプロパティパス
      戻り値:
      プロパティの型、または判別できない場合は null 
      関連事項:
    • getPropertyValue

      @Nullable public abstract ObjectSE getPropertyValue(StringSE propertyName) throws BeansException
      実際にプロパティの値を取得します。
      次で指定:
      インターフェース PropertyAccessorgetPropertyValue 
      パラメーター:
      propertyName - 値を取得するプロパティの名前
      戻り値:
      プロパティの値
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが読めない場合
      PropertyAccessException - プロパティは有効だったが、アクセサーメソッドが失敗した場合
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが読めない場合
      PropertyAccessException - プロパティは有効だったが、アクセサーメソッドが失敗した場合
      BeansException
    • setPropertyValue

      public abstract void setPropertyValue(StringSE propertyName, @Nullable ObjectSE value) throws BeansException
      実際にプロパティ値を設定します。
      次で指定:
      インターフェース PropertyAccessorsetPropertyValue 
      パラメーター:
      propertyName - 値を設定するプロパティの名前
      value - 新しい価値
      例外:
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyAccessException - プロパティは有効であるが、アクセサーメソッドが失敗したか、型の不一致が発生した場合
      InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
      PropertyAccessException - プロパティは有効であるが、アクセサーメソッドが失敗したか、型の不一致が発生した場合
      BeansException