JAX-WS Web サービス・クライアントに対する拡張の実装
WebSphere® Application Server は、Java™ API for XML-based Web Services (JAX-WS) プログラミング・モデルを使用する Web サービス・クライアントに対する拡張を提供します。
このタスクについて
JAX-WS クライアント・プログラミング・モデルに対する次の拡張を使用して Web サービスをカスタマイズできます。
手順
- ディスパッチ・オブジェクトまたはプロキシー・オブジェクトの要求コンテキストで JAXWS_OUTBOUND_SOAP_HEADERS プロパティーおよび JAXWS_INBOUND_SOAP_HEADERS プロパティーを設定すると、JAX-WS Web サービス・クライアントが暗黙の SOAP ヘッダーを送信または検索できるようになります。 暗黙の SOAP ヘッダーとは、WSDL ファイルで明示的に定義されていない SOAP ヘッダーのことです。 暗黙の SOAP ヘッダー・ファイルは、以下の説明の 1 つに当てはまります。
- WSDL ファイルのバインディング内の SOAP ヘッダーとしてメッセージ・パーツが宣言されているが、メッセージ定義は、WSDL ファイル内の portType によって参照されていない。
- WSDL ファイルに含まれていないエレメント。
ハンドラーおよびサービス・エンドポイントは、SOAP with Attachments API for Java (SAAJ) データ・モデルを使用して、暗黙的または明示的な SOAP ヘッダーを取り扱うことができます。
トランスポート・ヘッダーの送信または検索のためのクライアント・コードの変更方法については、JAX-WS による暗黙の SOAP ヘッダーの送信または JAX-WS による暗黙の SOAP ヘッダーの受信に関する情報を参照してください。
- REQUEST_TRANSPORT_PROPERTIES プロパティーと RESPONSE_TRANSPORT_PROPERTIES プロパティーを設定すると、Web サービス・クライアントがトランスポート・ヘッダーを送信または検索できるようになります。
BindingProvider インスタンスでプロパティーを設定します。
トランスポート・ヘッダーを送信または検索するようにクライアント・コードを変更すると、サーバーからの発信要求または着信応答のトランスポート・ヘッダー内 にある特定の情報を送信または検索できます。HTTP トランスポートを使用する要求または応答の場合、HTTP ヘッダー内で情報が送信または検索されます。同様に、 Java Message Service (JMS) トランスポートを使用する要求または応答 の場合、JMS メッセージのプロパティー内で情報が送信または検索されます。
トランスポート・ヘッダーの送信または検索のためのクライアント・コードの変更方法については、JAX-WS によるトランスポート・ヘッダーの送信または JAX-WS によるトランスポート・ヘッダーの取得に関する情報を参照してください。
Web サービス・クライアントを使用可能にして、トランスポート・ヘッダーを送信または取得する方法について詳しくは、トランスポート・ヘッダー・プロパティーのベスト・プラクティスに関する情報を参照してください。
サブトピック
例: JAX-WS プロパティーを使用して JAX-WS ハンドラーの SOAP ヘッダーを操作する
WebSphere Application Server は、Java API for XML-Based Web Services (JAX-WS) に対する拡張を提供し、jaxws.binding.soap.headers.outbound プロパティーおよび jaxws.binding.soap.headers.inbound プロパティーを含む、Web Services for Java Platform, Enterprise Edition (Java EE) クライアント・プログラミング・モデルを提供します。 この例では、これらの 2 つのプロパティーを使用して JAX-WS ハンドラーの SOAP ヘッダーを操作する方法を示します。JAX-WS を使用した暗黙の SOAP ヘッダーの送信
既存の Java API for XML-Based Web Services (JAX-WS) Web サービス・クライアントで暗黙の SOAP ヘッダー内に値を送信できます。暗黙の SOAP ヘッダーを送信するためにクライアント・コードを変更すると、Web サービスの発信要求内にある特定の情報を送信できます。JAX-WS を使用した暗黙の SOAP ヘッダーの受信
既存の Java API for XML-Based Web Services (JAX-WS) Web サービス・クライアントで暗黙の SOAP ヘッダーから値を受信できます。暗黙の SOAP ヘッダーを受信するためにクライアント・コードを変更すると、着信 Web サービス応答内の固有の情報を受信できます。トランスポート・ヘッダー・プロパティーのベスト・プラクティス
Java API for XML-based RPC (JAX-RPC) クライアント・スタブ、Call インスタンス、または Java API for XML-Based Web services (JAX-WS) BindingProvider の RequestContext インスタンスで、REQUEST_TRANSPORT_PROPERTIES プロパティーおよび RESPONSE_TRANSPORT_PROPERTIES プロパティーを設定すると、Web サービス・クライアントでの トランスポート・ヘッダーの送信または取得が可能になります。JAX-WS によるトランスポート・ヘッダーの送信
既存の Java API for XML-Based Web Services (JAX-WS) Web サービス・クライアントを有効にすると、トランスポート・ヘッダーを使用して、Web サービス要求とともにアプリケーション定義情報を送信することができます。さらに、トランスポート・ヘッダーを使用して、JAX-WS Web サービス・エンドポイントが Web サービス応答メッセージとともにアプリケーション定義情報を送信できるようにします。JAX-WS を使用したトランスポート・ヘッダーの取得
Java API for XML-Based Web Services (JAX-WS) Web サービス・クライアントでトランスポート・ヘッダーから値を取得できます。HTTP を使用する要求の場合、トランスポート・ヘッダーは、HTTP 応答メッセージ で検出される HTTP ヘッダーから取得されます。Java Message Service (JMS) を使用する要求の場合、トランスポート・ヘッダーは、JMS 応答メッセージ で検出される JMS メッセージ・プロパティーから取得されます。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_extendpmjaxws
ファイル名:twbs_extendpmjaxws.html