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 は、コンシューマー実装で次のコンテキストプロパティーをサポートします。