このトピックでは、アセンブリー・ツールによる ibm-webservicesclient-bnd.xmi デプロイメント記述子ファイル
の構成方法を説明します。
始める前に
WebSphere Application Server で提供されるアセンブリー・ツールを使用して、デプロイメント記述子を構成することができます。
アセンブリー・ツールを使用するには、まずそれを構成する必要があります。詳しくは、Application Server Toolkit 資料の
『Configuring WebSphere Application Server Toolkit』を参照してください。
このタスクについて
クライアント・モジュールのアセンブルが終了したので、次のステップを完了して、
ibm-webservicesclient-bnd.xmi デプロイメント記述子を構成します。WebSphere Application Server
が Web サービスの着信要求を
処理できるためには、デプロイメント記述子が必要です。
以下のステップに従って、
ibm-webservicesclient-bnd.xmi デプロイメント記述子ファイルを構成します。
プロシージャー
- アセンブリー・ツールを開始します。 詳しくは、
Application Server Toolkit 資料の『Starting WebSphere Application Server Toolkit』を
参照してください。Eclipse アセンブリー・ツール、Application Server Toolkit (AST)、Rational Web Developer には、
コード成果物を作成し、それらのコード成果物を各種アーカイブ (モジュール) にアセンブルし、関連する Java 2 Platform, Enterprise Edition (J2EE) バージョン 1.2、1.3、1.4 準拠の
デプロイメント記述子を構成するためのグラフィカル・インターフェースがあります。
- 「J2EE パースペクティブ」に切り替えます。
- 「ウィンドウ」>「パースペクティブのオープン」>「その他」>「J2EE」とクリックします。
- 「Project Explorer」を開きます。
- 「ウィンドウ」>「Show View」>「その他」>「Project
Explorer」とクリックします。
- モジュールのデプロイメント記述子ファイルを見付けます。 ヒント:
デプロイメント記述子: <module>
- デプロイメント記述子ファイルをダブルクリックして、
デプロイメント記述子エディターを開きます。
- エディター・ウィンドウの下部にある「WS Binding」タブを選択して、
Web Services Client Bindings エディターを開きます。
- serviceRefLink エレメント設定を確認します。
- 「Web Services Client Bindings」エディターを開きます。
- 「Services References」タブをクリックします。
- 「追加」をクリックします。
- リストから、クライアント・デプロイメント記述子ファイルに定義されているサービス参照を選択します。
- deployedWSDLFile エレメント設定を確認します。
- 「Web Services Client Bindings」エディターを開きます。
- サービス参照を選択します。
- 「Service Reference Details」セクションを展開します。
- 「Deployed WSDL file」フィールドの右にある「参照」をクリックします。
- 新規 Web Services Description Language (WSDL) ファイルを選択します。
- 「OK」をクリックします。
デプロイされた Web サービスの deployedWSDLFile エレメントを、
管理コンソールを使用して変更することもできます。「エンタープライズ・アプリケーション」>「application 」>「Web
モジュール」または「EJB モジュール」>「module」>「Web services client
bindings」とクリックします。
- defaultMappings エレメントの設定を確認します。
- 「Web services client bindings」エディターを開きます。
- 「Default mappings」をクリックします。
- 「追加」をクリックします。
- 新しく追加された行の項目を編集し、WSDL ファイルの「portType」
と「port」との間のマッピングを確立します。各 portType ごとに 1 つのエントリーのみが
サポートされます。
- 「OK」をクリックします。
デプロイされた Web サービスの defaultMappings エレメントを、
管理コンソールを使用して変更することもできます。「エンタープライズ・アプリケーション」>「application 」>「Web
モジュール」または「EJB モジュール」>「module」>「Web services client
bindings」とクリックします。
- エディター・ペインの下部にある「Port qualified name binding details」セクションから、
「Web services client Port bindings」エディターにアクセスします。
- syncTimeout エレメント設定を確認します。
- ポートに「ポート修飾名のバインディング」を作成します。
- 「Web services client bindings」エディターを開きます。
- 「Component-scoped references」セクションまたは「サービス参照」
セクションのいずれかで、サービス参照が選択されていることを確認します。
- 「Port qualified name binding」セクションを展開します。
- 「追加」をクリックします。「Add port qualified name binding」ダイアログが開きます。
- 「Port namespace link」フィールドに、構成の対象である WSDL ファイル・ポート
の namespace を入力します。
- 「Port local name link」フィールドに、構成の対象である WSDL ファイル・ポート
の local_name を入力します。「Port qualified name binding」リストに表示される名前は、
WSDL ファイル・ポートのローカル名です。
- 「OK」をクリックします。
- 「Synchronization timeout」フィールドを探し、
必要な値を入力して syncTimeout プロパティーを構成します。 デフォルトは 300 秒です。
- basicAuth エレメント設定を確認します。
- 「Port qualified name binding details」セクションで
「HTTP basic authentication」フィールドを探します。
- 「ユーザー ID」および「パスワード」フィールドに、必要な値を入力します。
- 「OK」をクリックします。
- sslConfig エレメント設定を確認します。
- 「Port qualified name binding details」セクションで
「SSL 構成」フィールドを探します。
- 「名前」フィールドに必要な値を入力します。
- 「OK」をクリックします。
- プロパティーの編集が完了したら、
キーボードで ctrl-s と入力して変更を保管します。
結果
ibm-webservicesclient-bnd.xmi デプロイメント記述子を構成しました。すべての
クライアント・デプロイメント記述子を構成したら、Web サービス・クライアントをテストします。すべての
クライアント・デプロイメント記述子をまだ構成していない場合は、
構成を完了してから、Web サービス・クライアントをテストします。