42.3. コンシューマー実装でのコンテキストの操作

コンシューマー実装は、BindingProvider インターフェースを介してコンテキスト情報にアクセスできます。BindingProvider インスタンスは、2 つの個別のコンテキストでコンテキスト情報を保持します。

コンテキストは、javax.xml.ws.BindingProvider インターフェースを使用して取得します。BindingProvider インターフェースには、コンテキストの取得に関して 2 つのメソッドあります。

プロキシーオブジェクトは BindingProvider インターフェースを実装するため、プロキシーオブジェクトをキャストすることで BindingProvider オブジェクトを取得できます。BindingProvider オブジェクトから取得したコンテキストは、作成に使用されたプロキシーオブジェクトで呼び出される操作にのみ有効です。

例42.9「コンシューマーのリクエストコンテキストの取得」に、プロキシーのリクエストコンテキストを取得するためのコードを示します。

// Proxy widgetProxy obtained previously
BindingProvider bp = (BindingProvider)widgetProxy;
Map<String, Object> requestContext = bp.getRequestContext();

コンシューマーコンテキストは java.util.Map<String, Object> オブジェクトに保存されます。マップは、String オブジェクトであるキーと任意のオブジェクトが含まれる値を持ちます。応答コンテキストプロパティーのマッピングにあるエントリーにアクセスするには、java.util.Map.get() を使用します。

特定のコンテキストプロパティー ContextPropertyName を取得するには、例42.10「レスポンスコンテキストプロパティーの読み取り」に示されるコードを使用します。

// Invoke an operation.
port.SomeOperation();

// Read response context property.
java.util.Map<String, Object> responseContext =
  ((javax.xml.ws.BindingProvider)port).getResponseContext();
PropertyType propValue = (PropertyType) responseContext.get(ContextPropertyName);

コンシューマーコンテキストは、java.util.Map<String, Object> オブジェクトに保存されるハッシュマップです。マップには、String オブジェクトであるキーと任意のオブジェクトである値が含まれます。コンテキストのプロパティーを設定するには、java.util.Map.put() メソッドを使用します。

プロパティーをリクエストコンテキストと応答コンテキストの両方で設定できますが、リクエストコンテキストに加えた変更のみがメッセージ処理に影響します。応答コンテキストのプロパティーは、現在のスレッドで各リモート呼び出しが完了するとリセットされます。

例42.11「リクエストコンテキストプロパティーの設定」に記載されているコードは、BindingProvider.ENDPOINT_ADDRESS_PROPERTY の値を設定して、ターゲットサービスプロバイダーのアドレスを変更します。

// Set request context property.
java.util.Map<String, Object> requestContext =
     ((javax.xml.ws.BindingProvider)port).getRequestContext();
requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, "http://localhost:8080/widgets");

// Invoke an operation.
port.SomeOperation();

Apache CXF は、コンシューマー実装で以下のコンテキストプロパティーをサポートします。