Apdesigner プログラマーズガイド |
目次 索引 |
第2部 アプリケーション開発編 | > 第4章 Webサービスアプリケーションを開発する | > 4.2 開発の流れ |
ここでは、Webサービスアプリケーションを作成する手順として、プロジェクトの作成からWARファイルの作成までをApdesignerの使い方を中心に説明します。
Webサービスを作成する場合には、Webアプリケーションプロジェクトを作成します。
Apdesignerのメニューから[ファイル] > [新規] > [プロジェクト]を選択し、[新規プロジェクト]ダイアログボックスから[J2EE] > [Webアプリケーションプロジェクト]を選択します。
プロジェクトウィザードでは、プロジェクト名、フォルダ、Javaのビルドパスなどを指定します。Webサービスのみを作成する場合、プロジェクト作成直後にウィザードは使用しないため、コード生成ウィザード選択画面では、[コード生成は行わない]を選択します。
プロジェクトが作成されると、パースペクティブがJ2EEパースペクティブに切り替わります。
J2EEパースペクティブでは、[IJServer]ビューによるInterstage Application Serverの操作が行え、Webサービスアプリケーションのデバッグなどを行うのに便利です。また、Webサービスアプリケーション作成時に頻繁に使うウィザードをメニューから直接起動することができます。
Webアプリケーションプロジェクトウィザードでは、Webサービスアプリケーションを開発するのに必須なビルドパスがデフォルトで設定されています。
Webサービスとして公開するサービスのインタフェースをJavaで作成します。
サービスエンドポイントインタフェースの作成は、新規Javaインタフェースウィザードを使用すると便利です。J2EEパースペクティブの場合、メニューから[ファイル] > [新規] > [インタフェース]を選択することで、新規Javaインタフェースウィザードが起動します。
サービスエンドポイントインタフェースは、以下を満たす必要があります。
メソッドを定義する場合には、使用可能なデータ型の範囲で行うようにしてください。使用可能なデータ型の詳細については、"サービスエンドポイントインタフェースに関する規則について"を参照してください。
Webサービス開発支援ウィザードにより、サービスエンドポイントインタフェースからWebサービスアプリケーションに必要なファイルを生成することができます。
Webサービス開発支援ウィザードを使用するには、Interstage Application Server機能もしくはInterstage Application Serverクライアントパッケージをインストールしておく必要があります。
Webサービス開発支援ウィザードは、以下の手順で起動します。
J2EEパースペクティブから操作する場合:
その他のパースペクティブから操作する場合:
Webサービス開発支援ウィザードでは、クラスファイル(.class)を解析して情報取得を行うため、ウィザードを起動する前にサービスエンドポイントインタフェースのコンパイルが行われている必要があります。
Apdesignerの初期状態では、ファイルの保存時に自動的にビルドが行われるようにオプションが設定されています。その場合、サービスエンドポイントインタフェースの保存が行われ、コンパイルエラーが発生していなければ問題ありません。
Webサービス開発支援ウィザードの詳細については、ウィザードのヘルプを参照してください。
以下にWebサービス開発支援ウィザードで生成されるファイルを示します。
生成ファイル |
ファイル名 |
内容 |
---|---|---|
Webサービスエンドポイント |
<サービスエンドポイントインタフェース名> SOAPBindingImpl.java |
サービスエンドポイントインタフェースの実装クラスです。このクラスにWebサービスの実装を記述します。 ウィザードで指定したパッケージ、名前でソースフォルダ配下に生成されます。 |
WSDLファイル |
<サービスエンドポイントインタフェース名>.wsdl |
Webサービスのインタフェース定義ファイルです。 ContextRoot配下に生成されます。 |
deployment descriptor |
webservices.xml |
Webサービスに関する配備情報が記述されているファイルです。 |
web.xml |
WARファイルの配備情報が記述されているファイルです。 |
|
その他のファイル |
<WSDLファイル名>_mapping.xml |
Webサービスの実行に必要な自動生成ファイルです。 ContextRoot/WEB-INF/wsdl配下に生成されます。 |
ファイル生成時のJava型からWSDLのXML型への変換規則については、"Interstage Application Server J2EEユーザーズガイド"を参照してください。
Webサービスアプリケーションを実装します。ウィザードで生成されたWebサービスエンドポイントにWebサービスの実装コードを記述します。
その他の生成されたファイルは、通常は編集する必要はありませんが、編集する場合は、ファイルの内容を理解した上で修正を行ってください。各ファイルの詳細は、"Interstage Application Server J2EEユーザーズガイド"を参照してください。
サービスエンドポイントインタフェースでHolderクラスを使用している場合、そのパラメタはinout型として扱われます。パラメタをout型にしたい場合には、WSDLファイルを編集する必要があります。
Webサービスは、WARファイルにアーカイブして配備します。
Apdesignerの初期状態では、ファイルの保存時に自動的にビルドが行われるようにオプションが設定されており、Webアプリケーションプロジェクトではビルド時にWARファイルを作成するようにビルドツールが設定されています。
自動的にビルドを行わないようにオプションを変更している場合には、手動でビルドを行ってください。
手動でビルドを行うには以下の方法があります。
目次 索引 |