8.4.1 Javaアプリケーションを使用したWebサービスクライアントの開発
(1) Javaアプリケーションを使用したWebサービスクライアントの開発の流れ
Javaアプリケーションを使用したWebサービスクライアントの開発の流れを,次の図に示します。
図8-3 Javaアプリケーションを使用したWebサービスクライアントの開発の流れ
![[図データ]](figure/zu114000.gif)
それぞれの作業の概要を次に示します。
- Javaプロジェクトの作成
Webサービスクライアントの開発に使用するJavaプロジェクトを作成します。詳細は,「8.4.1(2) Javaプロジェクトの作成」を参照してください。
- WSDLファイルの取得
WSDLファイルを取得します。または,公開されているWSDLファイルのURLを取得します。詳細は,「8.4.1(3) WSDLファイルの取得」を参照してください。
- Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は,「8.4.1(4) Javaソースの生成」を参照してください。
- Webサービスクライアントの実装
生成されたJavaソースを利用して,Webサービスクライアントを実装します。詳細は,「8.4.1(5) Webサービスクライアントの実装」を参照してください。
- Javaアプリケーションのデバッグ
Javaアプリケーションをデバッグします。詳細は,「8.4.1(6) Javaアプリケーションのデバッグ」を参照してください。
以降,この流れに沿ってJavaアプリケーションを使用したWebサービスクライアントの開発の手順を説明します。
(2) Javaプロジェクトの作成
Javaアプリケーションを使用したWebサービスクライアントの開発に使用するJavaプロジェクトを作成します。Javaプロジェクトを作成する手順を次に示します。
- Eclipseのメニューから[ファイル]-[新規]-[プロジェクト]を選択します。
[新規プロジェクト]ダイアログが表示されます。
- [Java プロジェクト]を選択して,[次へ]ボタンをクリックします。
[Java プロジェクトの作成]ページが表示されます。
- 必要な項目を指定して,[終了]ボタンをクリックします。
Javaプロジェクトが作成されます。
なお,JAX-WSエンジンを使用し,JavaアプリケーションでWebサービスを実行するためには,プロジェクトのビルドパスに外部Jarを設定したり,Javaアプリケーションの実行構成,またはデバッグ構成にVM引数を設定したりする必要があります。それぞれの設定手順を次に示します。
- プロジェクトのビルドパスへの外部Jarの設定
- Javaプロジェクトを選択して,右クリックのコンテキストメニューから[ビルド・パス]-[ビルド・パスの構成]を選択します。
- [プロパティ]ダイアログの[Java のビルド・パス]ページの[ライブラリー]タブを選択します。
- [外部 Jar の追加]ボタンをクリックします。
- 次に示す外部Jarを追加します。
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxb.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmstax.jar
<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥j2ee-javax.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥HiEJBClientStatic.jar
Windows x86の場合(WOW64環境を含む)
<HNTRLibのインストールディレクトリ>※¥classes¥hntrlib2j.jar
<HNTRLibのインストールディレクトリ>※¥classes¥hntrlibMj.jar
Windows x64の場合
<HNTRLib2インストールディレクトリ>※¥classes¥hntrlib2j64.jar
<HNTRLib2インストールディレクトリ>※¥classes¥hntrlibMj64.jar
注※ <HNTRLibのインストールディレクトリ>,および<HNTRLib2インストールディレクトリ>の部分は環境変数COSMINEXUS_HNTRLIB_HOMEの値を指定します。
- Javaアプリケーションの実行構成またはデバッグ構成のVM引数の設定
- Eclipseのメニューから[実行]-[実行構成],または[実行]-[デバッグの構成]を選択します。
- [Java アプリケーション]をダブルクリックします。
- [メイン]タブの[プロジェクト]にJavaプロジェクトの名称を設定します。
- [メイン]タブの[メイン・クラス]にJavaプロジェクトを実行するメインクラスの完全修飾名を設定します。
- [引数]タブを選択して,次に示すVM引数を設定します。
-Dcosminexus.home="<Developerのインストールディレクトリ>"
(3) WSDLファイルの取得
呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。
(4) Javaソースの生成
取得したWSDLファイルを基に,Webサービスクライアントの開発や実行に必要なJavaソース(サービスクラス,SEI,およびJava Bean(スタブ))を生成します。Javaソースは,Eclipseを使って生成できます。Javaソースを生成する手順を次に示します。
- [プロジェクト・エクスプローラー]ビューで,Webサービスクライアントの開発に使用するプロジェクトを選択します。
- Eclipseのメニューから[ファイル]-[新規]-[その他]を選択します。
[新規]ダイアログが表示されます。
![[図データ]](figure/zu112100.gif)
- [Cosminexus Web サービス]-[Web サービス・クライアント]を選択して,[次へ]ボタンをクリックします。
[Web サービス・クライアント]ダイアログの[Web サービス・クライアント]ページが表示されます。
![[図データ]](figure/zu114100.gif)
- 次の項目を指定します。
項目名 | 指定値 |
---|
プロジェクト | ワークスペースのJavaプロジェクト名を選択します。 |
WSDL ファイル | WSDLファイル,またはWSDLファイルのURLを指定します。 |
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。 |
次に示す操作や設定をした場合,[Web サービス・クライアント]ダイアログを表示すると,[Java ソース・フォルダー]が空欄となり,以降の操作ができなくなります。そのため,[Java ソース・フォルダー]には,プロジェクトルート以外を設定してください。
- Webサービスクライアント開発にJavaプロジェクトを使用する際,Javaプロジェクト作成時に[新規 Java プロジェクト]ダイアログの[プロジェクト・レイアウト]に[プロジェクト・フォルダをソースおよびクラス・ファイルのルートとして使用]を選択した場合
- Webサービスクライアントの開発に使用するプロジェクトの[プロパティ]ダイアログの[Java のビルド・パス]ページで,[ソース]タブの[ビルド・パス上のソース・フォルダ]にプロジェクトルートを設定した場合
また,[プロジェクト]および[Java ソース・フォルダー]に入力した値を変更すると,次に示す項目の値が初期状態に戻ります。
- [プロジェクト]の値を変更した場合
[WSDL ファイル],[Java ソース・フォルダー],[Java パッケージ],[バインディング・ファイル],および[WSDL ロケーション]の値が初期状態に戻ります。
- [Java ソース・フォルダー]の値を変更した場合
[WSDL ファイル],[Java パッケージ],[バインディング・ファイル],および[WSDL ロケーション]の値が初期状態に戻ります。
なお,必要に応じて,次の項目を指定してください。
項目名 | 指定値 |
---|
Java パッケージ | 生成するJavaソースのパッケージ名を指定します。 |
バインディング・ファイル | バインディングファイルを指定します。 |
WSDL ロケーション | javax.xml.ws.WebServiceClientアノテーションの,wsdlLocation要素に設定する値を指定します。 |
各項目の詳細については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1 cjwsimportコマンド」も合わせて参照してください。
- [終了]ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され,Javaソースが生成されます。
- 注意
- Webサービスのバージョンアップなどの理由で,呼び出されるWebサービスのWSDLファイルやバインディングファイルが修正され,[Web サービス・クライアント]ダイアログでJavaソースを再生成する場合,必ず[Java ソース・フォルダー]に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。
- 出力ファイルと同名のサービスクラス,SEIまたはJava Bean(スタブ)がある場合,上書きされます。
(5) Webサービスクライアントの実装
生成されたJavaソースを利用して,Webサービスクライアントを実装します。Webサービスクライアントの実装例については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.6 Webサービスクライアントの実装」を参照してください。
(6) Javaアプリケーションのデバッグ
作成したJavaアプリケーションをデバッグします。Javaアプリケーションのデバッグ構成にVM引数を設定し,[デバッグ]ボタンをクリックします。Javaアプリケーションのデバッグ構成のVM引数の設定については,「8.4.1(2) Javaプロジェクトの作成」を参照してください。