SimpleEvaluationContext (Spring Framework API)

java.lang.ObjectSE
- org.springframework.expression.spel.support.SimpleEvaluationContext

実装されているすべてのインターフェース:
EvaluationContext
```
public final class SimpleEvaluationContext
extends ObjectSE
implements EvaluationContext
```
基本的な SpEL 機能とカスタマイズオプションのサブセットに焦点を当てた EvaluationContext の基本的な実装で、単純な条件評価と特定のデータバインディングシナリオを対象としています。
多くの場合、SpEL 言語の全範囲は必須ではなく、意味のある制限が必要です。例には、データバインディング式、プロパティベースのフィルターなどが含まれます。そのために、SimpleEvaluationContext は SpEL 言語構文のサブセットのみをサポートするように調整されています。Java 型、コンストラクター、Bean 参照への参照を除外します。
SimpleEvaluationContext を作成するときは、SpEL 式でのデータバインディングに必要なサポートレベルを選択する必要があります。
- 読み取り専用アクセスのデータバインディング
- 読み取りおよび書き込みアクセスのデータバインディング
- カスタム PropertyAccessor （通常、反射ベースではない）、DataBindingPropertyAccessor と組み合わせる可能性
便利なことに、forReadOnlyDataBinding() は DataBindingPropertyAccessor を介してプロパティへの読み取り専用アクセスを有効にします。同様に、forReadWriteDataBinding() はプロパティへの読み取りおよび書き込みアクセスを有効にします。または、forPropertyAccessors(org.springframework.expression.PropertyAccessor...) を介してカスタムアクセサーを構成し、割り当てを無効にし、必要に応じてビルダーを介してメソッド解決や型コンバーターを有効にします。
SimpleEvaluationContext は通常、デフォルトのルートオブジェクトで構成されていないことに注意してください。代わりに、一度作成され、EvaluationContext とルートオブジェクトの両方を引数として持つ定義済み Expression に対する getValue 呼び出しを通じて繰り返し使用されることを目的としています: Expression.getValue(EvaluationContext, Object)。
パワーと柔軟性を高めるため、特に内部構成のシナリオでは、代わりに StandardEvaluationContext の使用を検討してください。
導入:
4.3.15
作成者:
Rossen Stoyanchev, Juergen Hoeller, Sam Brannen
関連事項:
forReadOnlyDataBinding(), forReadWriteDataBinding(), forPropertyAccessors(org.springframework.expression.PropertyAccessor...), StandardEvaluationContext, StandardTypeConverter, DataBindingPropertyAccessor

ネストされたクラスの要約
ネストされたクラス
修飾子と型クラスと説明
static class SimpleEvaluationContext.Builder
SimpleEvaluationContext のビルダー。

ネストされたクラス
修飾子と型	クラスと説明
`static class`	`SimpleEvaluationContext.Builder` `SimpleEvaluationContext` のビルダー。

メソッドのサマリー

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`TypedValue`	`assignVariable(StringSE name, SupplierSE<TypedValue> valueSupplier)` `SimpleEvaluationContext` は、式内での変数の割り当てをサポートしていません。
`static SimpleEvaluationContext.Builder`	`forPropertyAccessors(PropertyAccessor... accessors)` 指定された `PropertyAccessor` デリゲートの `SimpleEvaluationContext` を作成します。通常は、ユースケースに固有のカスタム `PropertyAccessor` です (たとえば、カスタムデータ構造の属性解決用)。プロパティの逆参照も必要な場合は、`DataBindingPropertyAccessor` と組み合わせられる可能性があります。
`static SimpleEvaluationContext.Builder`	`forReadOnlyDataBinding()` `DataBindingPropertyAccessor` を介してパブリックプロパティに読み取り専用でアクセスする `SimpleEvaluationContext` を作成します。
`static SimpleEvaluationContext.Builder`	`forReadWriteDataBinding()` `DataBindingPropertyAccessor` を介してパブリックプロパティへの読み取り / 書き込みアクセス用の `SimpleEvaluationContext` を作成します。
`BeanResolver`	`getBeanResolver()` `SimpleEvaluationContext` は、Bean 参照の使用をサポートしていません。
`ListSE<ConstructorResolver>`	`getConstructorResolvers()` このコンテキストは型参照の使用をサポートしていないため、常に空のリストを返します。
`ListSE<MethodResolver>`	`getMethodResolvers()` 指定された `MethodResolver` デリゲートがある場合はそれを返します。
`OperatorOverloader`	`getOperatorOverloader()` `StandardOperatorOverloader` のインスタンスを返します。
`ListSE<PropertyAccessor>`	`getPropertyAccessors()` 指定された `PropertyAccessor` デリゲートがある場合はそれを返します。
`TypedValue`	`getRootObject()` 指定されたルートオブジェクトがあれば、それを返します。
`TypeComparator`	`getTypeComparator()` `StandardTypeComparator` のインスタンスを返します。
`TypeConverter`	`getTypeConverter()` 構成された `TypeConverter`。
`TypeLocator`	`getTypeLocator()` `SimpleEvaluationContext` は型参照の使用をサポートしていません。
`boolean`	`isAssignmentEnabled()` この評価コンテキストによって評価される式内で割り当てが有効になっているかどうかを判断します。
`ObjectSE`	`lookupVariable(StringSE name)` この評価コンテキスト内の名前付き変数を検索します。
`void`	`setVariable(StringSE name, ObjectSE value)` この評価コンテキストの名前付き変数を指定された値に設定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- メソッドの詳細
  - getRootObject
```
public TypedValue getRootObject()
```
    指定されたルートオブジェクトがあれば、それを返します。
    次で指定:
    インターフェース EvaluationContext の getRootObject
  - getPropertyAccessors
```
public ListSE<PropertyAccessor> getPropertyAccessors()
```
    指定された PropertyAccessor デリゲートがある場合はそれを返します。
    次で指定:
    インターフェース EvaluationContext の getPropertyAccessors
    関連事項:
    forPropertyAccessors(org.springframework.expression.PropertyAccessor...)
  - getConstructorResolvers
```
public ListSE<ConstructorResolver> getConstructorResolvers()
```
    このコンテキストは型参照の使用をサポートしていないため、常に空のリストを返します。
    次で指定:
    インターフェース EvaluationContext の getConstructorResolvers
  - getMethodResolvers
```
public ListSE<MethodResolver> getMethodResolvers()
```
    指定された MethodResolver デリゲートがある場合はそれを返します。
    次で指定:
    インターフェース EvaluationContext の getMethodResolvers
    関連事項:
    SimpleEvaluationContext.Builder.withMethodResolvers(org.springframework.expression.MethodResolver...)
  - getBeanResolver
```
@Nullable
public BeanResolver getBeanResolver()
```
    SimpleEvaluationContext は、Bean 参照の使用をサポートしていません。
    次で指定:
    インターフェース EvaluationContext の getBeanResolver
    戻り値:
    常に null
  - getTypeLocator
```
public TypeLocator getTypeLocator()
```
    SimpleEvaluationContext は型参照の使用をサポートしていません。
    次で指定:
    インターフェース EvaluationContext の getTypeLocator
    戻り値:
    SpelMessage.TYPE_NOT_FOUND で SpelEvaluationException を発生させる TypeLocator 実装。
  - getTypeConverter
```
public TypeConverter getTypeConverter()
```
    構成された TypeConverter。
    デフォルトでは、これは StandardTypeConverter です。
    次で指定:
    インターフェース EvaluationContext の getTypeConverter
    関連事項:
    SimpleEvaluationContext.Builder.withTypeConverter(org.springframework.expression.TypeConverter), SimpleEvaluationContext.Builder.withConversionService(org.springframework.core.convert.ConversionService)
  - getTypeComparator
```
public TypeComparator getTypeComparator()
```
    StandardTypeComparator のインスタンスを返します。
    次で指定:
    インターフェース EvaluationContext の getTypeComparator
  - getOperatorOverloader
```
public OperatorOverloader getOperatorOverloader()
```
    StandardOperatorOverloader のインスタンスを返します。
    次で指定:
    インターフェース EvaluationContext の getOperatorOverloader
  - assignVariable
```
public TypedValue assignVariable(StringSE name,
                                 SupplierSE<TypedValue> valueSupplier)
```
    SimpleEvaluationContext は、式内での変数の割り当てをサポートしていません。
    次で指定:
    インターフェース EvaluationContext の assignVariable
    パラメーター:
    name - 割り当てる変数の名前
    valueSupplier - 変数に割り当てられる値のサプライヤー
    戻り値:
    割り当てられた値をラップする TypedValue
    例外:
    SpelEvaluationException - SpelMessage.VARIABLE_ASSIGNMENT_NOT_SUPPORTED を使用する場合
    導入:
    5.2.24
  - setVariable
```
public void setVariable(StringSE name,
                        @Nullable
                        ObjectSE value)
```
    インターフェースからコピーされた説明: EvaluationContext
    この評価コンテキストの名前付き変数を指定された値に設定します。
    EvaluationContext.assignVariable(String, Supplier) とは対照的に、このメソッドは、EvaluationContext と直接対話する場合にのみプログラムで呼び出す必要があります。— たとえば、コンテキストの初期構成を提供します。
    次で指定:
    インターフェース EvaluationContext の setVariable
    パラメーター:
    name - 設定する変数の名前
    value - 変数に入れられる値
  - lookupVariable
```
@Nullable
public ObjectSE lookupVariable(StringSE name)
```
    インターフェースからコピーされた説明: EvaluationContext
    この評価コンテキスト内の名前付き変数を検索します。
    次で指定:
    インターフェース EvaluationContext の lookupVariable
    パラメーター:
    name - 検索する変数の名前
    戻り値:
    変数の値。見つからない場合は null
  - isAssignmentEnabled
```
public boolean isAssignmentEnabled()
```
    この評価コンテキストによって評価される式内で割り当てが有効になっているかどうかを判断します。
    このメソッドが false を返す場合、代入 (=)、増分 (++)、および減分 (--) 演算子は無効になります。
    次で指定:
    インターフェース EvaluationContext の isAssignmentEnabled
    戻り値:
    割り当てが有効な場合は true、そうでない場合は false
    導入:
    5.3.38
    関連事項:
    forReadOnlyDataBinding(), SimpleEvaluationContext.Builder.withAssignmentDisabled()
  - forPropertyAccessors
```
public static SimpleEvaluationContext.Builder forPropertyAccessors(PropertyAccessor... accessors)
```
    指定された PropertyAccessor デリゲートの SimpleEvaluationContext を作成します。通常は、ユースケースに固有のカスタム PropertyAccessor です (たとえば、カスタムデータ構造の属性解決用)。プロパティの逆参照も必要な場合は、DataBindingPropertyAccessor と組み合わせられる可能性があります。
    デフォルトでは、このファクトリメソッドを介して作成されたコンテキストによって評価される式内で割り当てが有効になっていますが、SimpleEvaluationContext.Builder.withAssignmentDisabled() を介して割り当てを無効にすることができます。
    パラメーター:
    accessors - 使用するアクセサーデリゲート
    関連事項:
    DataBindingPropertyAccessor.forReadOnlyAccess(), DataBindingPropertyAccessor.forReadWriteAccess(), isAssignmentEnabled(), SimpleEvaluationContext.Builder.withAssignmentDisabled()
  - forReadOnlyDataBinding
```
public static SimpleEvaluationContext.Builder forReadOnlyDataBinding()
```
    DataBindingPropertyAccessor を介してパブリックプロパティに読み取り専用でアクセスする SimpleEvaluationContext を作成します。
    このファクトリメソッドを介して作成されたコンテキストによって評価される式内では、割り当ては無効になります。
    関連事項:
    DataBindingPropertyAccessor.forReadOnlyAccess(), forPropertyAccessors(org.springframework.expression.PropertyAccessor...), isAssignmentEnabled(), SimpleEvaluationContext.Builder.withAssignmentDisabled()
  - forReadWriteDataBinding
```
public static SimpleEvaluationContext.Builder forReadWriteDataBinding()
```
    DataBindingPropertyAccessor を介してパブリックプロパティへの読み取り / 書き込みアクセス用の SimpleEvaluationContext を作成します。
    デフォルトでは、このファクトリメソッドを介して作成されたコンテキストによって評価される式内で割り当てが有効になっています。割り当ては SimpleEvaluationContext.Builder.withAssignmentDisabled() を介して無効にできますが、読み取り専用アクセスが必要な場合は forReadOnlyDataBinding() を使用することをお勧めします。
    関連事項:
    DataBindingPropertyAccessor.forReadWriteAccess(), forPropertyAccessors(org.springframework.expression.PropertyAccessor...), isAssignmentEnabled(), SimpleEvaluationContext.Builder.withAssignmentDisabled()

クラス SimpleEvaluationContext

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

メソッドのサマリー

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

メソッドの詳細

getRootObject

getPropertyAccessors

getConstructorResolvers

getMethodResolvers

getBeanResolver

getTypeLocator

getTypeConverter

getTypeComparator

getOperatorOverloader

assignVariable

setVariable

lookupVariable

isAssignmentEnabled

forPropertyAccessors

forReadOnlyDataBinding

forReadWriteDataBinding