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