JAX-RPC を使用した暗黙の SOAP ヘッダーの受信
既存の Java™ API for XML-based RPC (JAX-RPC) Web サービス・クライアントで暗黙の SOAP ヘッダー内から値を取得できます。暗黙の SOAP ヘッダーを受信するためにクライアント・コードを変更すると、着信 Web サービス応答内の固有の情報を受信できます。
始める前に
このタスクを完了するには、暗黙の SOAP ヘッダーを受信するために使用可能にできる Web サービス・クライアントが必要となります。
暗黙の SOAP ヘッダー は、以下の説明の 1 つに適合する SOAP ヘッダーです。
- Web Services Description Language (WSDL) ファイルのバインディング内の SOAP ヘッダーとして宣言されているメッセージ・パーツ。ただし、メッセージ定義は WSDL ファイル内の portType エレメントによって参照されていない。
- WSDL ファイルに含まれていないエレメント。
ハンドラーおよびサービス・エンドポイントは、SOAP with Attachments API for Java (SAAJ) データ・モデルを使用して、暗黙的または明示的な SOAP ヘッダーを取り扱うことができます。
protected の SOAP ヘッダーを取り扱うことはできません。 その所有コンポーネント (例えば、Web Services Security) によって protected に宣言されている SOAP ヘッダーは、クライアント・アプリケーションからはアクセスできません。 protected の SOAP ヘッダーを操作しようとすると、例外が発生します。
このタスクについて
クライアント・アプリケーションは、プロパティーを Stub または Call オブジェクトに設定して、暗黙の SOAP ヘッダーを送受信します。
手順
タスクの結果
JAX-RPC Web サービス・クライアントで、暗黙の SOAP ヘッダーから値を受信できるようになりました。