HTTP バインディングのエンドポイント URL 情報の構成

サービス・エンドポイントの構成は、Java™ API for XML-Based Web Services (JAX-WS) クライアントおよび Java API for XML-based RPC (JAX-RPC) Web サービス・クライアントを、アセンブルされているコンポーネント間の任意の Web サービスまたは任意の外部 Web サービスに接続するために必要となります。

始める前に

Web サービスとして使用できる既存の JavaBean オブジェクトがある場合は、HTTP アクセス可能な Java API for XML-based remote procedure call (JAX-RPC) または Java API for XML Web Services (JAX-WS) Web サービスを開発することができます。詳しくは、HTTP を使用した Web サービス要求のトランスポートに関する情報を参照してください。

管理コンソールまたはプロパティー・ファイルのいずれかを使用して、 HTTP エンドポイント URL フラグメントを構成および管理することができます。プロパティー・ファイルを使用した URL フラグメントの設定および管理については、Web サービス・エンドポイント URL フラグメント・プロパティー・ファイルの使用についての情報を参照してください。

この タスクでは、HTTP バインディングのエンドポイント URL 情報を 管理コンソールを使用して構成する方法について説明します。

このタスクについて

HTTP を介してアクセスされる Web サービスに HTTP URL 接頭部を指定するには、 管理コンソールの「Provide HTTP endpoint URL information」パネルを使用します。HTTP URL 接頭部は、ロケーション固有情報を提供し、 公開される WSDL ファイルに組み込まれる完全エンドポイント URL を形成するために使用されます。

注: 管理コンソールの「HTTP を提供 (Provide HTTP)」パネルでは、Java API for XML-Based Web Services (JAX-WS) および Java API for XML-based RPC (JAX-RPC) Web サービスが含まれるモジュールが表示されます。 「HTTP の指定 (Provide HTTP)」パネルを使用して、両タイプの Web サービスに URL 情報を提供することができます。ただし、パネルには処理しているサービスのタイプは示されません。
管理コンソールでこれらの接頭部を構成するには、以下のようにします。

手順

  1. 管理コンソールを開きます。
  2. アプリケーション」>「エンタープライズ・アプリケーション」>「application_instance」>「HTTP エンドポイント URL 情報の指定」をクリックします。
  3. Web サービスの URL 接頭部を指定します。

    このステップで、 エンドポイント URL で使用されるプロトコル (HTTP または HTTPS)、host_name、および port_number を指定します。 デフォルトの HTTP URL 接頭部を選択して、事前定義されたリストから接頭部を選択することができます。 または、カスタム HTTP URL 接頭部を使用することができます。

    1. Default HTTP URL prefix」または「Custom HTTP URL Prefix」を選択します。

      デフォルトの HTTP URL 接頭部を選択すると、エンドポイント URL 接頭部の選択リストが提供されます。 このリストは、モジュールの 2 つのポート・セット (仮想ホスト・ポートとアプリケーション・サーバー・ポート) の組み合わせです。 Web サービスのアプリケーション・サーバーに直接アクセスする場合は、このリストの接頭部を使用します。 値を選択し、その接頭部を使用するモジュールのチェック・ボックスも選択します。

      カスタム HTTP URL 接頭部を使用する場合は、フィールドに値を入力します。 接頭部で使用するチェック・ボックスを選択します。

      カスタムの HTTP URL 接頭部を構成する場合は、カスタムの JVM プロパティー com.ibm.ws.webservices.enableHTTPPrefix を管理コンソールで 構成し、値を true に設定する必要もあります。このプロパティーがシステムによって使用されるようにするために、このカスタム・プロパティーを定義した後でアプリケーション・サーバーを再始動する必要があります。このカスタム JVM プロパティーの設定は、カスタム HTTP エンドポイントの接頭部の情報を ?WSDL 照会で正しく表示するために必要です。この照会は、ブラウザーで、クライアントに返される WSDL ファイルの URL フィールドから 返されます。このカスタム・プロパティーの値が true に定義されていない 場合、カスタム HTTP URL 接頭部は、サービスがクライアントに返す WSDL ファイルに 反映されません。 このカスタム JVM プロパティーの構成方法については、管理コンソールの JVM カスタム・プロパティー・パネルを使用した追加 HTTP トランスポート・プロパティーの構成方法に関する資料を参照してください。

      サポートされる構成 サポートされる構成: com.ibm.ws.webservices.enableHTTPPrefix カスタム・プロパティーは、JAX-RPC Web サービス・アプリケーションにのみ適用されます。sptcfg
    2. 適用」をクリックします。

      URL 接頭部は、デフォルトでもカスタムでも、 選択したモジュールの HTTP URL 接頭部フィールドにコピーされます。

    3. OK」をクリックします。 URL 情報がワークスペースに保存されます。

タスクの結果

「WSDL ファイルの公開」パネルを使用して公開される WSDL ファイル内で、 ターゲット・エンドポイント・アドレスを形成する場合に使用する部分的な URL 情報を指定しました。

次のタスク

Java Message Service (JMS) バインディング、および Enterprise JavaBeans (EJB) の直接アクセスのための、他の URL エンドポイント情報を構成します。 次に、WSDL ファイルを公開して、デプロイ済み Web サービス・アプリケーションを クライアントが使用できるようにします。

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



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