Web Services Addressing API

この製品は、アプリケーション・プログラミング・レベルでの インターフェースを提供して、アプリケーション開発者 (Web Services Resource Framework アプリケーションの 開発者を含む) が Web サービス・リソース・インスタンスへの参照を作成したり、Web サービス・リソース・インスタンスを ターゲットにしたりできるようにします。システム・プログラマーは、このインターフェースを Web Services Addressing (WS-Addressing) システム・プログラミング・インターフェースと併用することができます。

JAX-WS 2.1 API

この製品の標準 JAX-WS 2.1 API は、javax.xml.ws.wsaddressing パッケージに含まれています。 この API について詳しくは、JAX-WS 2.1 API の資料を参照してください。

この製品の標準 JAX-WS 2.1 API を実装すると、com.ibm.websphere.wsaddressing.jaxws21 パッケージにあるアプリケーション・プログラミング・インターフェースも追加されます。 この API については、このインフォメーション・センターの『生成された API 文書』で詳しく説明されています。 これらの API により、以下のように固有のクラスを使用して目標を達成することができます。
  • 2004/08 WS-Addressing 仕様に準拠したエンドポイントを表すには、com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference クラスを使用します。
  • 2004/08 エンドポイントを表す SubmissionEndpointReference インスタンスを、エンドポイント参照を生成している以外の Web サービスで作成するには、com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReferenceBuilder クラスを使用します。
  • IBM 専有 WS-Addressing API を使用して作成された EndpointReference インスタンスを、W3CEndpointReference インスタンスまたは SubmissionEndpointReference インスタンスに変換するには、com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceCoverter クラスを使用します。 このクラスは、EndpointReference インスタンスの変換をリバースする場合にも使用できます。
  • クライアントで WS-Addressing を使用可能にするには、com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressingFeature クラスと、サーバーで WS-Addressing を使用可能にするアノテーション @SubmissionAddressing を使用します。

IBM 専有 WS-Addressing API

このアプリケーション・プログラミング・インターフェースは、com.ibm.websphere.wsaddressing パッケージに含まれています。要約すると、次の図のようになります。 図には、JAX-WS 2.1 API のクラスである com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter、javax.xml.ws.wsaddressing.W3CEndpointReference、および com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference も示します。
Java クラス EndpointReferenceManager には、2 つのメソッド (createEndpointReference と
getReferenceParameterFromMessageContext) が含まれています。このクラスは、他に 3 つのクラスを使用します。
EndpointReference (メソッド setReferenceParameter を含む)、WSAConstants
(定数 WSADDRESSING_DESTINATION_EPR を含む)、および ReferenceParameterCreationException です。
WSAConstants と ReferenceParameterCreationException は、さらにクラス
EndpointReferenceCreationException も使用します。
これらのインターフェースには、次のような特徴があります。
  • com.ibm.websphere.EndpointReferenceManager.createEndpointReference インターフェースを使用して WS-Addressing エンドポイント参照を表す com.ibm.websphere.wsaddressing.EndpointReference インスタンスを作成するメカニズム。
  • 非推奨の機能 (Deprecated feature) 非推奨の機能 (Deprecated feature): 推奨されないクラス com.ibm.websphere.wsaddressing.EndpointReferenceCoverter。JAX-WS アプリケーションで使用するために EndpointReference インスタンスを推奨されないクラス com.ibm.websphere.wsaddressing.W3CEndpointReference または com.ibm.websphere.wsaddressing.SubmissionEndpointReferences に変換します。

    これらのクラスは推奨されません。図で示すように、com.ibm.websphere.wsaddressing.jaxws21 パッケージおよび javax.xml.ws.wsaddressing.jaxws21 パッケージに含まれている同じ名前の JAX-WS 2.1 クラス (EndpointReferenceConverter、SubmissionEndpointReference、および W3CEndpointReference) が優先されます。

    depfeat
  • メソッド com.ibm.websphere.wsaddressing.EndpointReference.setReferenceParameter。参照パラメーターを EndpointReference インスタンスと関連付けできるようにします。
  • クライアントが、EndpointReference インスタンスに基づいて、BindingProvider 要求コンテキスト、または Stub または Call オブジェクトを 構成できるようにするインターフェース。BindingProvider、Stub または Call オブジェクト上の呼び出しはすべて、 これ以後は EndpointReference インスタンスにより表されるエンドポイントがターゲットとなります。 この振る舞いを実現するには、 BindingProvider 要求コンテキスト、または Stub または Call オブジェクトの com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR プロパティーを、適切な EndpointReference インスタンスに設定します。
  • 着信メッセージのコンテキストに関連付けられている個々の参照パラメーターを獲得し、 そのメッセージを特定のリソース・インスタンスに com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext インターフェースを介して関連付けるメカニズム。

トピックのタイプを示すアイコン 概念トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsa_api
ファイル名:cwbs_wsa_api.html