Web サービス・クライアント・バインディングの構成

Web サービス・アプリケーションが WebSphere® Application Server にデプロイされると、各アプリケーションまたはモジュールにインスタンスが作成されます。インスタンスには、 Web モジュールまたは Enterprise JavaBeans (EJB) モジュールのデプロイメント情報 (クライアント・バインディングなど) が含まれています。

始める前に

Web サービスを WebSphere Application Server インスタンスにデプロイしてください。アプリケーション・サーバーへの Web サービス・アプリケーションのデプロイに関する説明を参照してください。

Web サービス・サーバーの URL エンドポイント・アドレスのトポロジー、 およびクライアントが依存している Web サービスを把握する必要があります。 管理コンソールでデプロイメント記述子を表示してトポロジー情報を見つけることができます。 詳しくは、Web サービス・サーバーのデプロイメント記述子の表示についての説明を参照してください。

このタスクについて

クライアント・バインディングは、 Web サービス記述言語 (WSDL) ファイル名および優先ポートを定義します。 モジュールでの Web サービスの相対パスは、 要求に使用される実際の URL を含む互換 WSDL ファイル内で指定されます。 このアドレスが必要なのは、 オリジナルの WSDL ファイルに URL が含まれていなかった場合、あるいは別のアドレスが必要な場合のみです。 複数ポートを持つサービス・エンドポイントの場合は、 代替 WSDL ファイル名を定義する必要があります。

以下のステップでは、サーバーにデプロイされた Web サービスのバインディングの編集方法について説明します。ある Web サービスが別の Web サービスと通信する場合、 ダウンストリームの Web サービスにアクセスするには、クライアントのバインディングを構成する必要があります。

[AIX Solaris HP-UX Linux Windows][z/OS]wsadmin ツールを使用してクライアント・バインディングを構成することもできます。 wsadmin ツールを使用した Web サービス・クライアント・デプロイ済み WSDL ファイル名の構成についての説明を参照してください。

管理コンソールでクライアント・バインディングを構成するには、以下のようにします。

手順

  1. 管理コンソールを開きます。
  2. アプリケーション」>「エンタープライズ・アプリケーション」>「application_instance」>「 モジュールの管理」>「module_instance」>「Web サービス・クライアント・バインディング」をクリックします。
  3. 更新する Web サービスを検索します。

    Web サービスは、「Web サービス」フィールドにリストされます。

  4. 「WSDL file name」フィールドのドロップダウン・ボックスから WSDL ファイル名を選択します。
  5. 「Preferred port mappings」フィールドで「編集」をクリックし、 使用するデフォルトのポートを構成します。
    1. 「ポート・タイプ」および「Preferred ports」フィールドで、ポート・タイプおよび優先ポートを指定します。

      優先ポートを構成すると、最適のポート実装を選択して、 非 SOAP プロトコルを使用することができます。 非 SOAP プロトコルの使用について詳しくは、JAX-RPC を使用した RMI-IIOP Web サービスについての説明を参照してください。

    2. 適用」と「OK」をクリックします。
  6. 「Port information」フィールドの「編集」をクリックして、 ポートの要求タイムアウト、オーバーライド・エンドポイント、および オーバーライド・バインディング名前空間を構成します。

    要求タイムアウトを構成すると、 複数のホップや稼働時間の長いサービスを伴う複数のカスケード Web サービスを備えた複雑なトポロジーに対応できます。

    タイムアウト値は、 統合の進行に合わせて監視されるシステム全体の動作を基にして構成することができます。 例えば、ネットワーク条件または外部 Web サービスのパフォーマンスの変化が原因で、 Web サービス・クライアントがタイムアウトになる場合があります。 タイムアウトになる Web サービス・クライアントを含むアプリケーションがある場合は、 そのクライアントの要求タイムアウト値を変更することができます。

    エンドポイント URL を指定して、現行のエンドポイントをオーバーライドすることができます。 このポート上で要求を呼び出しているクライアントは、 WSDL ファイルで指定されたエンドポイントではなく、このエンドポイントを使用します。Java™ API for XML-Based Web Services (JAX-WS) クライアントと Java API for XML-based RPC (JAX-RPC) クライアントの両方で、「オーバーライドされたエンドポイント URL」値を指定できます。

    サポートされる構成 サポートされる構成:オーバーライドされたエンドポイント URL」フィールドは、JAX-WS クライアントと JAX-RPC クライアントの両方に適用できます。 この管理コンソール・ページにあるその他のフィールドは、JAX-RPC クライアントにのみ適用されます。 sptcfg
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): オーバーライドされたエンドポイント URL 設定は、更新操作でモジュールまたはアプリケーションが置換されると保持されません。gotcha
    1. 適用」と「OK」をクリックします。

タスクの結果

Web サービスのクライアント・バインディングが構成されます。

次のタスク

これで、その他の構成を完了したり、アプリケーションを開始または再始動したり、Web サービスの期待される動作を確認したりすることができます。

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_clientbindings
ファイル名:twbs_clientbindings.html