Web サービスクライアントの作成
関連項目
Web アプリケーション、Java アプリケーション、または MIDP クライアント (MIDlet) から Web サービスを利用することができます。MIDlet からの Web サービスの利用については、J2ME Mobility のマニュアルを参照してください。
JAX-WS クライアントでは、インポートされたすべての WSDL ファイルおよびスキーマは IDE によって自動的に解決されます。JAX-RPC クライアントでは、開始する前に、使用する WSDL ファイルが、スキーマか、ほかの WSDL ファイル、またはその両方をローカルファイルシステムからインポートする場合、そのインポートされたスキーマおよび WSDL ファイルが WEB-INF/wsdl (または META-INF/wsdl) フォルダに事前にコピーされていないと、Web サービスクライアントしか機能しません。コピーされていない場合は、次の手順の最後で、Web サービスコンパイラがインポートされるファイルを検出できません。
Web サービスクライアントを作成する
- Web サービスクライアントを含めるプロジェクトを作成します。Web サービスの利用方法に従って、次のいずれかを行います。
- 「プロジェクト」ウィンドウまたは「ファイル」ウィンドウでプロジェクト内のノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。「新規ファイル」ウィザードが表示さます。「カテゴリ」から「Web サービス」を選択します。「ファイルの種類」から「Web サービスクライアント」を選択します。「次へ」をクリックします。
- Web サービスクライアントが利用する Web サービスの WSDL ファイルにアクセスします。プロバイダの配布方法によって、次のようにします。
- ローカルファイルシステムのプロジェクトからクライアントを作成するには、「プロジェクト」をクリックし、プロジェクトの Web サービスポートのアイコンへ移動します。
- ローカルファイルシステム上の WSDL ファイルからクライアントを生成する場合は、「ローカルファイル」をクリックし、ローカルファイルシステム上の WSDL ファイルへ移動します。
- 実行中の Web サービスからクライアントを生成する場合は、WSDL URL をクリックしてから Web サービスの URL を入力またはペーストします。ファイアウォールで保護されている場合は、「プロキシ設定」をクリックし、プロキシホストおよびポート番号を設定します。
- WSDL ファイルは、ウィザードが終了したときにダウンロードされます。
- クライアントファイルの生成先のパッケージを指定します。ウィザードの手順を完了したら、「ファイル」ウィンドウで、build フォルダ内にクライアントファイルが生成されていることを確認します。「プロジェクト」ウィンドウでの Web サービスクライアントの表示 を参照してください。
- JAX-RPC (J2EE 1.4) クライアントでは、「クライアントの種類」ドロップダウンから Web サービスクライアントの種類を選択します。
- J2EE コンテナ生成の静的スタブ。JSR-101 を拡張した JSR-109 に基づき、新しい配備記述子を含む標準 J2EE モジュールへの Web サービスのパッケージ化が定義され、セッション Bean またはサーブレットとして実装される Web サービスが定義されます。推奨する、移植性の高い (J2EE 1.4 仕様による) 種類です。この種類を選択する場合は、IDE が配備情報を配備記述子に追加し、コンテナがスタブおよびその他のアーティファクトを生成します。
- IDE 生成の静的スタブ。JAX-WS (J2EE 1.4) Web サービスでのみ使用できます。このタイプは JAX-RPC に基づいています。JAX-RPC では、WSDL と Java 間のマッピングが定義されます。また、リモート Web サービスを呼び出すクライアント API、および Web サービスを運用するためのサーバー上の実行環境が定義されます。移植性はありません。この種類を選択する場合は、IDE がスタブおよびその他のアーティファクトを生成し、それをアーカイブにパッケージして配備します。
- Java アプリケーショから Web サービスを利用する場合、J2EE アプリケーションサーバーは使用されません。アプリケーションはスタンドアロンの JVM プロセスとして動作し、その JVM パラメータはプロジェクトごとに設定されます。このため、J2EE コンテナ生成の静的スタブは Java アプリケーションに適用されず、「クライアントの種類」ドロップダウンには現れません。
J2SE クライアントでは、「JAX バージョン」ドロップダウンを使用し、JAX-WS クライアントと JAX-RPC クライアントのどちらを作成するのかを指定します。
- 「完了」をクリックします。
- 関連項目
- Web サービスクライアントについて
- Web サービスについて
著作権と商標について