JAX-WS タイムアウト・プロパティー
Java™ API for XML-Based Web Services (JAX-WS) クライアントが応答メッセージの読み取り、要求メッセージの送信、および接続作成のために待機する期間を構成するタイムアウト・プロパティーを、JAX-WS アプリケーションのアプリケーション・サーバーの各種レベルで設定できます。これらのタイムアウト・プロパティーは、ポリシー・セット (org.apache.axis2.context.MessageContext) および Java 仮想マシン (JVM) で構成できます。この優先順位は、Web サービス・ランタイム環境がプロパティーを読み取る方法に基づきます。例えば、ポリシー・セットと JVM の両方で書き込みタイムアウトが設定されている場合は、ランタイム環境はポリシー・ファイルのプロパティー値を使用し、JVM プロパティーを無視します。以下の表に、読み取り、書き込み、および接続の各タイムアウト・プロパティーの概要を示します。 Java API for XML-based RPC (JAX-RPC) クライアントとは異なり、JAX-WS クライアントのタイムアウト・プロパティーは、クライアント・バインディング・ファイルに設定してはなりません。これは、そのようにして設定されたタイムアウト・プロパティーは、ランタイム環境に無視されるためです。読み取りおよび書き込みタイムアウトは、ワイヤー上の要求の書き込み時に開始するトランスポート・レベルのタイムアウトです。書き込みタイムアウトは、要求が書き込まれるときに停止します。読み取りタイムアウトには、プロバイダー内で費やされる時間が含まれ、応答がワイヤーから読み取られたときに停止します。要求と応答のマーシャルまたはアンマーシャルを Web サービスが行う時間はタイムアウトに含まれませんこれらのタイムアウトはまた、接続をセットアップするために必要な時間は考慮に入れません。
ポリシー・セットのタイムアウト・プロパティー
以下のタイムアウト・プロパティーをポリシー・セットで設定できます。Web サービス・ランタイム環境は、ポリシー・セット・レベルで設定されたタイムアウト・プロパティーを最高の優先順位で適用します。タイムアウト・プロパティーで有効な値は、秒を表す整数です。
Java 定数名 | リテラル名 | デフォルト値 |
---|---|---|
com.ibm.ws.websvcs.transport.common.TransportConstants.READ_TIMEOUT | readTimeout | 300 |
com.ibm.ws.websvcs.transport.common.TransportConstants.WRITE_TIMEOUT | writeTimeout | 300 |
com.ibm.ws.websvcs.transport.common.TransportConstants.CONN_TIMEOUT | connectTimeout | 180 |
MessageContext タイムアウト・プロパティー
以下のタイムアウト・プロパティーを MessageContext で設定できます。 Web サービス・ランタイム環境が MessageContext で設定されたタイムアウト・プロパティーを適用するのは、同等のタイムアウト・プロパティーがポリシー・セットで設定されていない場合のみです。タイムアウト・プロパティーで有効な値は、秒を表す整数です。
Java 定数名 | リテラル名 | デフォルト値 |
---|---|---|
com.ibm.wsspi.webservices.Constants.RESPONSE_TIMEOUT_PROPERTY | timeout | 300 |
com.ibm.wsspi.websvcs.Constants.WRITE_TIMEOUT_PROPERTY | write_timeout | 300 |
com.ibm.wsspi.websvcs.Constants.CONNECTION_TIMEOUT_PROPERTY | connection_timeout | 180 |
JVM タイムアウト・プロパティー
以下のタイムアウト・プロパティーを JVM で設定できます。Web サービス・ランタイム環境が JVM で設定されたタイムアウト・プロパティーを適用するのは、同等のタイムアウト・プロパティーがポリシー・セットでも MessageContext でも設定されていない場合のみです。 タイムアウト・プロパティーで有効な値は、秒を表す整数です。
Java 定数名 | リテラル名 | デフォルト値 |
---|---|---|
com.ibm.wsspi.webservices.Constants.RESPONSE_TIMEOUT_PROPERTY | timeout | 300 |
com.ibm.wsspi.webservices.Constants.WRITE_TIMEOUT_PROPERTY | write_timeout | 300 |
com.ibm.ws.websvcs.transport.http.WSHTTPConstants.HTTP_SOCKET_CONNECTION_TIMEOUT | com.ibm.websphere.webservices.http.SocketTimeout | 180 |