Web サービス・アプリケーションの HTTP トランスポート・カスタム・プロパティー

このプロパティーは、接続が再使用されなくなるまでの 間隔を (秒) を指定します。

アプリケーションが新しい接続を要求すると、HTTP アウトバウンド・コネクターは 既存の未使用の接続を検索します。 このプロパティーで指定される間隔よりも長い時間 アイドル状態となっている接続が見つかると、その接続は解放される可能性があります。 このプロパティーで指定される間隔よりもアイドル状態が短い 接続が見つかると、その接続が再使用され、検索が終了します。 この検索は 1 つのエンドポイントだけを見つけて、すべての接続を調べる前に停止するため、 アイドル接続が残る可能性があります。

クリーンアップ・タスクは定期的に未使用の接続をすべてチェックし、そのアイドル時間を調べます。 クリーンアップ・タスクが、このプロパティーで指定される間隔よりも長い時間 アイドル状態となっている接続を見つけると、その接続が解放されます。 このため、アイドル 接続は、クリーンアップ・タスクのタイマー遅延とこのプロパティーの値を加えた時間まで持続することが可能です。 例えば、クリーンアップ・タスクのタイマー遅延が 180 秒で、com.ibm.websphere.webservices.http.connectionIdleTimeout がデフォルト値の 5 秒に設定されている場合、接続は解放されるまでに最大 185 秒間アイドル状態となることができます。 クリーンアップ・タスクのタイマー遅延を制御する JVM プロパティー は com.ibm.websphere.webservices.http.connectionPoolCleanUpTime です。

このプロパティーは、単一 JVM 内で作成されるすべての Web サービスの HTTP 接続に影響します。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーでは、コネクターが、ライブ HTTP 接続またはパーシスタント HTTP 接続を維持すべきかどうかを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

プロパティーを true に設定した場合、コネクターは接続プールでの接続を維持し、後続の HTTP 要求のために接続を再利用します。 しかし、syncTimeout(Read timeout) が読み取りのタイムアウトに達した場合やサーバーが接続を除去した場合には、接続はクローズされます。 また、アイドル状態にある接続は、プール維持スレッドにより、アイドル時間がアイドル接続タイムアウト値を経過した場合、クローズされます。 このプロパティーを false に設定すると、HTTP 要求が送信された後に、接続はクローズします。 新規要求の送信が準備済みで接続が存在しない場合、HTTP コネクターは接続を作成します。

要求に対する HTTP 200 応答は、要求が受信され、その要求に使用された接続は作動状態で、次の呼び出しに再使用可能であることを示します。 要求に対する HTTP 202 応答は、要求が受信されたが、その要求に使用された接続は再使用できないことを示します。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、接続プール維持スレッドの実行とその次の実行との間隔 (秒) を指定します。

このプロパティーは、単一 JVM 内で作成されるすべての Web サービスの HTTP 接続に影響します。 例えば、プロパティーが 180 に設定されていると、プール維持スレッドは 180 秒ごとに実行されます。 プール維持スレッドが実行されると、コネクターは、クリーンアップ・キューで接続を破棄します。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーは、接続要求がタイムアウトになる間隔を秒単位で指定します。WebServicesFault( "Connection timed out" )エラーが発生する。

値は、HTTP アウトバウンド・コネクターから送信されるすべての HTTP 接続要求に影響します。 接続プールでの接続最大数に達した場合、待機時間が必要です。 例えば、プロパティーが 300 に設定されていて、最大接続数に達している場合、コネクターは、接続が使用可能になるのを 300 秒待機します。 300 秒後に、WebServicesFault( "Connection timed out" )接続が使用できない場合は、エラーが発生します。 プロパティーが 0 (ゼロ) に設定されている場合、コネクターは接続が可能になるまで待機します。

If theWebServicesFault( "Connection timed out")アプリケーションでエラーが発生しました。 com.ibm.websphere.webservices.http.connectionTimeout プロパティーの値を高く設定してください。 また、アプリケーションの使用法についてもご検討ください。 com.ibm.websphere.webservices.http.maxConnection プロパティーの値が 0 (ゼロ) に設定されており、接続数に制限なく使用できる場合、com.ibm.websphere.webservices.http.connectionTimeout プロパティーの値は無視されます。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーは、HTTP アウトバウンド・コネクターの接続プールで作成される接続の最大数を指定します。

このプロパティーは、単一 JVM 内で作成されるすべての Web サービスの HTTP 接続に影響します。 接続が最大数に達した場合、新規接続は作成されず、HTTP コネクターは現行接続が接続プールに戻るまで待機します。 接続要求のタイムアウトにより、 HTTP コネクタが現在の接続を待たなかった場合WebServicesFault( "Connection timed out" )エラーが発生する。 例えば、プロパティーが 5 に設定されていて、5 つの接続が使用中の場合、HTTP コネクターは、com.ibm.websphere.webservices.http.connectionTimeout プロパティーに設定された接続が可能になるまでの時間を待機します。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーは、各 HTTP 応答のメッセージで使用するエンコードのタイプを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

サポートされるエンコードのフォーマットは、gzip、x-gzip、および deflate を含む HTTP 1.1 プロトコル仕様に準じます。 このプロパティーが構成される場合、HTTP 応答の Content-Encoding ヘッダーが、同じ値に設定されます。 プロパティーが設定されていない場合は、HTTP 応答メッセージのコンテンツはエンコードされません。 デフォルト値はno encodingです。

プロパティーが設定されていると、要求クライアントは同じエンコードもサポートする必要があります。 そうでない場合、障害が発生することがあり、WebServicesFault() エラーが表示されます。

圧縮エンコード・フォーマットはサポートされていません。x-gzip エンコードは、gzip エンコードと同じです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、各 HTTP アウトバウンド要求のメッセージで使用するエンコードのタイプを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

サポートされるエンコードのフォーマットは、gzip、x-gzip、および deflate を含む HTTP 1.1 プロトコル仕様に準じます。 このプロパティーが構成されると、HTTP 要求の Content-Encoding ヘッダーと Accept-Encoding ヘッダーも同じ値に設定されます。 例えば、プロパティーが gzip に設定されていると、ヘッダーは、「コンテンツ・エンコード: gzip」および「受け入れエンコード: gzip」になります。 しかし、プロパティーが設定されていない場合は、HTTP 要求メッセージはエンコードされません。 デフォルトは「no encoding」です。

ターゲット Web サーバーが、構成されたコーディング・フォーマットをデコードすることが可能かどうかを確認する必要があります。 例えば、プロパティーが gzip に設定されている場合、ターゲット Web サーバーは、gzip エンコードもサポートすることになります。 そうしないと、障害が発生し、状況コード 415 Unsupported Media Type が表示される可能性があります。

圧縮エンコード・フォーマットはサポートされていません。x-gzip エンコードは、gzip エンコードと同じです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、「java.net.ConnectException: read timed out」エラーが記録された後で、 HTTP コネクターに HTTP 要求経由で SOAP メッセージを再送信するように伝えます。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーは、「java.net.ConnectException: read timed out」エラーが記録された後で、 HTTP コネクターに HTTP 要求経由で SOAP メッセージを再送信するように伝えます。 java.net.ConnectException は、ソケットがタイムアウトになった場合や、要求を送信中にサーバーがシャットダウンした時に発生します。 このプロパティーが使用できる場合、コネクターは 1 度だけ再接続を試み、同じ SOAP メッセージを HTTP 経由で再送信します。 それ以外の場合には、コネクターは SOAP メッセージの送信を停止し、WebServicesFault エラーが記録されます。

このプロパティーが使用可能な場合には、アプリケーションに問題が発生することがあります。 再送信された HTTP 要求は、サーバーにより 2 度受信されることがあり、予期しない結果を発生する原因となることがあります。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、リモート・サーバーでアウトバウンド・ソケットが確立されるまで待機する時間を秒単位で指定します。

このプロパティーは、単一 JVM 内で作成されるすべての Web サービスの HTTP 接続に影響します。 無効な値が指定された場合は、デフォルト値がこの無効値をオーバーライドします。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーは、管理コンソールの「HTTP エンドポイント URL 情報の指定」パネルでカスタム HTTP URL のプレフィックスとして定義した hostname:port の値を、サービスからクライアントに返される WSDL ファイルのコピー内の URL フィールドに取り込むかどうかを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーに true の値を設定して、指定したカスタム HTTP URL プレフィックスが、クライアントに返される WSDL ファイルに正しく指定されるようにします。 このプロパティーに true の値が設定されていない場合、要求に応答するサーバー・ノードの指定したカスタム値 hostname:port が、クライアントに返される WSDL ファイルのコピー内の URL フィールドに取り込まれません。

このカスタム・プロパティーを定義した後で、 アプリケーション・サーバーを再始動して、このプロパティーがシステムで使用されるようにする 必要があります。

このプロパティーは、接続がアクティブであるか中止されているかに関係なく、接続プールから接続が除去されるまでの時間を指定します。

接続プールに接続が残っている場合がまれにあります。これにより、接続プールが満杯になる可能性があります。 接続プールが満杯の場合、すべての新規要求は使用可能な接続を待機し、最終的にはタイムアウトになります。 この接続リークの問題を避けるために、応答を受信しなかった接続が、クリーンアップされるまでの時間を指定できます。

強制的な接続クリーンアップを有効にするには、このプロパティーの値を秒単位で構成します。 構成された値より長期間存在する接続がクリーンアップされます。

このプロパティーは、クライアントが同じクライアント・インスタンスのスレッド間で HTTP セッション情報を共有できるようにするかどうかを指定します。 この動作を有効にするには、クライアント・スタブ上の _setProperty メソッドを呼び出して、このプロパティーに true の値を設定します。 このプロパティーが有効でない場合のデフォルトの動作では、クライアントが呼び出されたスレッドに対してローカルなセッションが作成されます。

このプロパティーは、Java API for XML-based RPC (JAX-RPC) Web サービスにのみ適用されます。

Properties prop = new Properties();
InitialContext ctx = new InitialContext(prop);
Service service = (Service)ctx.lookup("java:comp/env/service/StockQuoteService");
QName portQname = new QName("http://httpchannel.test.wsfvt.ws.ibm.com", "StockQuoteHttp");
StockQuote sq = (StockQuote)service.getPort(portQname, StockQuote.class);
((javax.xml.rpc.Stub) sq)._setProperty(com.ibm.wsspi.webservices.Constants.ENABLE_MULTITHREADED_SESSION, Boolean.TRUE);

このカスタム・プロパティーを定義した後で、 アプリケーション・サーバーを再始動して、このプロパティーがシステムで使用されるようにする 必要があります。

このプロパティーは、非同期 JAX-WS アプリケーションでパーシスタント読み取りのタイムアウトが発生するまでの時間を秒単位で指定します。

java.io.IOException: Async IO operation failed (1), reason: RC: 32  Broken pipe

このプロパティーは、大きいファイルを読み取る場合、または、ネットワークが遅く、 サーバー・サイドでデータの読み取りにデフォルト値の 7 秒を超える時間を 要する場合に使用してください。 サーバー・サイドで broken pipe 例外を 受け取った場合は、このタイムアウト・プロパティーの値を 増やしてください。

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

この JVM システム・プロパティーは、http.proxyHost および https.proxyHost プロパティーへのオーバーライドとして機能し、要求がプロキシー・サーバーを介して送信されないマシンのホスト名を指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

クライアント・アプリケーションによって呼び出される要求のうち、このプロパティーに含まれる名前を持つホストに送信されるものは、プロキシー・サーバーを経由しません。 リスト内の各ホスト名は、垂直バー (|) で区切ります。 オプションで、ワイルドカード文字としてアスタリスク (*) を使用できます。

http.nonProxyHosts プロパティーは、HTTP 接続および HTTPS 接続の両方に適用されます。

http.nonProxyHosts="host1.company1.com|host*.company2.com|*.company3.com|host1"

このプロパティーの構成方法については、『管理コンソールを使用して、追加 HTTP トランスポート・プロパティーを構成する』の情報を参照してください。

このプロパティーは、HTTP プロキシーのホスト名を指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、HTTP プロキシーのポートを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、HTTPS プロキシーのホスト名を指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、HTTPS プロキシーのポートを指定します。 これは、Web サービス・アプリケーションに構成できる HTTP トランスポート・プロパティーです。

このプロパティーの構成方法について詳しくは、『wsadmin を使用して、追加 HTTP トランスポート・プロパティーを構成する』および『アセンブリー・ツールを使用して、追加 HTTP トランスポート・プロパティーを構成する』を参照してください。

このプロパティーは、読み取りがタイムアウトになるまでの時間を秒単位で指定します。

大容量の Web サービス・メッセージを読み取っているときに、Web サービスを呼び出すと、SocketTimeoutExceptions エラーを示す WSWS3228E メッセージを受け取る場合があります。

値は、HTTP インバウンド・コネクターからのすべての HTTP 接続要求に影響します。 この読み取りタイムアウト・プロパティーは、大容量のデータの読み取り時、またはネットワークの速度が遅く、データの読み取りにデフォルトの 300 秒を超える時間を要する場合に使用します。 メッセージの読み取り時に SocketTimeoutExceptions エラーが発生する場合は、このタイムアウト・プロパティーの値を増やしてください。

JAX-WS アプリケーションの場合は、HTTP トランスポート・ポリシーをカスタマイズするか、あるいは JAX-WS バインディングを使用して、このプロパティーを構成することもできます。 これらの手段でこのプロパティーを構成する方法については、管理コンソールを使用した追加 HTTP トランスポート・プロパティーの構成、または HTTP トランスポートのポリシーおよびバインディングのプロパティーの構成に関する情報を参照してください。

このプロパティーは、メッセージ送信時に書き込みアクションがタイムアウトになる時間を秒単位で指定します。

大容量の Web サービス・メッセージを書き込んでいるときに、Web サービスを呼び出すと、SocketTimeoutExceptions エラーを示す WSWS3228E メッセージを受け取る場合があります。

値は、HTTP アウトバウンド・コネクターから送信されるすべての HTTP 接続要求に影響します。 この書き込みタイムアウト・プロパティーは、大容量のデータの送信時、またはネットワークの速度が遅く、データの書き込みにデフォルトの 300 秒を超える時間を要する場合に使用します。 メッセージの書き込み時に SocketTimeoutExceptions エラーが発生する場合は、この write_timeout プロパティーの値を増やしてください。

JAX-WS アプリケーションの場合は、HTTP トランスポート・ポリシーをカスタマイズするか、あるいは JAX-WS バインディングを使用して、このプロパティーを構成することもできます。 これらの手段でこのプロパティーを構成する方法については、管理コンソールを使用した追加 HTTP トランスポート・プロパティーの構成、または HTTP トランスポートのポリシーおよびバインディングのプロパティーの構成に関する情報を参照してください。