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

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

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

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

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

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

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

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

著作権と商標について