JAX-RPC アプリケーションに対する Web サービス・アドレッシング・サポートの使用可能化
Web サービス・アドレッシング (WS-Addressing) サポートでは、Web サービスをアドレス指定するメカニズムを提供し、メッセージにアドレッシング情報を提供します。JAX-RPC アプリケーションに対して WS-Addressing サポートを使用可能にするには、WebSphere® Application Server 上で実行されるサービスの Web サービス記述言語 (WSDL) ファイルを構成するか、WS-Addressing アプリケーション・プログラミング・インターフェース (API) またはシステム・プログラミング・インターフェース (SPI) を使用して WS-Addressing プロパティーを WebSphere Application Server クライアントに追加します。
このタスクについて
このタスクを実行して、サービス・プロバイダーとして、または別の関係者によって提供されるサービスのクライアントとして、WS-Addressing サポートを有効にします。 このタスクではまた、WS-Addressing サポートを使用不可にする方法も説明します。これにより、WS-Addressing または WS-Addressing サポートに依存する任意のプロトコルを使用しないアプリケーションのパフォーマンスを向上させることができます。
Web サービスを作成する場合は、 サービスの開発時に、サービスの WSDL バインディング・エレメント内に UsingAddressing 拡張性エレメントを組み込むことで、WS-Addressing サポートを使用可能にできます。 このエレメントには required 属性が含まれています。この属性は false または true のいずれかの値を持ち、前者は WS-Addressing 情報が受け入れられるが着信メッセージ内では必要ではないことを指定し、後者は WS-Addressing 情報が着信メッセージ内で必要であることを指定します。 デフォルト値は false です。サービス WSDL ファイルに UsingAddressing エレメントが組み込まれている場合は、required 属性の値に関係なく、WebSphere Application Server のクライアントからのメッセージには常に WS-Addressing 情報が含まれています。
別のプロバイダーによるサービスを使用するクライアント・アプリケーションを作成する場合、ユーザーにはそのサービスの WSDL ファイルへのアクセス権がない可能性があります。 または (サービスがこの製品の現行バージョン上で実行されない場合は)、そのサービスが UsingAddressing エレメントをサポートしないバージョンの WSDL を使用している可能性があります。 ただし、実行時に、サービスとの通信に使用する JAX-RPC stub オブジェクトまたは call オブジェクトで WS-Addressing プロパティーを設定することにより、WS-Addressing サポートを使用可能に設定することもできます。
UsingAddressing required = "false" を指定するサービスの WSDL | を指定するサービスの WSDL | UsingAddressing を指定しないサービスの WSDL | |
---|---|---|---|
クライアントは、WS-Addressing 情報を含むメッセージを送信します。 | WS-Addressing 情報は製品によって処理されます。 | WS-Addressing 情報は製品によって処理されます。 | WS-Addressing 情報は製品によって処理されます。 |
非 WebSphere Application Server クライアントは、WS-Addressing 情報を含まないメッセージを送信します。 | メッセージは受け入れられます。 | サービスは「フォールト」を戻します。 | メッセージは受け入れられます。 |
WebSphere Application Server クライアントは、アドレッシング・プロパティーを指定しないで、メッセージを送信します。 | メッセージは自動的に、WS-Addressing 仕様での定義のとおり、必要な WS-Addressing 情報を含みます。 情報は製品によって処理されます。 | メッセージは自動的に、WS-Addressing 仕様での定義のとおり、必要な WS-Addressing 情報を含みます。 情報は製品によって処理されます。 | WS-Addressing 情報は追加されません。メッセージは受け入れられます。 |
手順
タスクの結果
これで、WS-Addressing プロパティーが SOAP メッセージ・ヘッダーに含まれ、メッセージを受信するとサーバーによって処理されるようになりました。