151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/* 251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Copyright (c) 1996, 2011, Oracle and/or its affiliates. All rights reserved. 351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is free software; you can redistribute it and/or modify it 651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * under the terms of the GNU General Public License version 2 only, as 751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * published by the Free Software Foundation. Oracle designates this 851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * particular file as subject to the "Classpath" exception as provided 951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * by Oracle in the LICENSE file that accompanied this code. 1051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is distributed in the hope that it will be useful, but WITHOUT 1251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * version 2 for more details (a copy is included in the LICENSE file that 1551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * accompanied this code). 1651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * You should have received a copy of the GNU General Public License version 1851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2 along with this work; if not, write to the Free Software Foundation, 1951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or visit www.oracle.com if you need additional information or have any 2351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * questions. 2451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 2551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipackage java.net; 2751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiimport java.io.InputStream; 2951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiimport java.io.IOException; 3051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiimport java.security.Permission; 3151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiimport java.util.Date; 3251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 3351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/** 3451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A URLConnection with support for HTTP-specific features. See 3551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <A HREF="http://www.w3.org/pub/WWW/Protocols/"> the spec </A> for 3651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * details. 3751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 3851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 392d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>Uses of this class follow a pattern: 402d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <ol> 412d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <li>Obtain a new {@code HttpURLConnection} by calling {@link 422d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * URL#openConnection() URL.openConnection()} and casting the result to 432d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@code HttpURLConnection}. 442d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <li>Prepare the request. The primary property of a request is its URI. 452d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Request headers may also include metadata such as credentials, preferred 462d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * content types, and session cookies. 472d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <li>Optionally upload a request body. Instances must be configured with 482d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link #setDoOutput(boolean) setDoOutput(true)} if they include a 492d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * request body. Transmit data by writing to the stream returned by {@link 502d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * #getOutputStream()}. 512d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <li>Read the response. Response headers typically include metadata such as 522d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the response body's content type and length, modified dates and session 532d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookies. The response body may be read from the stream returned by {@link 542d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * #getInputStream()}. If the response has no body, that method returns an 552d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * empty stream. 562d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <li>Disconnect. Once the response body has been read, the {@code 572d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpURLConnection} should be closed by calling {@link #disconnect()}. 582d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Disconnecting releases the resources held by a connection so they may 592d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * be closed or reused. 602d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * </ol> 612d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 622d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>For example, to retrieve the webpage at {@code http://www.android.com/}: 632d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <pre> {@code 642d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * URL url = new URL("http://www.android.com/"); 652d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection(); 662d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * try { 672d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * InputStream in = new BufferedInputStream(urlConnection.getInputStream()); 682d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * readStream(in); 692d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } finally { 702d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.disconnect(); 712d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 722d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 732d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 742d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Secure Communication with HTTPS</h3> 752d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Calling {@link URL#openConnection()} on a URL with the "https" 762d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * scheme will return an {@code HttpsURLConnection}, which allows for 772d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * overriding the default {@link javax.net.ssl.HostnameVerifier 782d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HostnameVerifier} and {@link javax.net.ssl.SSLSocketFactory 792d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * SSLSocketFactory}. An application-supplied {@code SSLSocketFactory} 802d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * created from an {@link javax.net.ssl.SSLContext SSLContext} can 812d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * provide a custom {@link javax.net.ssl.X509TrustManager 822d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * X509TrustManager} for verifying certificate chains and a custom 832d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link javax.net.ssl.X509KeyManager X509KeyManager} for supplying 842d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * client certificates. See {@link javax.net.ssl.HttpsURLConnection 852d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpsURLConnection} for more details. 862d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 872d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Response Handling</h3> 882d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@code HttpURLConnection} will follow up to five HTTP redirects. It will 892d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * follow redirects from one origin server to another. This implementation 902d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * doesn't follow redirects from HTTPS to HTTP or vice versa. 912d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 922d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>If the HTTP response indicates that an error occurred, {@link 932d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * #getInputStream()} will throw an {@link IOException}. Use {@link 942d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * #getErrorStream()} to read the error response. The headers can be read in 952d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the normal way using {@link #getHeaderFields()}, 962d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 972d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Posting Content</h3> 982d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * To upload data to a web server, configure the connection for output using 992d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link #setDoOutput(boolean) setDoOutput(true)}. 1002d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1012d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>For best performance, you should call either {@link 1022d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * #setFixedLengthStreamingMode(int)} when the body length is known in advance, 1032d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * or {@link #setChunkedStreamingMode(int)} when it is not. Otherwise {@code 1042d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpURLConnection} will be forced to buffer the complete request body in 1052d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * memory before it is transmitted, wasting (and possibly exhausting) heap and 1062d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * increasing latency. 1072d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1082d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>For example, to perform an upload: <pre> {@code 1092d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection(); 1102d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * try { 1112d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.setDoOutput(true); 1122d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.setChunkedStreamingMode(0); 1132d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1142d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * OutputStream out = new BufferedOutputStream(urlConnection.getOutputStream()); 1152d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * writeStream(out); 1162d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1172d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * InputStream in = new BufferedInputStream(urlConnection.getInputStream()); 1182d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * readStream(in); 1192d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } finally { 1202d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.disconnect(); 1212d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 1222d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 1232d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1242d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Performance</h3> 1252d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * The input and output streams returned by this class are <strong>not 1262d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * buffered</strong>. Most callers should wrap the returned streams with {@link 1272d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * java.io.BufferedInputStream BufferedInputStream} or {@link 1282d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * java.io.BufferedOutputStream BufferedOutputStream}. Callers that do only bulk 1292d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * reads or writes may omit buffering. 1302d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1312d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>When transferring large amounts of data to or from a server, use streams 1322d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * to limit how much data is in memory at once. Unless you need the entire 1332d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * body to be in memory at once, process it as a stream (rather than storing 1342d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the complete body as a single byte array or string). 1352d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1362d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>To reduce latency, this class may reuse the same underlying {@code Socket} 1372d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * for multiple request/response pairs. As a result, HTTP connections may be 1382d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * held open longer than necessary. Calls to {@link #disconnect()} may return 1392d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the socket to a pool of connected sockets. This behavior can be disabled by 1402d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * setting the {@code http.keepAlive} system property to {@code false} before 1412d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * issuing any HTTP requests. The {@code http.maxConnections} property may be 1422d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * used to control how many idle connections to each server will be held. 1432d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1442d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>By default, this implementation of {@code HttpURLConnection} requests that 1452d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * servers use gzip compression and it automatically decompresses the data for 1462d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * callers of {@link #getInputStream()}. The Content-Encoding and Content-Length 1472d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * response headers are cleared in this case. Gzip compression can be disabled by 1482d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * setting the acceptable encodings in the request header: <pre> {@code 1492d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.setRequestProperty("Accept-Encoding", "identity"); 1502d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 1512d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1522d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>Setting the Accept-Encoding request header explicitly disables automatic 1532d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * decompression and leaves the response headers intact; callers must handle 1542d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * decompression as needed, according to the Content-Encoding header of the 1552d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * response. 1562d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1572d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>{@link #getContentLength()} returns the number of bytes transmitted and 1582d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cannot be used to predict how many bytes can be read from 1592d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link #getInputStream()} for compressed streams. Instead, read that stream 1602d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * until it is exhausted, i.e. when {@link InputStream#read} returns -1. 1612d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1622d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Handling Network Sign-On</h3> 1632d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Some Wi-Fi networks block Internet access until the user clicks through a 1642d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * sign-on page. Such sign-on pages are typically presented by using HTTP 1652d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * redirects. You can use {@link #getURL()} to test if your connection has been 1662d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * unexpectedly redirected. This check is not valid until <strong>after</strong> 1672d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the response headers have been received, which you can trigger by calling 1682d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link #getHeaderFields()} or {@link #getInputStream()}. For example, to 1692d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * check that a response was not redirected to an unexpected host: 1702d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <pre> {@code 1712d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection(); 1722d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * try { 1732d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * InputStream in = new BufferedInputStream(urlConnection.getInputStream()); 1742d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * if (!url.getHost().equals(urlConnection.getURL().getHost())) { 1752d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * // we were redirected! Kick the user out to the browser to sign on? 1762d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 1772d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * ... 1782d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } finally { 1792d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * urlConnection.disconnect(); 1802d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 1812d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 1822d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1832d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>HTTP Authentication</h3> 1842d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@code HttpURLConnection} supports <a 1852d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * href="http://www.ietf.org/rfc/rfc2617">HTTP basic authentication</a>. Use 1862d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link Authenticator} to set the VM-wide authentication handler: 1872d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <pre> {@code 1882d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Authenticator.setDefault(new Authenticator() { 1892d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * protected PasswordAuthentication getPasswordAuthentication() { 1902d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * return new PasswordAuthentication(username, password.toCharArray()); 1912d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 1922d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }); 1932d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 1942d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Unless paired with HTTPS, this is <strong>not</strong> a secure mechanism for 1952d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * user authentication. In particular, the username, password, request and 1962d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * response are all transmitted over the network without encryption. 1972d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 1982d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Sessions with Cookies</h3> 1992d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * To establish and maintain a potentially long-lived session between client 2002d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * and server, {@code HttpURLConnection} includes an extensible cookie manager. 2012d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Enable VM-wide cookie management using {@link CookieHandler} and {@link 2022d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * CookieManager}: <pre> {@code 2032d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * CookieManager cookieManager = new CookieManager(); 2042d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * CookieHandler.setDefault(cookieManager); 2052d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 2062d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * By default, {@code CookieManager} accepts cookies from the <a 2072d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec1.html">origin 2082d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * server</a> only. Two other policies are included: {@link 2092d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * CookiePolicy#ACCEPT_ALL} and {@link CookiePolicy#ACCEPT_NONE}. Implement 2102d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@link CookiePolicy} to define a custom policy. 2112d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2122d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>The default {@code CookieManager} keeps all accepted cookies in memory. It 2132d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * will forget these cookies when the VM exits. Implement {@link CookieStore} to 2142d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * define a custom cookie store. 2152d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2162d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>In addition to the cookies set by HTTP responses, you may set cookies 2172d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * programmatically. To be included in HTTP request headers, cookies must have 2182d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * the domain and path properties set. 2192d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2202d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>By default, new instances of {@code HttpCookie} work only with servers 2212d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * that support <a href="http://www.ietf.org/rfc/rfc2965.txt">RFC 2965</a> 2222d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookies. Many web servers support only the older specification, <a 2232d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * href="http://www.ietf.org/rfc/rfc2109.txt">RFC 2109</a>. For compatibility 2242d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * with the most web servers, set the cookie version to 0. 2252d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2262d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>For example, to receive {@code www.twitter.com} in French: <pre> {@code 2272d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * HttpCookie cookie = new HttpCookie("lang", "fr"); 2282d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookie.setDomain("twitter.com"); 2292d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookie.setPath("/"); 2302d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookie.setVersion(0); 2312d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * cookieManager.getCookieStore().add(new URI("http://twitter.com/"), cookie); 2322d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }</pre> 2332d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2342d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>HTTP Methods</h3> 2352d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>{@code HttpURLConnection} uses the {@code GET} method by default. It will 2362d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * use {@code POST} if {@link #setDoOutput setDoOutput(true)} has been called. 2372d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Other HTTP methods ({@code OPTIONS}, {@code HEAD}, {@code PUT}, {@code 2382d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * DELETE} and {@code TRACE}) can be used with {@link #setRequestMethod}. 2392d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2402d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Proxies</h3> 2412d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * By default, this class will connect directly to the <a 2422d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec1.html">origin 2432d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * server</a>. It can also connect via an {@link Proxy.Type#HTTP HTTP} or {@link 2442d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Proxy.Type#SOCKS SOCKS} proxy. To use a proxy, use {@link 2452d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * URL#openConnection(Proxy) URL.openConnection(Proxy)} when creating the 2462d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * connection. 2472d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2482d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>IPv6 Support</h3> 2492d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>This class includes transparent support for IPv6. For hosts with both IPv4 2502d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * and IPv6 addresses, it will attempt to connect to each of a host's addresses 2512d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * until a connection is established. 2522d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2532d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Response Caching</h3> 2542d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Android 4.0 (Ice Cream Sandwich, API level 15) includes a response cache. See 2552d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * {@code android.net.http.HttpResponseCache} for instructions on enabling HTTP 2562d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * caching in your application. 2572d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2582d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <h3>Avoiding Bugs In Earlier Releases</h3> 2592d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * Prior to Android 2.2 (Froyo), this class had some frustrating bugs. In 2602d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * particular, calling {@code close()} on a readable {@code InputStream} could 2612d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <a href="http://code.google.com/p/android/issues/detail?id=2939">poison the 2622d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * connection pool</a>. Work around this by disabling connection pooling: 2632d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <pre> {@code 2642d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * private void disableConnectionReuseIfNecessary() { 2652d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * // Work around pre-Froyo bugs in HTTP connection reuse. 2662d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * if (Integer.parseInt(Build.VERSION.SDK) < Build.VERSION_CODES.FROYO) { 2672d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * System.setProperty("http.keepAlive", "false"); 2682d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * } 2692d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * }}</pre> 2702d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 2712d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * <p>Each instance of {@code HttpURLConnection} may be used for one 2722d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * request/response pair. Instances of this class are not thread safe. 2732d7bfb83d19f435d44b0f83079629ce138092a0aPrzemyslaw Szczepaniak * 27451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since JDK1.1 27551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 27651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiabstract public class HttpURLConnection extends URLConnection { 27751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* instance variables */ 27851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 27951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 28051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The HTTP method (GET,POST,PUT,etc.). 28151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 28251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected String method = "GET"; 28351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 28451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 28551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The chunk-length when using chunked encoding streaming mode for output. 28651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A value of <code>-1</code> means chunked encoding is disabled for output. 28751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.5 28851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 28951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected int chunkLength = -1; 29051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 29151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 29251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The fixed content-length when using fixed-length streaming mode. 29351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A value of <code>-1</code> means fixed-length streaming mode is disabled 29451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * for output. 29551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 29651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <P> <B>NOTE:</B> {@link #fixedContentLengthLong} is recommended instead 29751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of this field, as it allows larger content lengths to be set. 29851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 29951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.5 30051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 30151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected int fixedContentLength = -1; 30251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 30351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 30451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The fixed content-length when using fixed-length streaming mode. 30551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A value of {@code -1} means fixed-length streaming mode is disabled 30651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * for output. 30751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 30851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.7 30951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 31051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected long fixedContentLengthLong = -1; 31151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 31251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 31351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the key for the <code>n</code><sup>th</sup> header field. 31451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Some implementations may treat the <code>0</code><sup>th</sup> 31551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * header field as special, i.e. as the status line returned by the HTTP 31651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * server. In this case, {@link #getHeaderField(int) getHeaderField(0)} returns the status 31751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * line, but <code>getHeaderFieldKey(0)</code> returns null. 31851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 31951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param n an index, where n >=0. 32051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the key for the <code>n</code><sup>th</sup> header field, 32151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or <code>null</code> if the key does not exist. 32251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 32351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getHeaderFieldKey (int n) { 32451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return null; 32551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 32651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 32751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 32851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method is used to enable streaming of a HTTP request body 32951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * without internal buffering, when the content length is known in 33051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * advance. 33151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 33251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * An exception will be thrown if the application 33351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * attempts to write more data than the indicated 33451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * content-length, or if the application closes the OutputStream 33551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * before writing the indicated amount. 33651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 33751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * When output streaming is enabled, authentication 33851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * and redirection cannot be handled automatically. 33951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A HttpRetryException will be thrown when reading 34051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the response if authentication or redirection are required. 34151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This exception can be queried for the details of the error. 34251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 34351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method must be called before the URLConnection is connected. 34451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 34551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <B>NOTE:</B> {@link #setFixedLengthStreamingMode(long)} is recommended 34651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * instead of this method as it allows larger content lengths to be set. 34751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 34851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param contentLength The number of bytes which will be written 34951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * to the OutputStream. 35051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 35151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalStateException if URLConnection is already connected 35251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or if a different streaming mode is already enabled. 35351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 35451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalArgumentException if a content length less than 35551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * zero is specified. 35651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 35751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #setChunkedStreamingMode(int) 35851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.5 35951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 36051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public void setFixedLengthStreamingMode (int contentLength) { 36151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (connected) { 36251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException ("Already connected"); 36351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 36451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (chunkLength != -1) { 36551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException ("Chunked encoding streaming mode set"); 36651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 36751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (contentLength < 0) { 36851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException ("invalid content length"); 36951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 37051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski fixedContentLength = contentLength; 37151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 37251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 37351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 37451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method is used to enable streaming of a HTTP request body 37551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * without internal buffering, when the content length is known in 37651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * advance. 37751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 37851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <P> An exception will be thrown if the application attempts to write 37951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * more data than the indicated content-length, or if the application 38051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * closes the OutputStream before writing the indicated amount. 38151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 38251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <P> When output streaming is enabled, authentication and redirection 38351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * cannot be handled automatically. A {@linkplain HttpRetryException} will 38451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * be thrown when reading the response if authentication or redirection 38551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * are required. This exception can be queried for the details of the 38651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * error. 38751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 38851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <P> This method must be called before the URLConnection is connected. 38951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 39051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <P> The content length set by invoking this method takes precedence 39151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * over any value set by {@link #setFixedLengthStreamingMode(int)}. 39251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 39351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param contentLength 39451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The number of bytes which will be written to the OutputStream. 39551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 39651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalStateException 39751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * if URLConnection is already connected or if a different 39851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * streaming mode is already enabled. 39951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 40051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalArgumentException 40151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * if a content length less than zero is specified. 40251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 40351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.7 40451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 40551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public void setFixedLengthStreamingMode(long contentLength) { 40651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (connected) { 40751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException("Already connected"); 40851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 40951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (chunkLength != -1) { 41051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException( 41151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski "Chunked encoding streaming mode set"); 41251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 41351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (contentLength < 0) { 41451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("invalid content length"); 41551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 41651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski fixedContentLengthLong = contentLength; 41751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 41851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 41951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* Default chunk size (including chunk header) if not specified; 42051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * we want to keep this in sync with the one defined in 42151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * sun.net.www.http.ChunkedOutputStream 42251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 42351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private static final int DEFAULT_CHUNK_SIZE = 4096; 42451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 42551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 42651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method is used to enable streaming of a HTTP request body 42751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * without internal buffering, when the content length is <b>not</b> 42851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * known in advance. In this mode, chunked transfer encoding 42951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * is used to send the request body. Note, not all HTTP servers 43051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * support this mode. 43151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 43251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * When output streaming is enabled, authentication 43351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * and redirection cannot be handled automatically. 43451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A HttpRetryException will be thrown when reading 43551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the response if authentication or redirection are required. 43651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This exception can be queried for the details of the error. 43751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 43851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method must be called before the URLConnection is connected. 43951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 44051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param chunklen The number of bytes to write in each chunk. 44151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If chunklen is less than or equal to zero, a default 44251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * value will be used. 44351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 44451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalStateException if URLConnection is already connected 44551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or if a different streaming mode is already enabled. 44651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 44751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #setFixedLengthStreamingMode(int) 44851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.5 44951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 45051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public void setChunkedStreamingMode (int chunklen) { 45151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (connected) { 45251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException ("Can't set streaming mode: already connected"); 45351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 45451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (fixedContentLength != -1 || fixedContentLengthLong != -1) { 45551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalStateException ("Fixed length streaming mode set"); 45651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 45751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski chunkLength = chunklen <=0? DEFAULT_CHUNK_SIZE : chunklen; 45851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 45951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 46051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 46151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the value for the <code>n</code><sup>th</sup> header field. 46251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Some implementations may treat the <code>0</code><sup>th</sup> 46351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * header field as special, i.e. as the status line returned by the HTTP 46451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * server. 46551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 46651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This method can be used in conjunction with the 46751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * {@link #getHeaderFieldKey getHeaderFieldKey} method to iterate through all 46851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the headers in the message. 46951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 47051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param n an index, where n>=0. 47151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the value of the <code>n</code><sup>th</sup> header field, 47251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or <code>null</code> if the value does not exist. 47351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#getHeaderFieldKey(int) 47451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 47551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getHeaderField(int n) { 47651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return null; 47751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 47851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 47951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 48051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * An <code>int</code> representing the three digit HTTP Status-Code. 48151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <ul> 48251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <li> 1xx: Informational 48351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <li> 2xx: Success 48451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <li> 3xx: Redirection 48551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <li> 4xx: Client Error 48651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <li> 5xx: Server Error 48751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * </ul> 48851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 48951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected int responseCode = -1; 49051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 49151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 49251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The HTTP response message. 49351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 49451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected String responseMessage = null; 49551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 49651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* static variables */ 49751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 49851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* do we automatically follow redirects? The default is true. */ 49951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private static boolean followRedirects = true; 50051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 50151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 50251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If <code>true</code>, the protocol will automatically follow redirects. 50351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If <code>false</code>, the protocol will not automatically follow 50451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * redirects. 50551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 50651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This field is set by the <code>setInstanceFollowRedirects</code> 50751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * method. Its value is returned by the <code>getInstanceFollowRedirects</code> 50851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * method. 50951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 51051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Its default value is based on the value of the static followRedirects 51151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * at HttpURLConnection construction time. 51251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 51351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#setInstanceFollowRedirects(boolean) 51451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#getInstanceFollowRedirects() 51551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#setFollowRedirects(boolean) 51651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 51751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected boolean instanceFollowRedirects = followRedirects; 51851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 51951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* valid HTTP methods */ 52051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private static final String[] methods = { 52151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski "GET", "POST", "HEAD", "OPTIONS", "PUT", "DELETE", "TRACE" 52251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski }; 52351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 52451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 52551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Constructor for the HttpURLConnection. 52651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param u the URL 52751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 52851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected HttpURLConnection (URL u) { 52951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski super(u); 53051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 53151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 53251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 53351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Sets whether HTTP redirects (requests with response code 3xx) should 53451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * be automatically followed by this class. True by default. Applets 53551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * cannot change this variable. 53651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 53751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If there is a security manager, this method first calls 53851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the security manager's <code>checkSetFactory</code> method 53951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * to ensure the operation is allowed. 54051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This could result in a SecurityException. 54151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 54251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param set a <code>boolean</code> indicating whether or not 54351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * to follow HTTP redirects. 54451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @exception SecurityException if a security manager exists and its 54551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>checkSetFactory</code> method doesn't 54651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * allow the operation. 54751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see SecurityManager#checkSetFactory 54851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #getFollowRedirects() 54951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 55051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static void setFollowRedirects(boolean set) { 55151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski SecurityManager sec = System.getSecurityManager(); 55251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (sec != null) { 55351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // seems to be the best check here... 55451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sec.checkSetFactory(); 55551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 55651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski followRedirects = set; 55751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 55851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 55951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 56051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns a <code>boolean</code> indicating 56151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * whether or not HTTP redirects (3xx) should 56251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * be automatically followed. 56351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 56451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return <code>true</code> if HTTP redirects should 56551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * be automatically followed, <tt>false</tt> if not. 56651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #setFollowRedirects(boolean) 56751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 56851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static boolean getFollowRedirects() { 56951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return followRedirects; 57051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 57151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 57251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 57351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Sets whether HTTP redirects (requests with response code 3xx) should 57451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * be automatically followed by this <code>HttpURLConnection</code> 57551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * instance. 57651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 57751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The default value comes from followRedirects, which defaults to 57851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * true. 57951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 58051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param followRedirects a <code>boolean</code> indicating 58151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * whether or not to follow HTTP redirects. 58251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 58351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#instanceFollowRedirects 58451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #getInstanceFollowRedirects 58551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.3 58651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 58751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public void setInstanceFollowRedirects(boolean followRedirects) { 58851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski instanceFollowRedirects = followRedirects; 58951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 59051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 59151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 59251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the value of this <code>HttpURLConnection</code>'s 59351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>instanceFollowRedirects</code> field. 59451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 59551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the value of this <code>HttpURLConnection</code>'s 59651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>instanceFollowRedirects</code> field. 59751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.net.HttpURLConnection#instanceFollowRedirects 59851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #setInstanceFollowRedirects(boolean) 59951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.3 60051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 60151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public boolean getInstanceFollowRedirects() { 60251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return instanceFollowRedirects; 60351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 60451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 60551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 60651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Set the method for the URL request, one of: 60751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <UL> 60851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>GET 60951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>POST 61051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>HEAD 61151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>OPTIONS 61251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>PUT 61351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>DELETE 61451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <LI>TRACE 61551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * </UL> are legal, subject to protocol restrictions. The default 61651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * method is GET. 61751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 61851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param method the HTTP method 61951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @exception ProtocolException if the method cannot be reset or if 62051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the requested method isn't valid for HTTP. 62151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @exception SecurityException if a security manager is set and the 62251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * method is "TRACE", but the "allowHttpTrace" 62351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * NetPermission is not granted. 62451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #getRequestMethod() 62551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 62651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public void setRequestMethod(String method) throws ProtocolException { 62751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (connected) { 62851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new ProtocolException("Can't reset method: already connected"); 62951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 63051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // This restriction will prevent people from using this class to 63151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // experiment w/ new HTTP methods using java. But it should 63251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // be placed for security - the request String could be 63351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // arbitrarily long. 63451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 63551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski for (int i = 0; i < methods.length; i++) { 63651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (methods[i].equals(method)) { 63751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (method.equals("TRACE")) { 63851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski SecurityManager s = System.getSecurityManager(); 63951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (s != null) { 64051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski s.checkPermission(new NetPermission("allowHttpTrace")); 64151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 64251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 64351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski this.method = method; 64451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return; 64551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 64651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 64751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new ProtocolException("Invalid HTTP method: " + method); 64851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 64951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 65051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 65151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Get the request method. 65251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the HTTP request method 65351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see #setRequestMethod(java.lang.String) 65451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 65551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getRequestMethod() { 65651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return method; 65751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 65851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 65951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 66051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Gets the status code from an HTTP response message. 66151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * For example, in the case of the following status lines: 66251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <PRE> 66351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP/1.0 200 OK 66451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP/1.0 401 Unauthorized 66551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * </PRE> 66651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * It will return 200 and 401 respectively. 66751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns -1 if no code can be discerned 66851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * from the response (i.e., the response is not valid HTTP). 66951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IOException if an error occurred connecting to the server. 67051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the HTTP Status-Code, or -1 67151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 67251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getResponseCode() throws IOException { 67351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 67451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * We're got the response code already 67551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 67651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (responseCode != -1) { 67751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return responseCode; 67851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 67951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 68051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 68151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Ensure that we have connected to the server. Record 68251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * exception as we need to re-throw it if there isn't 68351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * a status line. 68451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 68551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski Exception exc = null; 68651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski try { 68751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski getInputStream(); 68851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } catch (Exception e) { 68951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski exc = e; 69051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 69151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 69251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 69351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If we can't a status-line then re-throw any exception 69451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * that getInputStream threw. 69551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 69651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski String statusLine = getHeaderField(0); 69751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (statusLine == null) { 69851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (exc != null) { 69951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (exc instanceof RuntimeException) 70051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw (RuntimeException)exc; 70151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski else 70251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw (IOException)exc; 70351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 70451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return -1; 70551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 70651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 70751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 70851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Examine the status-line - should be formatted as per 70951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * section 6.1 of RFC 2616 :- 71051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 71151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase 71251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 71351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If status line can't be parsed return -1. 71451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 71551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (statusLine.startsWith("HTTP/1.")) { 71651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski int codePos = statusLine.indexOf(' '); 71751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (codePos > 0) { 71851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 71951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski int phrasePos = statusLine.indexOf(' ', codePos+1); 72051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (phrasePos > 0 && phrasePos < statusLine.length()) { 72151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski responseMessage = statusLine.substring(phrasePos+1); 72251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 72351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 72451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // deviation from RFC 2616 - don't reject status line 72551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // if SP Reason-Phrase is not included. 72651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (phrasePos < 0) 72751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski phrasePos = statusLine.length(); 72851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 72951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski try { 73051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski responseCode = Integer.parseInt 73151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski (statusLine.substring(codePos+1, phrasePos)); 73251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return responseCode; 73351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } catch (NumberFormatException e) { } 73451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 73551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 73651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return -1; 73751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 73851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 73951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 74051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Gets the HTTP response message, if any, returned along with the 74151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * response code from a server. From responses like: 74251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <PRE> 74351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP/1.0 200 OK 74451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP/1.0 404 Not Found 74551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * </PRE> 74651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Extracts the Strings "OK" and "Not Found" respectively. 74751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns null if none could be discerned from the responses 74851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * (the result was not valid HTTP). 74951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IOException if an error occurred connecting to the server. 75051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the HTTP response message, or <code>null</code> 75151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 75251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getResponseMessage() throws IOException { 75351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski getResponseCode(); 75451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return responseMessage; 75551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 75651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 75751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public long getHeaderFieldDate(String name, long Default) { 75851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski String dateString = getHeaderField(name); 75951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski try { 76051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (dateString.indexOf("GMT") == -1) { 76151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski dateString = dateString+" GMT"; 76251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 76351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return Date.parse(dateString); 76451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } catch (Exception e) { 76551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 76651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return Default; 76751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 76851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 76951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 77051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 77151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Indicates that other requests to the server 77251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * are unlikely in the near future. Calling disconnect() 77351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * should not imply that this HttpURLConnection 77451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * instance can be reused for other requests. 77551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 77651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public abstract void disconnect(); 77751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 77851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 77951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Indicates if the connection is going through a proxy. 78051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return a boolean indicating if the connection is 78151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * using a proxy. 78251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 78351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public abstract boolean usingProxy(); 78451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 78551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 78651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns a {@link SocketPermission} object representing the 78751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * permission necessary to connect to the destination host and port. 78851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 78951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @exception IOException if an error occurs while computing 79051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the permission. 79151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 79251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return a <code>SocketPermission</code> object representing the 79351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * permission necessary to connect to the destination 79451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * host and port. 79551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 79651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public Permission getPermission() throws IOException { 79751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski int port = url.getPort(); 79851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski port = port < 0 ? 80 : port; 79951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski String host = url.getHost() + ":" + port; 80051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski Permission permission = new SocketPermission(host, "connect"); 80151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return permission; 80251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 80351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 80451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 80551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the error stream if the connection failed 80651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * but the server sent useful data nonetheless. The 80751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * typical example is when an HTTP server responds 80851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * with a 404, which will cause a FileNotFoundException 80951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * to be thrown in connect, but the server sent an HTML 81051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * help page with suggestions as to what to do. 81151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 81251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p>This method will not cause a connection to be initiated. If 81351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the connection was not connected, or if the server did not have 81451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * an error while connecting or if the server had an error but 81551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * no error data was sent, this method will return null. This is 81651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the default. 81751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 81851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return an error stream if any, null if there have been no 81951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * errors, the connection is not connected or the server sent no 82051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * useful data. 82151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 82251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public InputStream getErrorStream() { 82351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return null; 82451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 82551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 82651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 82751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The response codes for HTTP, as of version 1.1. 82851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 82951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 83051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // REMIND: do we want all these?? 83151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski // Others not here that we do want?? 83251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 83351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 2XX: generally "OK" */ 83451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 83551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 83651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 200: OK. 83751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 83851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_OK = 200; 83951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 84051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 84151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 201: Created. 84251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 84351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_CREATED = 201; 84451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 84551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 84651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 202: Accepted. 84751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 84851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_ACCEPTED = 202; 84951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 85051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 85151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 203: Non-Authoritative Information. 85251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 85351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NOT_AUTHORITATIVE = 203; 85451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 85551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 85651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 204: No Content. 85751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 85851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NO_CONTENT = 204; 85951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 86051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 86151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 205: Reset Content. 86251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 86351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_RESET = 205; 86451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 86551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 86651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 206: Partial Content. 86751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 86851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_PARTIAL = 206; 86951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 87051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 3XX: relocation/redirect */ 87151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 87251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 87351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 300: Multiple Choices. 87451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 87551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_MULT_CHOICE = 300; 87651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 87751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 87851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 301: Moved Permanently. 87951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 88051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_MOVED_PERM = 301; 88151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 88251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 88351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 302: Temporary Redirect. 88451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 88551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_MOVED_TEMP = 302; 88651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 88751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 88851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 303: See Other. 88951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 89051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_SEE_OTHER = 303; 89151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 89251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 89351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 304: Not Modified. 89451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 89551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NOT_MODIFIED = 304; 89651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 89751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 89851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 305: Use Proxy. 89951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 90051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_USE_PROXY = 305; 90151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 90251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 4XX: client error */ 90351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 90451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 90551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 400: Bad Request. 90651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 90751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_BAD_REQUEST = 400; 90851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 90951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 91051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 401: Unauthorized. 91151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 91251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_UNAUTHORIZED = 401; 91351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 91451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 91551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 402: Payment Required. 91651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 91751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_PAYMENT_REQUIRED = 402; 91851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 91951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 92051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 403: Forbidden. 92151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 92251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_FORBIDDEN = 403; 92351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 92451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 92551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 404: Not Found. 92651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 92751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NOT_FOUND = 404; 92851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 92951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 93051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 405: Method Not Allowed. 93151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 93251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_BAD_METHOD = 405; 93351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 93451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 93551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 406: Not Acceptable. 93651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 93751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NOT_ACCEPTABLE = 406; 93851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 93951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 94051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 407: Proxy Authentication Required. 94151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 94251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_PROXY_AUTH = 407; 94351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 94451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 94551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 408: Request Time-Out. 94651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 94751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_CLIENT_TIMEOUT = 408; 94851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 94951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 95051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 409: Conflict. 95151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 95251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_CONFLICT = 409; 95351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 95451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 95551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 410: Gone. 95651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 95751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_GONE = 410; 95851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 95951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 96051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 411: Length Required. 96151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 96251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_LENGTH_REQUIRED = 411; 96351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 96451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 96551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 412: Precondition Failed. 96651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 96751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_PRECON_FAILED = 412; 96851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 96951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 97051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 413: Request Entity Too Large. 97151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 97251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_ENTITY_TOO_LARGE = 413; 97351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 97451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 97551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 414: Request-URI Too Large. 97651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 97751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_REQ_TOO_LONG = 414; 97851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 97951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 98051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 415: Unsupported Media Type. 98151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 98251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_UNSUPPORTED_TYPE = 415; 98351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 98451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /* 5XX: server error */ 98551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 98651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 98751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 500: Internal Server Error. 98851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @deprecated it is misplaced and shouldn't have existed. 98951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 99051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski @Deprecated 99151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_SERVER_ERROR = 500; 99251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 99351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 99451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 500: Internal Server Error. 99551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 99651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_INTERNAL_ERROR = 500; 99751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 99851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 99951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 501: Not Implemented. 100051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 100151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_NOT_IMPLEMENTED = 501; 100251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 100351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 100451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 502: Bad Gateway. 100551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 100651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_BAD_GATEWAY = 502; 100751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 100851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 100951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 503: Service Unavailable. 101051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 101151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_UNAVAILABLE = 503; 101251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 101351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 101451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 504: Gateway Timeout. 101551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 101651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_GATEWAY_TIMEOUT = 504; 101751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 101851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 101951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * HTTP Status-Code 505: HTTP Version Not Supported. 102051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 102151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int HTTP_VERSION = 505; 102251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 102351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski} 1024