9.1 開発例の構成（プロバイダ起点・SAAJ）
この章で説明する開発例では，Dispatch／ProviderでSOAPメッセージを送受信するWebサービスを，SAAJを利用して開発します。
なお，ここでの例ではWebサービスクライアントから社員番号と社員の顔写真の情報が送信され，Webサービスが受信した情報を登録し，登録確認メッセージを返却するものとします。社員番号と登録確認メッセージのJavaデータ型はjava.lang.String，顔写真のJavaデータ型はjavax.activation.DataHandlerです。
開発するWebサービスの構成を次の表に示します。
|
項番 |
項目 |
値 |
|
|---|---|---|---|
|
1 |
デプロイするJ2EEサーバの名称 |
jaxwsserver |
|
|
2 |
Webサーバのホスト名とポート番号 |
webhost:8085 |
|
|
3 |
ネーミングサーバのURL |
corbaname::testserver:900 |
|
|
4 |
コンテキストルート |
dispatch_provider |
|
|
5 |
名前空間URI |
http://sample.com |
|
|
6 |
サービス |
個数 |
1 |
|
7 |
ローカル名 |
UserInfoService |
|
|
8 |
ポート |
個数 |
1 |
|
9 |
ローカル名 |
UserInfoPort |
|
Webサービス開発時のカレントディレクトリの構成を次の表に示します。
|
ディレクトリ |
説明 |
|||
|---|---|---|---|---|
|
c:\temp\jaxws\works\dispatch_provider |
カレントディレクトリです。 |
|||
|
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
server\ |
Webサービスの開発で使用します。 |
||
|
┣ ┃ ┃ ┃ ┃ |
META-INF\ |
EARファイルのMETA-INFディレクトリに対応します。 |
||
|
┗ |
application.xml |
「9.3.4 application.xmlを作成する」で作成します。 |
||
|
┣ ┃ |
src\ |
Webサービスのソースファイル（*.java）を格納します。「9.3.1 プロバイダ実装クラスを作成する」で使用します。 |
||
|
┣ ┃ ┃ ┃ ┃ ┃ |
WEB-INF\ |
WARファイルのWEB-INFディレクトリに対応します。 |
||
|
┣ |
web.xml |
「9.3.3 web.xmlを作成する」で作成します。 |
||
|
┗ |
classes\ |
コンパイルしたクラスファイル（*.class）を格納します。「9.3.2 Javaソースを生成する」で使用します。 |
||
|
┣ |
dispatch_provider.ear |
「9.3.5 EARファイルを作成する」で作成します。 |
||
|
┗ |
dispatch_provider.war |
|||
|
┗ |
client\ |
Webサービスクライアントの開発で使用します。 |
||
|
┣ ┃ ┃ |
src\ |
Webサービスクライアントのソースファイル（*.java）を格納します。「9.5.1 Webサービスクライアントの実装クラスを作成する」で作成します。 |
||
|
┣ ┃ ┃ |
classes\ |
コンパイルしたクラスファイル（*.class）を格納します。「9.5.2 Webサービスクライアントの実装クラスをコンパイルする」で作成します。 |
||
|
┣ ┃ |
usrconf.cfg |
「9.6.1 Javaアプリケーション用オプション定義ファイルを作成する」で作成します。 |
||
|
┗ |
usrconf.properties |
「9.6.2 Javaアプリケーション用ユーザプロパティファイルを作成する」で作成します。 |
||
カレントディレクトリのパスは，開発する環境に合わせて変更してください。
なお，以降の説明では，この表に示すディレクトリおよびファイル名を使用します。コマンド実行例やJavaソースなどで背景色付きの太字になっている部分は，この例で使用する指定値や生成される値を示します。構築する環境に合わせて読み替えてください。
また，この章で説明する開発例では，WebサービスとWebサービスクライアントを同じ環境で開発しますが，別の環境で開発することもできます。別の環境で開発する場合は，それぞれの環境に合わせて，カレントディレクトリのパスを読み替えてください。