JavaTM Platform
Standard Ed. 6

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)
          パラメータの指定に従って、targetmethodName、および 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)
パラメータの指定に従って、targetmethodName、および 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
戻り値:
このオブジェクトの文字列表現

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。