クラス SpelExpression
java.lang.ObjectSE
org.springframework.expression.spel.standard.SpelExpression
- 実装されたすべてのインターフェース:
Expression
SpelExpression
は、指定されたコンテキストで評価する準備ができている解析済み(有効)式を表します。式は、スタンドアロンまたは指定されたコンテキストで評価できます。式の評価中に、型、Bean、プロパティ、メソッドへの参照を解決するようコンテキストに要求される場合があります。- 導入:
- 3.0
- 作成者:
- Andy Clement, Juergen Hoeller, Sam Brannen
コンストラクターの概要
コンストラクターコンストラクター説明SpelExpression
(StringSE expression, SpelNodeImpl ast, SpelParserConfiguration configuration) パーサーによってのみ使用される式を作成します。メソッドのサマリー
修飾子と型メソッド説明boolean
式のコンパイルを実行します。getAST()
式の抽象構文ツリーを返します。評価呼び出しで何も指定されていない場合に使用されるデフォルトの評価コンテキストを返します。この式の作成に使用された元の文字列を返します(変更なし)。getValue()
この式をデフォルトのコンテキストで評価し、評価の結果を返します。<T> T
この式をデフォルトのコンテキストで評価し、評価の結果を返します。指定されたルートオブジェクトに対してデフォルトのコンテキストでこの式を評価し、評価の結果を返します。<T> T
指定されたルートオブジェクトに対してデフォルトのコンテキストでこの式を評価し、評価の結果を返します。getValue
(EvaluationContext context) 指定されたコンテキストでこの式を評価し、評価の結果を返します。<T> T
getValue
(EvaluationContext context, ClassSE<T> expectedResultType) 指定されたコンテキストでこの式を評価し、評価の結果を返します。getValue
(EvaluationContext context, ObjectSE rootObject) 指定されたコンテキストで指定されたルートオブジェクトに対してこの式を評価し、評価の結果を返します。<T> T
getValue
(EvaluationContext context, ObjectSE rootObject, ClassSE<T> expectedResultType) 指定されたコンテキストで指定されたルートオブジェクトに対してこの式を評価し、評価の結果を返します。ClassSE<?>
デフォルトのコンテキストを使用してExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型を返します。ClassSE<?>
getValueType
(ObjectSE rootObject) デフォルトのコンテキストを使用してExpression.setValue(Object, Object)
メソッドに渡すことができる最も一般的な型を返します。ClassSE<?>
getValueType
(EvaluationContext context) 指定されたコンテキストのExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型を返します。ClassSE<?>
getValueType
(EvaluationContext context, ObjectSE rootObject) 指定されたコンテキストのExpression.setValue(EvaluationContext, Object, Object)
メソッドに渡すことができる最も一般的な型を返します。デフォルトのコンテキストを使用してsetValue(...)
メソッドの 1 つに渡すことができる、最も一般的な型の記述子を返します。getValueTypeDescriptor
(ObjectSE rootObject) デフォルトのコンテキストを使用してExpression.setValue(Object, Object)
メソッドに渡すことができる、最も一般的な型の記述子を返します。getValueTypeDescriptor
(EvaluationContext context) 指定されたコンテキストのExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型の記述子を返します。getValueTypeDescriptor
(EvaluationContext context, ObjectSE rootObject) 指定されたコンテキストのExpression.setValue(EvaluationContext, Object, Object)
メソッドに渡すことができる最も一般的な型の記述子を返します。boolean
isWritable
(ObjectSE rootObject) この式を書き込むことができるかどうかを判断します。boolean
isWritable
(EvaluationContext context) この式を書き込むことができるかどうかを判断します。boolean
isWritable
(EvaluationContext context, ObjectSE rootObject) この式を書き込むことができるかどうかを判断します。void
コンパイルされたフォームを使用している場合、式を解釈されるように戻します。void
setEvaluationContext
(EvaluationContext evaluationContext) 評価呼び出しで何も指定されていない場合に使用される評価コンテキストを設定します。void
デフォルトのコンテキストでこの式を指定された値に設定します。void
setValue
(EvaluationContext context, ObjectSE value) 提供されたコンテキストでこの式を提供された値に設定します。void
setValue
(EvaluationContext context, ObjectSE rootObject, ObjectSE value) 提供されたコンテキストでこの式を提供された値に設定します。式の抽象構文ツリーの文字列表現を生成します。
コンストラクターの詳細
SpelExpression
パーサーによってのみ使用される式を作成します。
メソッドの詳細
setEvaluationContext
評価呼び出しで何も指定されていない場合に使用される評価コンテキストを設定します。- パラメーター:
evaluationContext
- 使用する評価コンテキスト
getEvaluationContext
評価呼び出しで何も指定されていない場合に使用されるデフォルトの評価コンテキストを返します。- 戻り値:
- デフォルトの評価コンテキスト
getExpressionString
インターフェースからコピーされた説明:Expression
この式の作成に使用された元の文字列を返します(変更なし)。- 次で指定:
- インターフェース
Expression
のgetExpressionString
- 戻り値:
- 元の式文字列
getValue
インターフェースからコピーされた説明:Expression
この式をデフォルトのコンテキストで評価し、評価の結果を返します。- 次で指定:
- インターフェース
Expression
のgetValue
- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
インターフェースからコピーされた説明:Expression
この式をデフォルトのコンテキストで評価し、評価の結果を返します。評価の結果が期待される結果型と一致しない (変換できない) 場合は、例外がスローされます。
- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
expectedResultType
- 呼び出し元が結果を望む型- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
インターフェースからコピーされた説明:Expression
指定されたルートオブジェクトに対してデフォルトのコンテキストでこの式を評価し、評価の結果を返します。- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
@Nullable public <T> T getValue(@Nullable ObjectSE rootObject, @Nullable ClassSE<T> expectedResultType) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたルートオブジェクトに対してデフォルトのコンテキストでこの式を評価し、評価の結果を返します。評価の結果が期待される結果型と一致しない (変換できない) 場合は、例外がスローされます。
- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクトexpectedResultType
- 呼び出し元が結果を望む型- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
インターフェースからコピーされた説明:Expression
指定されたコンテキストでこの式を評価し、評価の結果を返します。- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
context
- 式を評価するコンテキスト- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
@Nullable public <T> T getValue(EvaluationContext context, @Nullable ClassSE<T> expectedResultType) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストでこの式を評価し、評価の結果を返します。評価の結果が期待される結果型と一致しない (変換できない) 場合は、例外がスローされます。
- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
context
- 式を評価するコンテキストexpectedResultType
- 呼び出し元が結果を望む型- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
@Nullable public ObjectSE getValue(EvaluationContext context, @Nullable ObjectSE rootObject) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストで指定されたルートオブジェクトに対してこの式を評価し、評価の結果を返します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
context
- 式を評価するコンテキストrootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValue
@Nullable public <T> T getValue(EvaluationContext context, @Nullable ObjectSE rootObject, @Nullable ClassSE<T> expectedResultType) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストで指定されたルートオブジェクトに対してこの式を評価し、評価の結果を返します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
評価の結果が期待される結果型と一致しない (変換できない) 場合は、例外がスローされます。
- 次で指定:
- インターフェース
Expression
のgetValue
- パラメーター:
context
- 式を評価するコンテキストrootObject
- 式を評価する対象となるルートオブジェクトexpectedResultType
- 呼び出し元が結果を望む型- 戻り値:
- 評価結果
- 例外:
EvaluationException
- 評価中に問題が発生した場合
getValueType
インターフェースからコピーされた説明:Expression
デフォルトのコンテキストを使用してExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型を返します。- 次で指定:
- インターフェース
Expression
のgetValueType
- 戻り値:
- このコンテキストで設定できる最も一般的な型の値
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueType
インターフェースからコピーされた説明:Expression
デフォルトのコンテキストを使用してExpression.setValue(Object, Object)
メソッドに渡すことができる最も一般的な型を返します。- 次で指定:
- インターフェース
Expression
のgetValueType
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- このコンテキストで設定できる最も一般的な型の値
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueType
インターフェースからコピーされた説明:Expression
指定されたコンテキストのExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型を返します。- 次で指定:
- インターフェース
Expression
のgetValueType
- パラメーター:
context
- 式を評価するコンテキスト- 戻り値:
- このコンテキストで設定できる最も一般的な型の値
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueType
@Nullable public ClassSE<?> getValueType(EvaluationContext context, @Nullable ObjectSE rootObject) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストのExpression.setValue(EvaluationContext, Object, Object)
メソッドに渡すことができる最も一般的な型を返します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
- 次で指定:
- インターフェース
Expression
のgetValueType
- パラメーター:
context
- 式を評価するコンテキストrootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- このコンテキストで設定できる最も一般的な型の値
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueTypeDescriptor
インターフェースからコピーされた説明:Expression
デフォルトのコンテキストを使用してsetValue(...)
メソッドの 1 つに渡すことができる、最も一般的な型の記述子を返します。- 次で指定:
- インターフェース
Expression
のgetValueTypeDescriptor
- 戻り値:
- このコンテキストで設定できる値の型記述子
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueTypeDescriptor
@Nullable public TypeDescriptor getValueTypeDescriptor(@Nullable ObjectSE rootObject) throws EvaluationException インターフェースからコピーされた説明:Expression
デフォルトのコンテキストを使用してExpression.setValue(Object, Object)
メソッドに渡すことができる、最も一般的な型の記述子を返します。- 次で指定:
- インターフェース
Expression
のgetValueTypeDescriptor
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- このコンテキストで設定できる値の型記述子
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueTypeDescriptor
@Nullable public TypeDescriptor getValueTypeDescriptor(EvaluationContext context) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストのExpression.setValue(EvaluationContext, Object)
メソッドに渡すことができる最も一般的な型の記述子を返します。- 次で指定:
- インターフェース
Expression
のgetValueTypeDescriptor
- パラメーター:
context
- 式を評価するコンテキスト- 戻り値:
- このコンテキストで設定できる値の型記述子
- 例外:
EvaluationException
- 型の判別に問題がある場合
getValueTypeDescriptor
@Nullable public TypeDescriptor getValueTypeDescriptor(EvaluationContext context, @Nullable ObjectSE rootObject) throws EvaluationException インターフェースからコピーされた説明:Expression
指定されたコンテキストのExpression.setValue(EvaluationContext, Object, Object)
メソッドに渡すことができる最も一般的な型の記述子を返します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
- 次で指定:
- インターフェース
Expression
のgetValueTypeDescriptor
- パラメーター:
context
- 式を評価するコンテキストrootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
- このコンテキストで設定できる値の型記述子
- 例外:
EvaluationException
- 型の判別に問題がある場合
isWritable
インターフェースからコピーされた説明:Expression
この式に書き込むことができるかどうか、つまり setValue() を呼び出すことができるかどうかを判断します。- 次で指定:
- インターフェース
Expression
のisWritable
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
true
(式が書き込み可能な場合)。それ以外の場合はfalse
- 例外:
EvaluationException
- 書き込み可能かどうかを決定する問題がある場合
isWritable
インターフェースからコピーされた説明:Expression
この式に書き込むことができるかどうか、つまり setValue() を呼び出すことができるかどうかを判断します。- 次で指定:
- インターフェース
Expression
のisWritable
- パラメーター:
context
- 式がチェックされるコンテキスト- 戻り値:
true
(式が書き込み可能な場合)。それ以外の場合はfalse
- 例外:
EvaluationException
- 書き込み可能かどうかを決定する問題がある場合
isWritable
public boolean isWritable(EvaluationContext context, @Nullable ObjectSE rootObject) throws EvaluationException インターフェースからコピーされた説明:Expression
この式に書き込むことができるかどうか、つまり setValue() を呼び出すことができるかどうかを判断します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
- 次で指定:
- インターフェース
Expression
のisWritable
- パラメーター:
context
- 式がチェックされるコンテキストrootObject
- 式を評価する対象となるルートオブジェクト- 戻り値:
true
(式が書き込み可能な場合)。それ以外の場合はfalse
- 例外:
EvaluationException
- 書き込み可能かどうかを決定する問題がある場合
setValue
public void setValue(@Nullable ObjectSE rootObject, @Nullable ObjectSE value) throws EvaluationException インターフェースからコピーされた説明:Expression
デフォルトのコンテキストでこの式を指定された値に設定します。- 次で指定:
- インターフェース
Expression
のsetValue
- パラメーター:
rootObject
- 式を評価する対象となるルートオブジェクトvalue
- 新しい価値- 例外:
EvaluationException
- 評価中に問題が発生した場合
setValue
public void setValue(EvaluationContext context, @Nullable ObjectSE value) throws EvaluationException インターフェースからコピーされた説明:Expression
提供されたコンテキストでこの式を提供された値に設定します。- 次で指定:
- インターフェース
Expression
のsetValue
- パラメーター:
context
- 式の値を設定するコンテキストvalue
- 新しい価値- 例外:
EvaluationException
- 評価中に問題が発生した場合
setValue
public void setValue(EvaluationContext context, @Nullable ObjectSE rootObject, @Nullable ObjectSE value) throws EvaluationException インターフェースからコピーされた説明:Expression
提供されたコンテキストでこの式を提供された値に設定します。指定されたルートオブジェクトは、コンテキストで構成されているデフォルトのルートオブジェクトのオーバーライドとして使用されます。
- 次で指定:
- インターフェース
Expression
のsetValue
- パラメーター:
context
- 式の値を設定するコンテキストrootObject
- 式を評価する対象となるルートオブジェクトvalue
- 新しい価値- 例外:
EvaluationException
- 評価中に問題が発生した場合
compileExpression
public boolean compileExpression()式のコンパイルを実行します。これは、すべてのノードの出口記述子が決定されて初めて成功します。コンパイルが失敗し、100 回を超えて失敗した場合、式はコンパイルに適しているとは見なされなくなります。- 戻り値:
- この式が正常にコンパイルされたかどうか
revertToInterpreted
public void revertToInterpreted()コンパイルされたフォームを使用している場合、式を解釈されるように戻します。また、コンパイル試行の失敗回数をリセットします(式は、100 回試行してもコンパイルできない場合、通常はコンパイル可能と見なされなくなります)。getAST
式の抽象構文ツリーを返します。toStringAST
式の抽象構文ツリーの文字列表現を生成します。これは理想的には入力式のように見えるはずですが、式の解析中に不要な空白が破棄されるため、適切にフォーマットされます。- 戻り値:
- AST の文字列表現