WSDL ファイルからの Web サービスの作成
関連項目
2 つの会社が WSDL ファイルの形式で「契約」に合意する場合は、IDE を使用して WSDL ファイルを実装できます。WSDL ファイルは、交換されるデータとメッセージ、およびそれらのメッセージを送受信する方法を取り決めたものです。IDE では、WSDL ファイルを使用して Web サービスを実装できます。
ビジネス要件によっては、一組の XML スキーマファイルと WSDL ファイルの形態で、プラットフォームに依存しない Web サービス記述が求められることがあります。このプラットフォームに依存しない記述では、このあとの手順を使用して、実装ファイルを生成することができます。下記手順で使用する WSDL ファイルは、ディスクまたは URL のどちらでも提供できます。「WSDL ファイルの作成」で説明しているように、IDE を使用して、自分で WSDL ファイルを作成することもできます。
-
J2EE 1.4 Web サービスでは、WSDL ファイルでスキーマ、ほかの WSDL ファイル、またはその両方がローカルファイルシステムからインポートされる場合、インポートされるスキーマおよび WSDL ファイルが事前に WEB-INF/wsdl (または META-INF/wsdl) フォルダにコピーされていたときのみ、Web サービスが機能します。コピーされていない場合は、次の手順の最後で、Web サービスコンパイラがインポートされるファイルを検出できません。
Web サービスを WSDL ファイルから作成する
- 実装方法に応じて、次のいずれかを行います。
- 「プロジェクト」ウィンドウまたは「ファイル」ウィンドウで、プロジェクトノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。「Web サービス」フォルダで、「WSDL からの Web サービス」を選択します。
「新規 WSDL からの Web サービス」ウィザードが開きます。
- Web サービス名を入力し、その Web サービスを格納するパッケージを指定します。
- ファイルシステム上の WSDL ファイルを選択します。
- 「完了」をクリックします。
JAX-WS Web サービス (Java EE 5 仕様) では、IDE が wsimport ツールを実行し、次のようになります。
- WSDL ファイルが IDE から利用および作成されます。抽象部分は元のファイルからそのままコピーされ、具象部分は元のファイルから「正規化」されます。WSDL ファイルでの抽象定義と具象定義については、WSDL ファイルについてを参照してください。たとえば、WSDL ファイルに SOAP 結合要素がない場合はその要素が作成されます。また、抽象サービス要素が結合と互換性を持つよう作成されます。
- 実装クラス。WSDL ファイル内で検出されたオペレーションが、このクラスに追加されます。
JAX-RPC Web サービス (J2EE 1.4 仕様) では、IDE が wscompile ツールを実行し、次のようになります。
- 新しい WSDL ファイル。抽象部分は元のファイルからそのままコピーされ、具象部分は元のファイルから「正規化」されます。WSDL ファイルでの抽象定義と具象定義については、WSDL ファイルについてを参照してください。たとえば、WSDL ファイルに SOAP 結合要素がない場合はその要素が作成されます。また、サービス要素が結合と互換性を持つよう作成されます。
- サービスエンドポイントインタフェース (以下「インタフェース」) は、Web サービスのオペレーションを宣言します。IDE では、WSDL で定義された portType 要素の名前でインタフェースクラスが識別されます。IDE は、各 Web サービスオペレーションの宣言を、WSDL ファイルから自動的にインタフェースに割り当てます。
- 実装クラス。WSDL ファイル内で検出されたオペレーションが、このクラスに追加されます。IDE では、ウィザードで指定した名前で JAX-WS クラスが識別されます。IDE では、WSDL で定義された portType 要素の名前と接尾辞「_Impl」(Web アプリケーションの場合) または「_Bean」(EJB モジュールの場合) の組み合わせによって、JAX-RPC 実装クラスが識別されます。
デフォルトでは、WSDL ファイルが WEB-INF/wsdl (または META-INF/wsdl) フォルダに格納されます。インタフェースと実装クラスは、プロジェクトの src フォルダ (「ファイル」ウィンドウ) 内のパッケージに格納され、「ソースパッケージ」ノード (「プロジェクト」ウィンドウ) からアクセスできます。
- WSDL ファイルから作成された Web サービスにオペレーションを追加することはできません。
- 関連項目
- Web サービスについて
- Web サービスの実装について
- Java からの Web サービスの作成
- WSDL ファイルの作成
著作権と商標について