java.beans
クラス Expression

java.lang.Object
  java.beans.Statement
      java.beans.Expression

public class Expression
extends Statement

Expression オブジェクトは、ターゲットと複数の引数に単一のメソッドを適用することにより、単一の戻り値 ("a.getFoo()" の場合と同様) を得ることができるプリミティブ式です。

Expression オブジェクトは、スーパークラスのプロパティーだけでなく、値 (この式の評価時に返されるオブジェクト) も提供します。通常、この戻り値は呼び出し元から提供されるのではなく、メソッドを動的に検索し、初めて getValue を呼び出すときにそのメソッドを呼び出すことによって計算されます。

導入されたバージョン:

1.4

関連項目:

getValue(), setValue(java.lang.Object)

コンストラクタの概要

Expression(Object value, Object target, String methodName, Object[] arguments)
単一の結果を返すメソッドの新しい Expression オブジェクトを作成します。

Expression(Object target, String methodName, Object[] arguments)
パラメータの指定に従って、target、methodName、および arguments を持つ新しい Statement オブジェクトを作成します。

メソッドの概要

Object	getValue() このインスタンスの value プロパティーがまだ設定されていない場合、このメソッドは引数を使って、ターゲット上の指定された methodName からメソッドを動的に検索し、呼び出します。
void	setValue(Object value) この式の値を value にします。
String	toString() Java スタイルの構文を使って、この式の値を出力します。

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

execute, getArguments, getMethodName, getTarget

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Expression

public Expression(Object target,
                  String methodName,
                  Object[] arguments)

パラメータの指定に従って、target、methodName、および arguments を持つ新しい Statement オブジェクトを作成します。

パラメータ:

target - この式のターゲット

methodName - この式の methodName

arguments - この式の引数。null の場合は、空の配列が使用される

関連項目:

getValue()

Expression

public Expression(Object value,
                  Object target,
                  String methodName,
                  Object[] arguments)

単一の結果を返すメソッドの新しい Expression オブジェクトを作成します。ただし、その結果が計算されることはありません。これは、このコンストラクタが、setValue メソッドの呼び出しにより value パラメータを使って value プロパティーを設定するからです。

パラメータ:

value - この式の値

target - この式のターゲット

methodName - この式の methodName

arguments - この式の引数。null の場合は、空の配列が使用される

関連項目:

setValue(java.lang.Object)

メソッドの詳細

getValue

public Object getValue()
                throws Exception

このインスタンスの value プロパティーがまだ設定されていない場合、このメソッドは引数を使って、ターゲット上の指定された methodName からメソッドを動的に検索し、呼び出します。このメソッド呼び出しの結果は、この式の value プロパティーにコピーされたあと、getValue の結果として返されます。value プロパティーが設定されている場合は、setValue の呼び出しか、以前の getValue の呼び出しにより、value プロパティーが返されます。この場合、メソッドの検索や呼び出しは不要です。

デフォルトでは、Expression の value プロパティーは非公開の一意の値 (null 以外) になり、メソッドがまだ呼び出されていないことを内部的に示します。戻り値 null は、その他の値と同様にこのデフォルト値を置き換えます。このため、式の評価回数が 2 回以上になることはありません。

動的なターゲットおよび引数によるメソッドの選択方法の詳細については、excecute メソッドを参照してください。

戻り値:

このメソッドを引数に適用した結果

例外:

Exception

関連項目:

Statement.execute(), setValue(java.lang.Object)

setValue

public void setValue(Object value)

この式の値を value にします。この値は getValue メソッドから返されます。このとき、この式に関連付けられているメソッドが呼び出されることはありません。

パラメータ:

value - この式の値

関連項目:

getValue()

toString

public String toString()

Java スタイルの構文を使って、この式の値を出力します。

オーバーライド:

クラス Statement 内の toString

戻り値:

このオブジェクトの文字列表現