Web サービスとクライアントでのプロキシ設定

関連項目 

ファイアウォールで保護されていたり、プロキシサーバーを使用している環境でリモート Web サービスにアクセスする場合は、IDE でプロキシ設定を行う必要があります。リモート Web サービスでの作業で、プロキシの設定が問題になるのは次のような状況においてです。

次では、上記の各状況でのプロキシ設定について説明します。

「Web サービスクライアント」ウィザードで WSDL ファイルを読み出す場合

一般に、WSD ファイルを読み出す際、プロキシ設定が正しく行われていないと、「Web サービスクライアント」ウィザードで次のようなエラーメッセージが表示されます。

Download failed. I/O exception: (Check the proxy settings.)

次の手順でプロキシを確認、設定してください。

  1. 「Web サービスクライアント」ウィザードで「プロキシ設定」をクリックします。
  2. 「HTTP プロキシ設定」ウィンドウでプロキシホストおよびポート番号を設定します。

「了解」をクリックすると、変更が有効になります。

IDE を使用して Web サービスをテストする場合

一般に、IDE から Web サービスをテストする際、プロキシ設定が正しく行われていないと、次のようなエラーメッセージが返されます。

org.netbeans.modules.websvc.registry.ui.ReflectionHelper.callMethodWithParams(ReflectionHelper.java:449)

次の手順でプロキシを確認、設定してください。

  1. 「ツール」>「オプション」を選択します。
  2. 「オプション」ウィンドウでプロキシホストおよびポート番号を設定します。

「オプション」ウィンドウを終了すると、変更が有効になります。

Sun Java System Application Server に配備する場合

一般に、Sun Java System Application Server に Web サービスまたは Web サービスクライアントを配備する際に、プロキシ設定が正しく行われていないと、次のようなエラーメッセージが返されます。

java.rmi.RemoteException: HTTP transport error: java.net.UnknownHostException:

次の手順でプロキシを確認、設定してください。

  1. 「サービス」ウィンドウを開きます (Ctrl-5)。
  2. Sun Java System Application Server が起動していない場合は、サーバーを起動します。
  3. Sun Java System Application Server のノードを展開して、「JVM」 のノードを右クリックし、「プロパティー」を選択します。
  4. 「JVM のプロパティー」ダイアログで「JVMOptions」をクリックします。
  5. 次のプロパティーを追加します。

    -Dhttp.proxyHost=your.proxy.host
    -Dhttp.proxyPort=your.proxy.port.number

  6. サーバーを再起動して、新しいプロキシ設定を有効にします。

    JBoss Server に配備する場合

    一般に、JBoss に Web サービスまたは Web サービスクライアントを配備する際に、プロキシ設定が正しく行われていなくても、ブラウザには何も表示されません。

    次の手順でプロキシを確認、設定してください。

    1. ファイルシステムで jboss_install_dir\bin\run.bat に移動します。
    2. 次の行を追加します。set JAVA_OPTS=-Dhttp.proxyHost=your.proxy.host -Dhttp.proxyPort=your.proxy.port.number

    サーバーを再起動して、新しいプロキシ設定を有効にします。

    Tomcat Web Server に配備する場合

    一般に、JBoss に Web サービスまたは Web サービスクライアントを配備する際に、プロキシ設定が正しく行われていなくても、ブラウザには何も表示されません。

    次の手順でプロキシを確認、設定してください。

    1. 「サービス」ウィンドウを開きます (Ctrl-5)。
    2. Tomcat Web Server が動作している場合は、停止します。
    3. 「Tomcat」ノードを右クリックし、「プロパティー」を選択します。
    4. 「プラットフォーム」タブにある「VM オプション」テキストボックスに次のプロパティーを追加します。

      -Dhttp.proxyHost=your.proxy.host
      -Dhttp.proxyPort=your.proxy.port

    5. サーバーを起動して、新しいプロキシ設定を有効にします。

      Java アプリケーションから Web サービスクライアントを配備する場合

      一般に、Java アプリケーションから Web サービスまたは Web サービスクライアントを配備する際に、プロキシ設定が正しく行われていないと、次のようなエラーメッセージが返されます。

      java.rmi.RemoteException: HTTP transport error: java.net.UnknownHostException:

      次の手順でプロキシを確認、設定してください。

      1. 「プロジェクト」ウィンドウで Java アプリケーションプロジェクトのノードを右クリックし、「プロパティー」を選択します。
      2. 「プロジェクトプロパティー」ダイアログで「実行」をクリックします。
      3. 「VM オプション」フィールドに次のプロパティーを追加します。

        -Dhttp.proxyHost=your.proxy.host -Dhttp.proxyPort=your.proxy.port

      4. 「了解」をクリックすると、変更が有効になります。

        Java アプリケーションからクライアントを配備する場合は、各 Java アプリケーションがスタンドアロンの JVM プロセスとして動作し、それぞれに異なる JVM パラメータを提供できるため、プロジェクトごとにプロキシを設定する必要があります。複数の Web アプリケーションが同じサーバーインスタンスを使用する場合は、前述したように、プロキシの設定は 1 回、すなわち、サーバーそのものでのみ行う必要があるだけです。

        関連項目
        Web サービスについて

        著作権と商標について