HTTP を使用した JAX-WS アプリケーション向け Web サービス要求のトランスポート

Web サービスとして使用できる JavaBeans オブジェクトが既にある場合は、HTTP アクセス可能 Java™ API for XML-Based Web Services (JAX-WS) Web サービスを開発できます。

始める前に

Web サービスとして使用可能にする対象となる、アノテーションを付けた JAX-WS JavaBeans オブジェクトが必要です。オプションとして、wsgen コマンドを実行して、アノテーションを付けた JAX-WS JavaBeans コンポーネントから Web サービス記述言語 (WSDL) ファイルを作成できます。WSDL ファイルを作成するには、wsgen コマンドに -wsdl オプションを指定する必要があります。

以下に例を示します。 [Windows]
app_server_root/bin wsgen.bat  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[AIX][HP-UX][Linux][Solaris]
app_server_root/bin wsgen.sh  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[IBM i]
app_server_root/bin wsgen  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
サポートされる構成 サポートされる構成: wsimportwsgenschemagen、および xjc コマンド行ツールは、z/OS® プラットフォームではサポートされていません。この機能は、z/OS プラットフォームで稼働する WebSphere® Application Server で提供されるアセンブリー・ツールによって提供されます。 これらのツールについての詳細は、JAX-WS アプリケーションのこれらのコマンド行ツールに関する説明を参照してください。sptcfg

アノテーションを使用した JAX-WS Web サービスの開発については、JavaBeans を使用した JAX-WS アプリケーション向け Java 成果物の開発に関する説明を参照してください。

このタスクについて

アプリケーション・サーバーは、Web サービス・クライアント要求のトランスポートに HTTP を使用することをサポートします。HTTP によって、Web サービス・クライアントおよびサーバーは SOAP メッセージを介して通信することができます。SOAP は、Web サービスで使用される基本通信プロトコルであり、Web Services for Java Platform, Enterprise Edition (Java EE)、および Java API for XML-Based Web Services (JAX-WS) の仕様をサポートします。

HTTP は 最も一般的に使用される Web サービスのトランスポートです。

手順

  1. HTTP バインディングと SOAP アドレスを WSDL ファイルに追加します。

    HTTP トランスポート上でアクセス可能な、Web サービスの WSDL ファイルには、HTTP バインディングと、HTTP エンドポイントの URL ストリングを指定する SOAP アドレスが含まれている必要があります。HTTP バインディングは wsdl:binding エレメントで、 このエレメントには、トランスポート属性が soap/http で終わる soap:binding エレメントが含まれています。

    HTTP バインディングに加えて、HTTP バインディングを参照する wsdl:port エレメントが、 WSDL ファイル内の wsdl:service エレメントに含まれている必要があります。wsdl:port エレメントには soap:address エレメントが含まれていて、soap:address エレメントのロケーション属性で HTTP エンドポイントの URL ストリングが指定されています。

    Web サービスの開発時に、エンドポイント URL ストリングとして file:unspecified_location などのプレースホルダーを使用することができます。

    注: JAX-WS JavaBeans コンポーネントを、WSDL ファイルなしで Web サービスとしてデプロイする場合は、そのコンポーネント用の WSDL ファイルが自動的に生成されます。
  2. JAX-WS Web サービス・アプリケーションには、HTTP トランスポート構成は必要ありません。HTTP トランスポート設定は、アプリケーション・サーバーによって動的に生成されます。 Web アプリケーション・アーカイブ (WAR) ファイルが必要とするのは、JavaBeans オブジェクトとオプションの WSDL ファイルが適正にインストールされていることのみです。
  3. Web サービス・アプリケーションをデプロイします
  4. HTTP トランスポートのセキュリティーを構成します。

    セキュア HTTP トランスポートを構成するには、 SSLTransport ポリシーをアプリケーションに関連付けます。 基本認証のトランスポート・トークンを指定するには、 管理コンソールを使用して HTTPTransport バインディングでユーザー ID 属性とパスワード属性を設定します。

  5. (オプション) HTTP セッション管理を構成します。

    HTTP セッション管理により、アプリケーション・ユーザーから JAX-WS Web サービス・アプリケーションが動的に見えるようにすることができます。

  6. (オプション) 非同期応答リスナーを、 JAX-WS クライアント用に構成します。

    Thin Client for JAX-WS およびアプリケーション・クライアント環境内で非同期応答リスナーを使用して、 非同期に呼び出される要求に対する応答を受信できます。

  7. HTTP バインディングのエンドポイント URL 情報を構成します

    WSDL パブリッシャーは、この部分的な URL ストリングを使用して、 エンタープライズ・アーカイブ (EAR) ファイルで定義されている各ポート・コンポーネントの実際の HTTP URL を生成します。 公開された WSDL ファイルは、Web サービスの呼び出しを必要とするクライアントで使用できます。

タスクの結果

JAX-WS Web サービス・クライアント要求のトランスポートに HTTP を使用する JavaBeans オブジェクトの準備ができました。

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_httptransportjaxws
ファイル名:twbs_httptransportjaxws.html