Class HttpSupport


  • public class HttpSupport
    extends java.lang.Object
    Extra utilities to support usage of HTTP.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void encode​(java.lang.StringBuilder urlstr, java.lang.String key)
      URL encode a value string into an output buffer.
      static java.net.Proxy proxyFor​(java.net.ProxySelector proxySelector, java.net.URL u)
      Determine the proxy server (if any) needed to obtain a URL.
      static int response​(java.net.HttpURLConnection c)
      Get the HTTP response code from the request.
      static int response​(HttpConnection c)
      Get the HTTP response code from the request.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • METHOD_GET

        public static final java.lang.String METHOD_GET
        The GET HTTP method.
        See Also:
        Constant Field Values
      • METHOD_POST

        public static final java.lang.String METHOD_POST
        The POST HTTP method.
        See Also:
        Constant Field Values
      • HDR_CACHE_CONTROL

        public static final java.lang.String HDR_CACHE_CONTROL
        The Cache-Control header.
        See Also:
        Constant Field Values
      • HDR_PRAGMA

        public static final java.lang.String HDR_PRAGMA
        The Pragma header.
        See Also:
        Constant Field Values
      • HDR_USER_AGENT

        public static final java.lang.String HDR_USER_AGENT
        The User-Agent header.
        See Also:
        Constant Field Values
      • HDR_DATE

        public static final java.lang.String HDR_DATE
        The Date header.
        See Also:
        Constant Field Values
      • HDR_EXPIRES

        public static final java.lang.String HDR_EXPIRES
        The Expires header.
        See Also:
        Constant Field Values
      • HDR_ETAG

        public static final java.lang.String HDR_ETAG
        The ETag header.
        See Also:
        Constant Field Values
      • HDR_IF_NONE_MATCH

        public static final java.lang.String HDR_IF_NONE_MATCH
        The If-None-Match header.
        See Also:
        Constant Field Values
      • HDR_LAST_MODIFIED

        public static final java.lang.String HDR_LAST_MODIFIED
        The Last-Modified header.
        See Also:
        Constant Field Values
      • HDR_IF_MODIFIED_SINCE

        public static final java.lang.String HDR_IF_MODIFIED_SINCE
        The If-Modified-Since header.
        See Also:
        Constant Field Values
      • HDR_ACCEPT

        public static final java.lang.String HDR_ACCEPT
        The Accept header.
        See Also:
        Constant Field Values
      • HDR_CONTENT_TYPE

        public static final java.lang.String HDR_CONTENT_TYPE
        The Content-Type header.
        See Also:
        Constant Field Values
      • HDR_CONTENT_LENGTH

        public static final java.lang.String HDR_CONTENT_LENGTH
        The Content-Length header.
        See Also:
        Constant Field Values
      • HDR_CONTENT_ENCODING

        public static final java.lang.String HDR_CONTENT_ENCODING
        The Content-Encoding header.
        See Also:
        Constant Field Values
      • HDR_CONTENT_RANGE

        public static final java.lang.String HDR_CONTENT_RANGE
        The Content-Range header.
        See Also:
        Constant Field Values
      • HDR_ACCEPT_RANGES

        public static final java.lang.String HDR_ACCEPT_RANGES
        The Accept-Ranges header.
        See Also:
        Constant Field Values
      • HDR_IF_RANGE

        public static final java.lang.String HDR_IF_RANGE
        The If-Range header.
        See Also:
        Constant Field Values
      • HDR_RANGE

        public static final java.lang.String HDR_RANGE
        The Range header.
        See Also:
        Constant Field Values
      • HDR_ACCEPT_ENCODING

        public static final java.lang.String HDR_ACCEPT_ENCODING
        The Accept-Encoding header.
        See Also:
        Constant Field Values
      • TEXT_PLAIN

        public static final java.lang.String TEXT_PLAIN
        The standard text/plain MIME type.
        See Also:
        Constant Field Values
      • HDR_AUTHORIZATION

        public static final java.lang.String HDR_AUTHORIZATION
        The Authorization header.
        See Also:
        Constant Field Values
      • HDR_WWW_AUTHENTICATE

        public static final java.lang.String HDR_WWW_AUTHENTICATE
        The WWW-Authenticate header.
        See Also:
        Constant Field Values
    • Method Detail

      • encode

        public static void encode​(java.lang.StringBuilder urlstr,
                                  java.lang.String key)
        URL encode a value string into an output buffer.
        Parameters:
        urlstr - the output buffer.
        key - value which must be encoded to protected special characters.
      • response

        public static int response​(HttpConnection c)
                            throws java.io.IOException
        Get the HTTP response code from the request.

        Roughly the same as c.getResponseCode() but the ConnectException is translated to be more understandable.

        Parameters:
        c - connection the code should be obtained from.
        Returns:
        r HTTP status code, usually 200 to indicate success. See HttpConnection for other defined constants.
        Throws:
        java.io.IOException - communications error prevented obtaining the response code.
        Since:
        3.3
      • response

        public static int response​(java.net.HttpURLConnection c)
                            throws java.io.IOException
        Get the HTTP response code from the request.

        Roughly the same as c.getResponseCode() but the ConnectException is translated to be more understandable.

        Parameters:
        c - connection the code should be obtained from.
        Returns:
        r HTTP status code, usually 200 to indicate success. See HttpConnection for other defined constants.
        Throws:
        java.io.IOException - communications error prevented obtaining the response code.
      • proxyFor

        public static java.net.Proxy proxyFor​(java.net.ProxySelector proxySelector,
                                              java.net.URL u)
                                       throws java.net.ConnectException
        Determine the proxy server (if any) needed to obtain a URL.
        Parameters:
        proxySelector - proxy support for the caller.
        u - location of the server caller wants to talk to.
        Returns:
        proxy to communicate with the supplied URL.
        Throws:
        java.net.ConnectException - the proxy could not be computed as the supplied URL could not be read. This failure should never occur.