www/http/HttpClient.java

8  * particular file as subject to the "Classpath" exception as provided
18  * 2 along with this work; if not, write to the Free Software Foundation,
101     // retryPostProp is true by default so as to preserve behavior
124      * through a Netscape proxy to a server that sent me a keep-alive
126      * after 5 sec.  So we have to hard code our effective timeout to
131     /** whether the response is to be cached */
198      *          to true if the system property http.keepAlive isn't set.
231     protected HttpClient(URL url, Proxy p, int to) throws IOException {
239         setConnectTimeout(to);
256      * to bypass implicit proxying.  Sometimes we need to be using tunneling
258      * for example when we don't want the application level data to become
259      * visible to third parties.
261      * @param url               the URL to which we're connecting
262      * @param proxy             proxy to use for this URL (e.g. forwarding)
263      * @param proxyPort         proxy port to use for this URL
264      * @param proxyDisabled     true to disable default proxying
274                        boolean proxyDisabled, int to)
277              newHttpProxy(proxyHost, proxyPort, "http"), to);
280     /* This class has no public constructor for HTTP.  This method is used to
281      * get an HttpClient to the specified URL.  If there's currently an
282      * active HttpClient to that server/port, you'll get that one.
294     public static HttpClient New(URL url, Proxy p, int to, boolean useCache,
328                     // We cannot return this connection to the cache as it's
331                     // to the same host will not use the same proxy.
341             ret = new HttpClient(url, p, to);
359     public static HttpClient New(URL url, Proxy p, int to,
362         return New(url, p, to, true, httpuc);
373                                  boolean useCache, int to,
377             to, useCache, httpuc);
386     /* return it to the cache as still usable, if:
404              * Return it to the cache.
445             assert false : "Duplicate put to keep alive cache";
457      * Close an idle connection to this URL (if it exists in the
467     /* We're very particular here about what our InputStream to the server
507      * may need to override this. An example is Https, where for
508      * direct connection to the origin server, ssl handshake needs to
509      * be done; for proxy tunneling, the socket needs to be converted
513         // NO-OP. Needs to be overwritten by HttpsClient
630                  * empty and we also have to add a "/".
677          * If this isn't valid HTTP, then we don't try to parse a header
679          * and instead just queue up the output stream to it's very beginning.
691             // We don't want to retry the request when the app. sets a timeout
730          * If this isn't valid HTTP, then we don't try to parse a header
732          * and instead just queue up the output stream to it's very beginning.
762                 // check if there are any applicable cookies to set (in cache)
790                 // It can transition from false to true, but once true
793                 // then we need to examine the response headers to figure out
796                 // alive: we will switch disableKeepAlive to true.
827                      * the server says to close.
894          * Set things up to parse the entity body of the reply.
897          * no entity body to parse.
959             // to wrap the input stream with KeepAliveStream/MeteredStream.
967             // to the cache. But we still need to use a keepalive stream to
996                 // need to wrap an unknown length input stream.
1045         // failedOnce is used to determine if a request should be retried.