AbstractNestablePropertyAccessor (Spring Framework 5.1.1.RELEASE API)

java.lang.Object
- org.springframework.beans.PropertyEditorRegistrySupport
- - org.springframework.beans.TypeConverterSupport
  - - org.springframework.beans.AbstractPropertyAccessor
    - - org.springframework.beans.AbstractNestablePropertyAccessor

実装済みのインターフェース一覧:
ConfigurablePropertyAccessor, PropertyAccessor, PropertyEditorRegistry, TypeConverter
既知の直属サブクラス
BeanWrapperImpl, DirectFieldAccessor
```
public abstract class AbstractNestablePropertyAccessor
extends AbstractPropertyAccessor
```
すべての典型的な使用例に必要なインフラストラクチャを提供する基本的な ConfigurablePropertyAccessor。
このアクセサーは、必要に応じて、コレクションと配列の値を対応するターゲットコレクションまたは配列に変換します。コレクションまたは配列を処理するカスタムプロパティエディターは、配列自体が割り当て可能でない場合、String 配列がこのような形式に変換されるため、PropertyEditor の setValue を介して、または setAsText を介してコンマ区切りの String に対して記述できます。
導入:
4.2
作成者:
Juergen Hoeller, Stephane Nicoll, Rod Johnson, Rob Harrop
関連事項:
PropertyEditorRegistrySupport.registerCustomEditor(java.lang.Class<?>, java.beans.PropertyEditor), AbstractPropertyAccessor.setPropertyValues(java.util.Map<?, ?>), setPropertyValue(java.lang.String, java.lang.Object), getPropertyValue(java.lang.String), getPropertyType(java.lang.String), BeanWrapper, PropertyEditorRegistrySupport

ネストされたクラスの概要

ネストされたクラス
修飾子と型	クラスと説明
`protected static class`	`AbstractNestablePropertyAccessor.PropertyHandler` 特定のプロパティのハンドラー。
`protected static class`	`AbstractNestablePropertyAccessor.PropertyTokenHolder` プロパティトークンの格納に使用されるホルダークラス。

フィールド概要
- インターフェース org.springframework.beans.PropertyAccessor から継承されたフィールド
  NESTED_PROPERTY_SEPARATOR, NESTED_PROPERTY_SEPARATOR_CHAR, PROPERTY_KEY_PREFIX, PROPERTY_KEY_PREFIX_CHAR, PROPERTY_KEY_SUFFIX, PROPERTY_KEY_SUFFIX_CHAR

コンストラクター概要

コンストラクター
修飾子	コンストラクターと説明
`protected`	`AbstractNestablePropertyAccessor()` 新しい空のアクセサーを作成します。
`protected`	`AbstractNestablePropertyAccessor(boolean registerDefaultEditors)` 新しい空のアクセサーを作成します。
`protected`	`AbstractNestablePropertyAccessor(java.lang.Class<?> clazz)` 指定したクラスの新しいインスタンスをラップして、新しいアクセサーを作成します。
`protected`	`AbstractNestablePropertyAccessor(java.lang.Object object)` 指定されたオブジェクトの新しいアクセサーを作成します。
`protected`	`AbstractNestablePropertyAccessor(java.lang.Object object, java.lang.String nestedPath, AbstractNestablePropertyAccessor parent)` 指定されたオブジェクトの新しいアクセサーを作成し、オブジェクトが含まれているネストされたパスを登録します。
`protected`	`AbstractNestablePropertyAccessor(java.lang.Object object, java.lang.String nestedPath, java.lang.Object rootObject)` 指定されたオブジェクトの新しいアクセサーを作成し、オブジェクトが含まれているネストされたパスを登録します。

方法の概要

すべてのメソッドインスタンスメソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`protected java.lang.Object`	`convertForProperty(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue, TypeDescriptor td)`
`protected abstract NotWritablePropertyException`	`createNotWritablePropertyException(java.lang.String propertyName)` 指定されたプロパティの `NotWritablePropertyException` を作成します。
`int`	`getAutoGrowCollectionLimit()` 配列およびコレクションの自動拡張の制限を返します。
`protected java.lang.String`	`getFinalPath(AbstractNestablePropertyAccessor pa, java.lang.String nestedPath)` パスの最後のコンポーネントを取得します。
`protected abstract AbstractNestablePropertyAccessor.PropertyHandler`	`getLocalPropertyHandler(java.lang.String propertyName)` 指定されたローカル `propertyName` の `AbstractNestablePropertyAccessor.PropertyHandler` を返します。
`java.lang.String`	`getNestedPath()` このアクセサーによってラップされたオブジェクトのネストされたパスを返します。
`protected AbstractNestablePropertyAccessor`	`getPropertyAccessorForPropertyPath(java.lang.String propertyPath)` 再帰的にナビゲートして、ネストされたプロパティパスのプロパティアクセサーを返します。
`protected AbstractNestablePropertyAccessor.PropertyHandler`	`getPropertyHandler(java.lang.String propertyName)` 指定された `propertyName` の `AbstractNestablePropertyAccessor.PropertyHandler` を返し、必要に応じてナビゲートします。
`java.lang.Class<?>`	`getPropertyType(java.lang.String propertyName)` 指定されたプロパティパスのプロパティ型を決定します。
`TypeDescriptor`	`getPropertyTypeDescriptor(java.lang.String propertyName)` 指定されたプロパティの型記述子を返します。できれば読み取りメソッドから、書き込みメソッドにフォールバックしてください。
`protected java.lang.Object`	`getPropertyValue(AbstractNestablePropertyAccessor.PropertyTokenHolder tokens)`
`java.lang.Object`	`getPropertyValue(java.lang.String propertyName)` 実際にプロパティの値を取得します。
`java.lang.Class<?>`	`getRootClass()` このアクセサーのパスの先頭にあるルートオブジェクトのクラスを返します。
`java.lang.Object`	`getRootInstance()` このアクセサーのパスの先頭にあるルートオブジェクトを返します。
`java.lang.Class<?>`	`getWrappedClass()`
`java.lang.Object`	`getWrappedInstance()`
`boolean`	`isReadableProperty(java.lang.String propertyName)` 指定したプロパティが読み取り可能かどうかを判断します。
`boolean`	`isWritableProperty(java.lang.String propertyName)` 指定されたプロパティが書き込み可能かどうかを判断します。
`protected abstract AbstractNestablePropertyAccessor`	`newNestedPropertyAccessor(java.lang.Object object, java.lang.String nestedPath)` 新しいネストされたプロパティアクセサーインスタンスを作成します。
`void`	`setAutoGrowCollectionLimit(int autoGrowCollectionLimit)` 配列およびコレクションの自動拡張の制限を指定します。
`protected void`	`setPropertyValue(AbstractNestablePropertyAccessor.PropertyTokenHolder tokens, PropertyValue pv)`
`void`	`setPropertyValue(PropertyValue pv)` 指定した値を現在のプロパティ値として設定します。
`void`	`setPropertyValue(java.lang.String propertyName, java.lang.Object value)` 実際にプロパティ値を設定します。
`void`	`setWrappedInstance(java.lang.Object object)` 新しいオブジェクトのクラスが置き換えられたオブジェクトのクラスと異なる場合にのみ、ターゲットオブジェクトを切り替えて、キャッシュされたイントロスペクションの結果を置き換えます。
`void`	`setWrappedInstance(java.lang.Object object, java.lang.String nestedPath, java.lang.Object rootObject)` 新しいオブジェクトのクラスが置き換えられたオブジェクトのクラスと異なる場合にのみ、ターゲットオブジェクトを切り替えて、キャッシュされたイントロスペクションの結果を置き換えます。
`java.lang.String`	`toString()`

クラス org.springframework.beans.AbstractPropertyAccessor から継承されたメソッド
isAutoGrowNestedPaths, isExtractOldValueForEditor, setAutoGrowNestedPaths, setExtractOldValueForEditor, setPropertyValues, setPropertyValues, setPropertyValues, setPropertyValues

クラス org.springframework.beans.TypeConverterSupport から継承されたメソッド
convertIfNecessary, convertIfNecessary, convertIfNecessary

クラス org.springframework.beans.PropertyEditorRegistrySupport から継承されたメソッド
copyCustomEditorsTo, copyDefaultEditorsTo, findCustomEditor, getConversionService, getDefaultEditor, guessPropertyTypeFromEditors, hasCustomEditorForElement, overrideDefaultEditor, registerCustomEditor, registerCustomEditor, registerDefaultEditors, setConversionService, useConfigValueEditors

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インターフェース org.springframework.beans.ConfigurablePropertyAccessor から継承されたメソッド
getConversionService, setConversionService

インターフェース org.springframework.beans.PropertyEditorRegistry から継承されたメソッド
findCustomEditor, registerCustomEditor, registerCustomEditor

インターフェース org.springframework.beans.TypeConverter から継承されたメソッド
convertIfNecessary, convertIfNecessary, convertIfNecessary

- コンストラクターの詳細
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor()
```
    新しい空のアクセサーを作成します。ラップされたインスタンスは後で設定する必要があります。デフォルトのエディターを登録します。
    関連事項:
    setWrappedInstance(java.lang.Object)
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor(boolean registerDefaultEditors)
```
    新しい空のアクセサーを作成します。ラップされたインスタンスは後で設定する必要があります。
    パラメーター:
    registerDefaultEditors - デフォルトのエディターを登録するかどうか (アクセサーが型変換を必要としない場合は抑制できます)
    関連事項:
    setWrappedInstance(java.lang.Object)
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor(java.lang.Object object)
```
    指定されたオブジェクトの新しいアクセサーを作成します。
    パラメーター:
    object - このアクセサーによってラップされたオブジェクト
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor(java.lang.Class<?> clazz)
```
    指定したクラスの新しいインスタンスをラップして、新しいアクセサーを作成します。
    パラメーター:
    clazz - インスタンス化してラップするクラス
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor(java.lang.Object object,
                                           java.lang.String nestedPath,
                                           java.lang.Object rootObject)
```
    指定されたオブジェクトの新しいアクセサーを作成し、オブジェクトが含まれているネストされたパスを登録します。
    パラメーター:
    object - このアクセサーによってラップされたオブジェクト
    nestedPath - オブジェクトのネストされたパス
    rootObject - パスの上部にあるルートオブジェクト
  - AbstractNestablePropertyAccessor
```
protected AbstractNestablePropertyAccessor(java.lang.Object object,
                                           java.lang.String nestedPath,
                                           AbstractNestablePropertyAccessor parent)
```
    指定されたオブジェクトの新しいアクセサーを作成し、オブジェクトが含まれているネストされたパスを登録します。
    パラメーター:
    object - このアクセサーによってラップされたオブジェクト
    nestedPath - オブジェクトのネストされたパス
    parent - 含まれるアクセサー (null であってはなりません)
- メソッドの詳細
  - setAutoGrowCollectionLimit
```
public void setAutoGrowCollectionLimit(int autoGrowCollectionLimit)
```
    配列およびコレクションの自動拡張の制限を指定します。
    プレーンアクセサーのデフォルトは無制限です。
  - getAutoGrowCollectionLimit
```
public int getAutoGrowCollectionLimit()
```
    配列およびコレクションの自動拡張の制限を返します。
  - setWrappedInstance
```
public void setWrappedInstance(java.lang.Object object)
```
    新しいオブジェクトのクラスが置き換えられたオブジェクトのクラスと異なる場合にのみ、ターゲットオブジェクトを切り替えて、キャッシュされたイントロスペクションの結果を置き換えます。
    パラメーター:
    object - 新しいターゲットオブジェクト
  - setWrappedInstance
```
public void setWrappedInstance(java.lang.Object object,
                               @Nullable
                               java.lang.String nestedPath,
                               @Nullable
                               java.lang.Object rootObject)
```
    新しいオブジェクトのクラスが置き換えられたオブジェクトのクラスと異なる場合にのみ、ターゲットオブジェクトを切り替えて、キャッシュされたイントロスペクションの結果を置き換えます。
    パラメーター:
    object - 新しいターゲットオブジェクト
    nestedPath - オブジェクトのネストされたパス
    rootObject - パスの上部にあるルートオブジェクト
  - getWrappedInstance
```
public final java.lang.Object getWrappedInstance()
```
  - getWrappedClass
```
public final java.lang.Class<?> getWrappedClass()
```
  - getNestedPath
```
public final java.lang.String getNestedPath()
```
    このアクセサーによってラップされたオブジェクトのネストされたパスを返します。
  - getRootInstance
```
public final java.lang.Object getRootInstance()
```
    このアクセサーのパスの先頭にあるルートオブジェクトを返します。
    関連事項:
    getNestedPath()
  - getRootClass
```
public final java.lang.Class<?> getRootClass()
```
    このアクセサーのパスの先頭にあるルートオブジェクトのクラスを返します。
    関連事項:
    getNestedPath()
  - setPropertyValue
```
public void setPropertyValue(java.lang.String propertyName,
                             @Nullable
                             java.lang.Object value)
                      throws BeansException
```
    クラスからコピーされた説明: AbstractPropertyAccessor
    実際にプロパティ値を設定します。
    次で指定:
    インターフェース PropertyAccessor 内の setPropertyValue
    次で指定:
    クラス AbstractPropertyAccessor の setPropertyValue
    パラメーター:
    propertyName - 値を設定するプロパティの名前
    value - 新しい価値
    例外:
    InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
    PropertyAccessException - プロパティは有効であるが、アクセサーメソッドが失敗したか、型の不一致が発生した場合
    BeansException
  - setPropertyValue
```
public void setPropertyValue(PropertyValue pv)
                      throws BeansException
```
    インターフェースからコピーされた説明: PropertyAccessor
    指定した値を現在のプロパティ値として設定します。
    次で指定:
    インターフェース PropertyAccessor 内の setPropertyValue
    オーバーライド:
    クラス AbstractPropertyAccessor の setPropertyValue
    パラメーター:
    pv - 新しいプロパティ値を含むオブジェクト
    例外:
    InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが書き込み可能でない場合
    PropertyAccessException - プロパティは有効であるが、アクセサーメソッドが失敗したか、型の不一致が発生した場合
    BeansException
  - setPropertyValue
```
protected void setPropertyValue(AbstractNestablePropertyAccessor.PropertyTokenHolder tokens,
                                PropertyValue pv)
                         throws BeansException
```
    例外:
    BeansException
  - getPropertyType
```
@Nullable
public java.lang.Class<?> getPropertyType(java.lang.String propertyName)
                                             throws BeansException
```
    クラスからコピーされた説明: PropertyEditorRegistrySupport
    指定されたプロパティパスのプロパティ型を決定します。
    必須の型が指定されていない場合に PropertyEditorRegistrySupport.findCustomEditor(java.lang.Class<?>, java.lang.String) によって呼び出され、プロパティパスを指定しただけでも型固有のエディターを検索できるようにします。
    デフォルトの実装は、常に null を返します。BeanWrapperImpl は、BeanWrapper インターフェースで定義されている標準の getPropertyType メソッドでこれをオーバーライドします。
    次で指定:
    インターフェース PropertyAccessor 内の getPropertyType
    オーバーライド:
    クラス AbstractPropertyAccessor の getPropertyType
    パラメーター:
    propertyName - 型を決定するプロパティパス
    戻り値:
    プロパティの型、または判別できない場合は null
    例外:
    PropertyAccessException - プロパティは有効だったが、アクセサーメソッドが失敗した場合
    BeansException
    関連事項:
    PropertyAccessor.getPropertyType(String)
  - getPropertyTypeDescriptor
```
@Nullable
public TypeDescriptor getPropertyTypeDescriptor(java.lang.String propertyName)
                                                   throws BeansException
```
    インターフェースからコピーされた説明: PropertyAccessor
    指定されたプロパティの型記述子を返します。できれば読み取りメソッドから、書き込みメソッドにフォールバックしてください。
    パラメーター:
    propertyName - チェックするプロパティ (ネストされたパスおよび / またはインデックス付き / マップされたプロパティ)
    戻り値:
    特定のプロパティのプロパティ型、または決定できない場合は null
    例外:
    PropertyAccessException - プロパティは有効だったが、アクセサーメソッドが失敗した場合
    BeansException
  - isReadableProperty
```
public boolean isReadableProperty(java.lang.String propertyName)
```
    インターフェースからコピーされた説明: PropertyAccessor
    指定したプロパティが読み取り可能かどうかを判断します。
    プロパティが存在しない場合、false を返します。
    パラメーター:
    propertyName - チェックするプロパティ (ネストされたパスおよび / またはインデックス付き / マップされたプロパティ)
    戻り値:
    プロパティが読み取り可能かどうか
  - isWritableProperty
```
public boolean isWritableProperty(java.lang.String propertyName)
```
    インターフェースからコピーされた説明: PropertyAccessor
    指定されたプロパティが書き込み可能かどうかを判断します。
    プロパティが存在しない場合、false を返します。
    パラメーター:
    propertyName - チェックするプロパティ (ネストされたパスおよび / またはインデックス付き / マップされたプロパティ)
    戻り値:
    プロパティが書き込み可能かどうか
  - convertForProperty
```
@Nullable
protected java.lang.Object convertForProperty(java.lang.String propertyName,
                                                        @Nullable
                                                        java.lang.Object oldValue,
                                                        @Nullable
                                                        java.lang.Object newValue,
                                                        TypeDescriptor td)
                                                 throws TypeMismatchException
```
    例外:
    TypeMismatchException
  - getPropertyValue
```
@Nullable
public java.lang.Object getPropertyValue(java.lang.String propertyName)
                                            throws BeansException
```
    クラスからコピーされた説明: AbstractPropertyAccessor
    実際にプロパティの値を取得します。
    次で指定:
    インターフェース PropertyAccessor 内の getPropertyValue
    次で指定:
    クラス AbstractPropertyAccessor の getPropertyValue
    パラメーター:
    propertyName - 値を取得するプロパティの名前
    戻り値:
    プロパティの値
    例外:
    InvalidPropertyException - そのようなプロパティがない場合、またはプロパティが読めない場合
    PropertyAccessException - プロパティは有効だったが、アクセサーメソッドが失敗した場合
    BeansException
  - getPropertyValue
```
@Nullable
protected java.lang.Object getPropertyValue(AbstractNestablePropertyAccessor.PropertyTokenHolder tokens)
                                               throws BeansException
```
    例外:
    BeansException
  - getPropertyHandler
```
@Nullable
protected AbstractNestablePropertyAccessor.PropertyHandler getPropertyHandler(java.lang.String propertyName)
                                                                                 throws BeansException
```
    指定された propertyName の AbstractNestablePropertyAccessor.PropertyHandler を返し、必要に応じてナビゲートします。例外をスローするのではなく、見つからない場合は null を返します。
    パラメーター:
    propertyName - 記述子を取得するプロパティ
    戻り値:
    指定されたプロパティのプロパティ記述子、または見つからない場合は null
    例外:
    BeansException - イントロスペクションが失敗した場合
  - getLocalPropertyHandler
```
@Nullable
protected abstract AbstractNestablePropertyAccessor.PropertyHandler getLocalPropertyHandler(java.lang.String propertyName)
```
    指定されたローカル propertyName の AbstractNestablePropertyAccessor.PropertyHandler を返します。現在のコンテキストで利用可能なプロパティに到達するためにのみ使用されます。
    パラメーター:
    propertyName - ローカルプロパティの名前
    戻り値:
    そのプロパティのハンドラー、または null が見つからない場合
  - newNestedPropertyAccessor
```
protected abstract AbstractNestablePropertyAccessor newNestedPropertyAccessor(java.lang.Object object,
                                                                              java.lang.String nestedPath)
```
    新しいネストされたプロパティアクセサーインスタンスを作成します。サブクラスでオーバーライドして、PropertyAccessor サブクラスを作成できます。
    パラメーター:
    object - この PropertyAccessor によってラップされたオブジェクト
    nestedPath - オブジェクトのネストされたパス
    戻り値:
    ネストされた PropertyAccessor インスタンス
  - createNotWritablePropertyException
```
protected abstract NotWritablePropertyException createNotWritablePropertyException(java.lang.String propertyName)
```
    指定されたプロパティの NotWritablePropertyException を作成します。
  - getFinalPath
```
protected java.lang.String getFinalPath(AbstractNestablePropertyAccessor pa,
                                        java.lang.String nestedPath)
```
    パスの最後のコンポーネントを取得します。ネストされていない場合にも機能します。
    パラメーター:
    pa - 作業するプロパティアクセサー
    nestedPath - ネストされていることがわかっているプロパティパス
    戻り値:
    パスの最後のコンポーネント (ターゲット Bean のプロパティ)
  - getPropertyAccessorForPropertyPath
```
protected AbstractNestablePropertyAccessor getPropertyAccessorForPropertyPath(java.lang.String propertyPath)
```
    再帰的にナビゲートして、ネストされたプロパティパスのプロパティアクセサーを返します。
    パラメーター:
    propertyPath - ネストできるプロパティパス
    戻り値:
    ターゲット Bean のプロパティアクセサー
  - toString
```
public java.lang.String toString()
```
    オーバーライド:
    クラス java.lang.Object の toString

クラス AbstractNestablePropertyAccessor

ネストされたクラスの概要

フィールド概要

インターフェース org.springframework.beans.PropertyAccessor から継承されたフィールド

コンストラクター概要

方法の概要

クラス org.springframework.beans.AbstractPropertyAccessor から継承されたメソッド

クラス org.springframework.beans.TypeConverterSupport から継承されたメソッド

クラス org.springframework.beans.PropertyEditorRegistrySupport から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

インターフェース org.springframework.beans.ConfigurablePropertyAccessor から継承されたメソッド

インターフェース org.springframework.beans.PropertyEditorRegistry から継承されたメソッド

インターフェース org.springframework.beans.TypeConverter から継承されたメソッド

コンストラクターの詳細

AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor

AbstractNestablePropertyAccessor

メソッドの詳細

setAutoGrowCollectionLimit

getAutoGrowCollectionLimit

setWrappedInstance

setWrappedInstance

getWrappedInstance

getWrappedClass

getNestedPath

getRootInstance

getRootClass

setPropertyValue

setPropertyValue

setPropertyValue

getPropertyType

getPropertyTypeDescriptor

isReadableProperty

isWritableProperty

convertForProperty

getPropertyValue

getPropertyValue

getPropertyHandler

getLocalPropertyHandler

newNestedPropertyAccessor

createNotWritablePropertyException

getFinalPath

getPropertyAccessorForPropertyPath

toString