8.2.4 Javaソースの生成
作成したWSDLファイルを基に,Webサービスの開発や実行に必要なJavaソース(Webサービス実装クラスのスケルトン,SEI,およびJava Bean(スタブ))を生成します。Javaソースは,Eclipseから生成できます。Javaソースを生成する手順を次に示します。
-
[プロジェクト・エクスプローラー]ビューで,Webサービスの開発に使用するプロジェクトを選択します。
POJOのWebサービスを開発する場合は動的Webプロジェクトを,EJBのWebサービスを開発する場合はEJBプロジェクトを選択します。
-
Eclipseのメニューから[ファイル]−[新規]−[その他]を選択します。
-
[Cosminexus Web サービス]−[Web サービス (WSDL 起点)]を選択して,[次へ]ボタンをクリックします。
[Web サービス (WSDL 起点)]ダイアログの[Web サービス (WSDL 起点)]ページが表示されます。
- 注意事項
-
[プロジェクト・エクスプローラー]ビューなどの選択状態によっては,[Web サービス (WSDL 起点)]ダイアログを表示した場合に,[プロジェクト]が空の状態に関わらず,[終了]ボタンが活性化していることがあります。[終了]ボタンをクリックすると,EclipseのAPIの挙動により,エラーダイアログとエラーログにInvocationTargetException,およびNullPointerExceptionが出力されることがあります。この場合,[プロジェクト],および,[Java ソース・フォルダー]を指定すると,処理を続行できます。
-
次の項目を指定します。
項目名
指定値
プロジェクト
ワークスペースの動的Webプロジェクト名またはEJBプロジェクト名を選択します。
WSDL ファイル
WSDLファイル,またはWSDLファイルのURLを指定します。
Java ソース・フォルダー
Javaソースを生成するフォルダを指定します。
次に示す設定をした場合,[Web サービス (WSDL 起点)]ダイアログを表示すると,[Java ソース・フォルダー]が空欄となり,以降の操作ができなくなります。そのため,[Java ソース・フォルダー]には,プロジェクトルート以外を設定してください。
-
Webサービスの開発に使用するプロジェクトの[プロパティ]ダイアログの[Java のビルド・パス]ページで,[ソース]タブの[ビルド・パス上のソース・フォルダ]にプロジェクトルートを設定した場合
また,[プロジェクト]および[Java ソース・フォルダー]に入力した値を変更すると,次に示す項目の値が初期状態に戻ります。
-
[プロジェクト]の値を変更した場合
[WSDL ファイル],[Java ソース・フォルダー],[Java パッケージ],および[バインディング・ファイル]の値が初期状態に戻ります。
-
[Java ソース・フォルダー]の値を変更した場合
[WSDL ファイル],[Java パッケージ],および[バインディング・ファイル]の値が初期状態に戻ります。
なお,必要に応じて,次の項目を指定してください。
項目名
指定値
Java パッケージ
生成するJavaソースのパッケージ名を指定します。
バインディング・ファイル
バインディングファイルを指定します。
各項目の詳細については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1.1 cjwsimportコマンド」も合わせて参照してください。
-
-
[終了]ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され,Javaソースが生成されます。
- 注意事項
-
Webサービスのバージョンアップなどの理由で,WSDLファイルやバインディングファイルを修正して,[Web サービス (WSDL 起点)]ダイアログでJavaソースを再生成する場合,必ず[Java ソース・フォルダー]に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。
出力ファイルと同名のファイルがある場合,上書きされたり,エラーになったりします。エラーが発生してファイルが出力された場合は,[Web サービス (WSDL 起点)]ダイアログでJavaソースを再生成する前にも同様に[Java ソース・フォルダー]に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。
-
指定するフォルダに出力ファイルと同名のSEIまたはJava Bean(スタブ)がある場合,上書きされます。
-
指定するフォルダに出力ファイルと同名のWebサービス実装クラスのスケルトンがある場合,[コンソール]ビューに警告を示すメッセージが表示され,Webサービス実装クラスのスケルトンは生成されません。そのため,プロジェクト内のWebサービス実装クラスと,SEIおよびJava Beanとの整合性が取れなくなり,Webサービスを正しく実行できないおそれがあります。Webサービス実装クラスと,SEIおよびJava Beanの整合性を取るためには,次に示すどちらかの処理をする必要があります。
・ファイルを出力するフォルダを空にして,[Web サービス (WSDL 起点)]ダイアログを再度実行し,Webサービス実装クラスのスケルトンを生成する。
・旧バージョンのWebサービス実装クラスをバックアップ後,ファイルを出力するフォルダを空にして,[Web サービス (WSDL 起点)]ダイアログを再度実行し,新バージョンのWebサービス実装クラスのスケルトンを生成する。
生成された新バージョンのWebサービス実装クラスのスケルトンの実装に,旧バージョンのWebサービス実装クラスの実装内容が利用できる場合は,新バージョンのWebサービス実装クラスのスケルトンに,バックアップした旧バージョンのWebサービス実装クラスの実装部分,および新バージョンの実装を追加する。
-