    All Packages  Class Hierarchy  This Package  Previous  Next  Index

# Class java.net.HttpURLConnection

    java.lang.Object
       |
       +----java.net.URLConnection
               |
               +----java.net.HttpURLConnection

public abstract class HttpURLConnection
extends URLConnection

A URLConnection with support for HTTP-specific features. See the spec for details.

##

HTTP_ACCEPTED
HTTP_BAD_GATEWAY
HTTP_BAD_METHOD
HTTP_BAD_REQUEST
  4XX: client error
HTTP_CLIENT_TIMEOUT
HTTP_CONFLICT
HTTP_CREATED
HTTP_ENTITY_TOO_LARGE
HTTP_FORBIDDEN
HTTP_GATEWAY_TIMEOUT
HTTP_GONE
HTTP_INTERNAL_ERROR
HTTP_LENGTH_REQUIRED
HTTP_MOVED_PERM
HTTP_MOVED_TEMP
HTTP_MULT_CHOICE
  3XX: relocation/redirect
HTTP_NO_CONTENT
HTTP_NOT_ACCEPTABLE
HTTP_NOT_AUTHORITATIVE
HTTP_NOT_FOUND
HTTP_NOT_MODIFIED
HTTP_OK
  2XX: generally "OK"
HTTP_PARTIAL
HTTP_PAYMENT_REQUIRED
HTTP_PRECON_FAILED
HTTP_PROXY_AUTH
HTTP_REQ_TOO_LONG
HTTP_RESET
HTTP_SEE_OTHER
HTTP_SERVER_ERROR
  5XX: server error
HTTP_UNAUTHORIZED
HTTP_UNAVAILABLE
HTTP_UNSUPPORTED_TYPE
HTTP_USE_PROXY
HTTP_VERSION
method
responseCode
responseMessage

##

HttpURLConnection(URL)
  Constructor for the URLStreamHandler.

##

disconnect()
  Close the connection to the server.
getFollowRedirects()
getRequestMethod()
  Get the request method.
getResponseCode()
  Gets HTTP response status.
getResponseMessage()
  Gets the HTTP response message, if any, returned along with the response code from a server.
setFollowRedirects(boolean)
  Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this class.
setRequestMethod(String)
  Set the method for the URL request, one of:
  - GET
  - POST
  - HEAD
  - OPTIONS
  - PUT
  - DELETE
  - TRACE
  are legal, subject to protocol restrictions.
usingProxy()
  Indicates if the connection is going through a proxy.

##

method

     protected String method

responseCode

     protected int responseCode

responseMessage

     protected String responseMessage

HTTP_OK

     public static final int HTTP_OK

  2XX: generally "OK"

HTTP_CREATED

     public static final int HTTP_CREATED

HTTP_ACCEPTED

     public static final int HTTP_ACCEPTED

HTTP_NOT_AUTHORITATIVE

     public static final int HTTP_NOT_AUTHORITATIVE

HTTP_NO_CONTENT

     public static final int HTTP_NO_CONTENT

HTTP_RESET

     public static final int HTTP_RESET

HTTP_PARTIAL

     public static final int HTTP_PARTIAL

HTTP_MULT_CHOICE

     public static final int HTTP_MULT_CHOICE

  3XX: relocation/redirect

HTTP_MOVED_PERM

     public static final int HTTP_MOVED_PERM

HTTP_MOVED_TEMP

     public static final int HTTP_MOVED_TEMP

HTTP_SEE_OTHER

     public static final int HTTP_SEE_OTHER

HTTP_NOT_MODIFIED

     public static final int HTTP_NOT_MODIFIED

HTTP_USE_PROXY

     public static final int HTTP_USE_PROXY

HTTP_BAD_REQUEST

     public static final int HTTP_BAD_REQUEST

  4XX: client error

HTTP_UNAUTHORIZED

     public static final int HTTP_UNAUTHORIZED

HTTP_PAYMENT_REQUIRED

     public static final int HTTP_PAYMENT_REQUIRED

HTTP_FORBIDDEN

     public static final int HTTP_FORBIDDEN

HTTP_NOT_FOUND

     public static final int HTTP_NOT_FOUND

HTTP_BAD_METHOD

     public static final int HTTP_BAD_METHOD

HTTP_NOT_ACCEPTABLE

     public static final int HTTP_NOT_ACCEPTABLE

HTTP_PROXY_AUTH

     public static final int HTTP_PROXY_AUTH

HTTP_CLIENT_TIMEOUT

     public static final int HTTP_CLIENT_TIMEOUT

HTTP_CONFLICT

     public static final int HTTP_CONFLICT

HTTP_GONE

     public static final int HTTP_GONE

HTTP_LENGTH_REQUIRED

     public static final int HTTP_LENGTH_REQUIRED

HTTP_PRECON_FAILED

     public static final int HTTP_PRECON_FAILED

HTTP_ENTITY_TOO_LARGE

     public static final int HTTP_ENTITY_TOO_LARGE

HTTP_REQ_TOO_LONG

     public static final int HTTP_REQ_TOO_LONG

HTTP_UNSUPPORTED_TYPE

     public static final int HTTP_UNSUPPORTED_TYPE

HTTP_SERVER_ERROR

     public static final int HTTP_SERVER_ERROR

  5XX: server error

HTTP_INTERNAL_ERROR

     public static final int HTTP_INTERNAL_ERROR

HTTP_BAD_GATEWAY

     public static final int HTTP_BAD_GATEWAY

HTTP_UNAVAILABLE

     public static final int HTTP_UNAVAILABLE

HTTP_GATEWAY_TIMEOUT

     public static final int HTTP_GATEWAY_TIMEOUT

HTTP_VERSION

     public static final int HTTP_VERSION

##

HttpURLConnection

     protected HttpURLConnection(URL u)

  Constructor for the URLStreamHandler.

##

setFollowRedirects

     public static void setFollowRedirects(boolean set)

  Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this class. True by default. Applets cannot change this variable.

getFollowRedirects

     public static boolean getFollowRedirects()

setRequestMethod

     public void setRequestMethod(String method) throws ProtocolException

  Set the method for the URL request, one of:
  - GET
  - POST
  - HEAD
  - OPTIONS
  - PUT
  - DELETE
  - TRACE
  are legal, subject to protocol restrictions. The default method is GET.

  Throws: ProtocolException
    if the method cannot be reset or if the requested method isn't valid for HTTP.

getRequestMethod

     public String getRequestMethod()

  Get the request method.

getResponseCode

     public int getResponseCode() throws IOException

  Gets HTTP response status. From responses like:

       HTTP/1.0 200 OK
       HTTP/1.0 401 Unauthorized

  Extracts the ints 200 and 401 respectively. Returns -1 if none can be discerned from the response (i.e., the response is not valid HTTP).

getResponseMessage

     public String getResponseMessage() throws IOException

  Gets the HTTP response message, if any, returned along with the response code from a server. From responses like:

       HTTP/1.0 200 OK
       HTTP/1.0 404 Not Found

  Extracts the Strings "OK" and "Not Found" respectively. Returns null if none could be discerned from the responses (the result was not valid HTTP).

disconnect

     public abstract void disconnect()

  Close the connection to the server.

usingProxy

     public abstract boolean usingProxy()

  Indicates if the connection is going through a proxy.

    All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature - Version 1.1.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.