Java apache HttpClientのconnectionRequestTimeoutとconnectTimeoutの違いについて

Question

JavaのHttpClientとしてapache HttpClient（4.5.1）を使用しています。

HTTPリクエストの設定において、connectionRequestTimeoutとconnectTimeoutを設定することができますが、この2つの違いが判りません。

以下、getterのjavadocになりますが、知見ございましたらご教示いただけますと幸いです。

    /**
     * Returns the timeout in milliseconds used when requesting a connection
     * from the connection manager. A timeout value of zero is interpreted
     * as an infinite timeout.
     * <p>
     * A timeout value of zero is interpreted as an infinite timeout.
     * A negative value is interpreted as undefined (system default).
     * </p>
     * <p>
     * Default: {@code -1}
     * </p>
     */
    public int getConnectionRequestTimeout() {
        return connectionRequestTimeout;
    }

    /**
     * Determines the timeout in milliseconds until a connection is established.
     * A timeout value of zero is interpreted as an infinite timeout.
     * <p>
     * A timeout value of zero is interpreted as an infinite timeout.
     * A negative value is interpreted as undefined (system default).
     * </p>
     * <p>
     * Default: {@code -1}
     * </p>
     */
    public int getConnectTimeout() {
        return connectTimeout;
    }

Answer 1

getConnectionRequestTimeout
リクエストを送信してからレスポンスを受け取るまで何ミリ秒待つかという設定

getConnectTimeout
接続に何ミリ秒待つかという設定。

処理の流れとしては、
1.サーバへの接続要求送信
2.サーバからの接続確立受領
3.サーバへのリクエスト送信
4.サーバからのレスポンス受領
となりますが、

getConnectTimeout は、2.サーバからの接続確率受領 の部分でどれだけ待ってあきらめるか
getConnectionRequestTimeout は、4.サーバからのレスポンス受領 の部分でどれだけ待ってあきらめるか
に対応します。
違いは、"接続" と "リクエスト" という対象の違いになります。

Comments

[takenyaan]

ご回答ありがとうございます。
上記の説明で理解できましたが、そうなると今度は「getConnectionRequestTimeout 」と「socketTimeout」の違いはなんでしょうか。
この二つはやはり同じように思えてしまいます。

```
/**
* Defines the socket timeout ({@code SO_TIMEOUT}) in milliseconds,
* which is the timeout for waiting for data or, put differently,
* a maximum period inactivity between two consecutive data packets).
* <p>
* A timeout value of zero is interpreted as an infinite timeout.
* A negative value is interpreted as undefined (system default).
* </p>
* <p>
* Default: {@code -1}
* </p>
*/
public int getSocketTimeout() {
return socketTimeout;
}
```

[Hiroshi-Aoki]

getSocketTimeout
ソケット通信におけるデータの受信(waiting for data)と送信(put)を何ミリ秒待つかという設定

getConnectionRequestTimeout との違いですが、これを説明するにあたっては、ソケット通信についての説明が少し必要です。
ソケット通信とは、PCとPCやPCとサーバが通信してデータをやりとりする基本的な仕組みです。IPアドレスとポート番号を指定してデータをそのあて先に送信したり、自PCのポート番号でデータが送達されるのを待って受信したりということを行います。
HttpClientでは接続やリクエストを送信したり、レスポンスを受信したりしますが、この裏側で動いているのがソケット通信です。HTTPの接続やリクエストはソケット通信を使っています。
ソケット通信は接続、送信、受信のすべてにかかわります。HttpClientで接続、リクエストで使いますが、HttpServerでも受信待機、レスポンス送信に使われます。

違いは、HTTPクライアント用のもの(getConnectionRequestTimeout)と基本的な仕組み用のもの(getSocketTimeout)という違いになります。