Web サービスをデプロイする前に、デプロイの詳細を理解しておく必要があります。
Java EE に準拠するアプリケーション・サーバー
Java™ EE に準拠するアプリケーション・サーバーの場合、Web サービスは Web アーカイブ (WAR) ファイルにデプロイされ、次の URI パターンが使用されます。
http://domain:portNumber/contextRoot/serviceConstant/serviceName
- domain:portNumber
- domain の値は、プロジェクトのデプロイ先サーバーの IP アドレスです。コロン (:) とその後に続く portNumber の値は、アプリケーション・サーバー構成で指定されるポートです。
IBM® WebSphere® Application Server を使用している場合、この値はデフォルトでは localhost:9080 になります。ただし、インストールされているこの製品が別のポートにアクセスすることがあります。これは、同じマシンに WebSphere Application Server を以前にインストールしていた場合に発生することがあります。
SOAP サービスを使用して生成された WSDL ファイルに記述されているドメインとポート番号を変更するには『サービス生成の設定』を参照してください。
- contextRoot
- サービスがデプロイされるコンテキスト・ルート。
デフォルトでは、この値はプロジェクト名です。
デフォルトをオーバーライドするには、次のようにします。
- プロジェクトを右クリックします。
- 「プロパティー (Properties)」をクリックして「プロパティー」ページを表示します。
- 「Web プロジェクトの設定」をクリックして新規コンテキスト・ルートを入力します。
- 「OK」をクリックします。
- serviceConstant
- 2 つの値のいずれか
- SOAP サービス: services
- EGL REST-RPC サービス:restservices
- serviceName
- SOAP サービスの場合、serviceName は @xml 複合プロパティーの name フィールドの値です。デフォルトでは、このフィールドの値は、alias プロパティーの名前ではなく、サービス・パーツ名です。
REST サービスの場合、
serviceName は、デプロイメント記述子エディターの
「Web サービス・デプロイメント」タブの
「URI」テキスト・ボックスの値です。このテキスト・ボックスが空の場合、値は次の要素を連結したものになります。
- パッケージ名 (ピリオドの代わりにアンダースコアー (_) を使用)
- アンダースコアー (_)
- サービス名
CICS サーバー
CICS® サーバーの場合、Web サービスは、デプロイメント記述子に指定されている CICS トランザクションにデプロイされます。
デフォルト URI は、Java EE 準拠のアプリケーション・サーバーに指定されている URI と同じです。ただし、デプロイメント記述子エディターの
「Web サービス・デプロイメント」タブの
「CICS URI」テキスト・ボックスに値を指定する場合、次に示す URI パターンが使用されます。このパターンの 1 番目の構成要素と 2 番目の構成要素の間にはスペースはありません。
http://domain:portNumberURIvalue
- domain:portNumber
- domain の値は、プロジェクトのデプロイ先サーバーの IP アドレスです。コロン (:) とその後に続く portNumber の値は、CICS サーバー構成で指定されているポートです。
SOAP サービスを使用して生成された WSDL ファイルに記述されているドメインとポート番号を変更するには『サービス生成の設定』を参照してください。
- URIvalue
- デプロイメント記述子エディターの「Web サービス・デプロイメント」タブの「CICS URI」テキスト・ボックスに指定する値です。