WebSphere Application Server は、アプリケーション・プログラミング・レベルでの
インターフェースを提供して、アプリケーション開発者 (Web Services Resource Framework アプリケーションの
開発者を含む) が Web サービス・リソース・インスタンスへの参照を作成したり、Web サービス・リソース・インスタンスを
ターゲットにしたりできるようにします。
システム・プログラマーは、
このインターフェースを Web Services Addressing (WS-Addressing) システム・プログラミング・インターフェースと
同時に使用することができます。
このトピックで取り上げるプログラミング・インターフェースについては、WS-Addressing API の資料に
より詳しい説明があります。
アプリケーション・プログラミング・インターフェースは、
com.ibm.websphere.wsaddressing パッケージに含まれています。要約すると、次の図のようになります。
これらのインターフェースには、次のような特徴があります。
- com.ibm.websphere.EndpointReferenceManager.createEndpointReference インターフェースを使用して WS-Addressing エンドポイント参照を表す
com.ibm.websphere.EndpointReference インスタンスを作成するメカニズム。
- JAX-WS アプリケーションで使用するために、EndpointReference インスタンスを W3CEndpointReference または SubmissionEndpointReferences のいずれかに変換するためのクラス com.ibm.websphere.EndpointReferenceCoverter。
- 参照パラメーターと EndpointReference インスタンスとの関連付けを使用可能にする
メソッド com.ibm.websphere.EndpointReference.setReferenceParameter。
- クライアントが、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 インターフェースを介して関連付けるメカニズム。