- すべての実装されたインタフェース:
Operation
Namespace
で動作する操作を記述します。 たとえば、プロパティ・ゲッターは次のように記述されます。
Operation propertyGetter = new NamespaceOperation( StandardOperation.GET, StandardNamespace.PROPERTY);それらはしばしば
NamedOperation
と組み合わされます。たとえば、"color"というプロパティのプロパティ・ゲッターを表現するには、次のようにします:
Operation colorPropertyGetter = new NamedOperation( new NamespaceOperation( StandardOperation.GET, StandardNamespace.PROPERTY), "color");
NamespaceOperation
は直接構築することができますが、代わりにOperation.withNamespace(Namespace)
とOperation.withNamespaces(Namespace...)
ファクトリ・メソッドを使用すると便利です:
Operation getElementOrPropertyEmpty = StandardOperation.GET .withNamespace(StandardNamespace.PROPERTY) .named("color");
複数のネームスペースに対する操作
複数のネームスペースが指定されている場合、ネームスペースは、優先順に互いの代替として扱われます。 そのような操作のセマンティクスは"最初に適用可能"です。 つまり、GET:PROPERTY|ELEMENT:color
のコンポジットは「オブジェクト上に"color"という名前のプロパティを取得します。ただし、プロパティが存在しない場合は、代わりに"color"という名前のコレクション要素を取得してください」と解釈されます。
複数のネームスペースを持つ操作は、1つ以上のネームスペースを区別しない言語の実装や、JavaのMap
オブジェクトなどの通常のオブジェクトとコレクションの両方と見なせるオブジェクトに対する操作を表現する際に役立ちます。 Javaマップに対するGET:PROPERTY|ELEMENT:empty
操作は常にMap.isEmpty()
プロパティと一致しますが、GET:ELEMENT|PROPERTY:empty
はマップにそのキーが含まれている場合はマップ要素とキー"empty"
を実際に一致させ、マップにキーが含まれていない場合はisEmpty()
プロパティ・ゲッターに戻ります。 ソース言語がこのセマンティクスを要求する場合、複数のネームスペースでの操作を使用して簡単に達成できます。
言語自体がいくつかのネームスペースを区別しなくても、異なる構文を異なるネームスペースの順序にマップすると便利です。 例えば、ソース表現obj.color
はGET:PROPERTY|ELEMENT|METHOD:color
にマップできますが、要素セマンティクスを優先するために、コレクション要素アクセスobj[key]
のように見える別のソース式を代わりにGET:ELEMENT|PROPERTY|METHOD
として表すことができます。 最後に、検索された値が続いて呼び出された場合、METHOD
をネームスペース・リストの先頭に持っていくことが理にかなっています: ソース式のobj.color()
のゲッター部分はGET:METHOD|PROPERTY|ELEMENT:color
とすることができ、obj[key]()
のゲッター部分はGET:METHOD|ELEMENT|PROPERTY
とすることができます。
ネームスペース操作の基本操作は、ネームスペースまたは名前付き操作ではありませんが、単純な操作の1つはStandardOperation
の要素です。 ネームスペース操作自体は、名前付き操作の基本操作として機能することができます。例えばGET:ELEMENT|PROPERTY:empty
を上から構築する典型的な方法は次のようになります:
Operation getElementOrPropertyEmpty = StandardOperation.GET .withNamespaces( StandardNamespace.ELEMENT, StandardNamespace.PROPERTY) .named("empty");
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明NamespaceOperation(Operation baseOperation, Namespace... namespaces)
新しいネームスペース操作を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明boolean
このネームスペース操作に指定されたネームスペースと等しいネームスペースが含まれている場合はtrueを返します。static boolean
指定された操作がNamespaceOperation
で、その基底操作が指定された操作と等しく、指定されたネームスペースを含む場合はtrueを返します。boolean
他のオブジェクトがネームスペース操作であり、その基本操作とネームスペースが等しい場合はtrueを返します。この名前付き操作の基本操作を返します。static Operation
渡された操作がネームスペース操作の場合はgetBaseOperation()
を返し、そうでない場合はその操作をそのまま返します。getNamespace(int i)
このネームスペース操作のi番目のネームスペースを返します。int
このネームスペース操作のネームスペースの数を返します。このネームスペース操作のネームスペースを返します。static Namespace[]
getNamespaces(Operation op)
渡された操作がネームスペース操作の場合はgetNamespaces()
を返し、そうでない場合は空の配列を返します。int
hashCode()
このネームスペース操作のハッシュ・コードを返します。toString()
このネームスペース操作の文字列表現を返します。インタフェース jdk.dynalink.Operationで宣言されたメソッド
named, withNamespace, withNamespaces
-
コンストラクタの詳細
-
NamespaceOperation
新しいネームスペース操作を構築します。- パラメータ:
baseOperation
- 1つ以上のネームスペースで動作する基本操作。namespaces
- この操作が動作する1つ以上のネームスペース。- 例外:
IllegalArgumentException
- 1つよりも少ないネームスペースが指定されている場合、または基本操作自体がNamespaceOperation
またはNamedOperation
です。NullPointerException
-namespaces
配列またはその要素のいずれかがnull
である場合、またはbaseOperation
がnull
である場合。
-
-
メソッドの詳細
-
getBaseOperation
public Operation getBaseOperation()この名前付き操作の基本操作を返します。- 戻り値:
- この名前付き操作の基本操作。
-
getNamespaces
public Namespace[] getNamespaces()このネームスペース操作のネームスペースを返します。 返される配列はコピーであり、このオブジェクトへの変更はこのオブジェクトには影響しません。- 戻り値:
- このネームスペース操作のネームスペース。
-
getNamespaceCount
public int getNamespaceCount()このネームスペース操作のネームスペースの数を返します。- 戻り値:
- このネームスペース操作におけるネームスペースの数。
-
getNamespace
public Namespace getNamespace(int i)このネームスペース操作のi番目のネームスペースを返します。- パラメータ:
i
- ネームスペース・インデックス- 戻り値:
- このネームスペース操作のi番目のネームスペース。
- 例外:
IndexOutOfBoundsException
- インデックスが範囲外の場合。
-
contains
public boolean contains(Namespace namespace)このネームスペース操作に指定されたネームスペースと等しいネームスペースが含まれている場合はtrueを返します。- パラメータ:
namespace
- ネームスペースが検索されます。 nullは不可。- 戻り値:
- このネームスペース操作の場合、指定されたネームスペースと等しいネームスペースが含まれている場合はtrue。
-
equals
public boolean equals(Object obj)他のオブジェクトがネームスペース操作であり、その基本操作とネームスペースが等しい場合はtrueを返します。- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- 比較対象のオブジェクト- 戻り値:
- このオブジェクトが他のオブジェクトと等しい場合はtrue、そうでない場合はfalse。
- 関連項目:
Object.hashCode()
、HashMap
-
hashCode
public int hashCode()このネームスペース操作のハッシュ・コードを返します。baseOperation.hashCode() + 31 * Arrays.hashCode(namespaces)
と等しくなるように定義されています。- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()このネームスペース操作の文字列表現を返します。 その基本操作のtoString
に続いてコロン文字が続き、そのネームスペースのリストが垂直線(e.g."GET:PROPERTY|ELEMENT"
)で区切られていると定義されています。 -
getBaseOperation
渡された操作がネームスペース操作の場合はgetBaseOperation()
を返し、そうでない場合はその操作をそのまま返します。- パラメータ:
op
- 操作- 戻り値:
- 渡された操作の基本操作。
-
getNamespaces
渡された操作がネームスペース操作の場合はgetNamespaces()
を返し、そうでない場合は空の配列を返します。- パラメータ:
op
- 操作- 戻り値:
- 渡された操作のネームスペース。
-
contains
指定された操作がNamespaceOperation
で、その基底操作が指定された操作と等しく、指定されたネームスペースを含む場合はtrueを返します。NamespaceOperation
でない場合、falseを返します。- パラメータ:
op
- 操作。 nullは不可。baseOperation
- 基本操作が検索されます。 nullは不可。namespace
- ネームスペースが検索されます。 nullは不可。- 戻り値:
- 渡された操作が
NamespaceOperation
で、その基本操作が検索された基本操作と等しく、検索されたネームスペースと等しいネームスペースを含む場合はtrue。
-