java.net
public abstract class HttpURLConnection extends URLConnection
Since: 1.1
| Field Summary | |
|---|---|
| static int | HTTP_ACCEPTED
The request has been accepted for processing but has not completed.
|
| static int | HTTP_BAD_GATEWAY
The proxy encountered a bad response from the server it was proxy-ing for |
| static int | HTTP_BAD_METHOD
The specified request method is not allowed for this resource. |
| static int | HTTP_BAD_REQUEST
The request was misformed or could not be understood. |
| static int | HTTP_CLIENT_TIMEOUT
The request timed out. |
| static int | HTTP_CONFLICT
There is a conflict between the current state of the resource and the
requested action. |
| static int | HTTP_CREATED
The requested resource has been created. |
| static int | HTTP_ENTITY_TOO_LARGE
The request sent was too large for the server to handle. |
| static int | HTTP_FORBIDDEN
There is no permission to access the requested resource. |
| static int | HTTP_GATEWAY_TIMEOUT
The proxy timed out getting a reply from the remote server it was
proxy-ing for. |
| static int | HTTP_GONE
The requested resource is no longer available. |
| static int | HTTP_INTERNAL_ERROR
The server encountered an unexpected error (such as a CGI script crash)
that prevents the request from being fulfilled. |
| static int | HTTP_LENGTH_REQUIRED
A Content-Length header is required for this request, but was not
supplied. |
| static int | HTTP_MOVED_PERM
The resource has been permanently moved to a new location. |
| static int | HTTP_MOVED_TEMP
The resource requested has been temporarily moved to a new location. |
| static int | HTTP_MULT_CHOICE
There is a list of choices available for the requested resource. |
| static int | HTTP_NOT_ACCEPTABLE
Based on the input headers sent, the resource returned in response
to the request would not be acceptable to the client. |
| static int | HTTP_NOT_AUTHORITATIVE
The meta-information returned in the header is not the actual data
from the original server, but may be from a local or other copy.
|
| static int | HTTP_NOT_FOUND
The requested resource was not found. |
| static int | HTTP_NOT_IMPLEMENTED
The server does not support the requested functionality. |
| static int | HTTP_NOT_MODIFIED
The document has not been modified since the criteria specified in
a conditional GET. |
| static int | HTTP_NO_CONTENT
The server performed the request, but there is no data to send
back. |
| static int | HTTP_OK
Indicates the request succeeded. |
| static int | HTTP_PARTIAL
The server completed the partial GET request for the resource. |
| static int | HTTP_PAYMENT_REQUIRED
Code reserved for future use - I hope way in the future. |
| static int | HTTP_PRECON_FAILED
A client specified pre-condition was not met on the server. |
| static int | HTTP_PROXY_AUTH
The client must authenticate with a proxy prior to attempting this
request. |
| static int | HTTP_REQ_TOO_LONG
The name of the resource specified was too long. |
| static int | HTTP_RESET
The server performed the request, but there is no data to sent back,
however, the user's display should be "reset" to clear out any form
fields entered. |
| static int | HTTP_SEE_OTHER
The response to the request issued is available at another location. |
| static int | HTTP_SERVER_ERROR
This error code indicates that some sort of server error occurred.
|
| static int | HTTP_UNAUTHORIZED
The request made requires user authorization. |
| static int | HTTP_UNAVAILABLE
The HTTP service is not availalble, such as because it is overloaded
and does not want additional requests. |
| static int | HTTP_UNSUPPORTED_TYPE
The request is in a format not supported by the requested resource. |
| static int | HTTP_USE_PROXY
The requested resource needs to be accessed through a proxy. |
| static int | HTTP_VERSION
This server does not support the protocol version requested. |
| protected boolean | instanceFollowRedirects
If this instance should follow redirect requests. |
| protected String | method
The requested method in use for this connection. |
| protected int | responseCode
The response code received from the server |
| protected String | responseMessage
The response message string received from the server. |
| Constructor Summary | |
|---|---|
| protected | HttpURLConnection(URL url)
Create an HttpURLConnection for the specified URL
|
| Method Summary | |
|---|---|
| abstract void | disconnect()
Closes the connection to the server. |
| InputStream | getErrorStream()
This method allows the caller to retrieve any data that might have
been sent despite the fact that an error occurred. |
| static boolean | getFollowRedirects()
Returns a boolean indicating whether or not HTTP redirects will
automatically be followed or not.
|
| long | getHeaderFieldDate(String key, long value)
Returns the value of the named field parsed as date
|
| boolean | getInstanceFollowRedirects()
Returns the value of this HttpURLConnection's instanceFollowRedirects
field
|
| Permission | getPermission()
Returns a permission object representing the permission necessary to make
the connection represented by this object
|
| String | getRequestMethod()
The request method currently in use for this connection.
|
| int | getResponseCode()
Gets the status code from an HTTP response message, or -1 if
the response code could not be determined.
|
| String | getResponseMessage()
Gets the HTTP response message, if any, returned along with the
response code from a server. |
| static void | setFollowRedirects(boolean set)
Sets whether HTTP redirects (requests with response code 3xx) should be
automatically followed by this class. |
| void | setInstanceFollowRedirects(boolean follow)
Sets the value of this HttpURLConnection's instanceFollowRedirects field
|
| void | setRequestMethod(String method)
Set the method for the URL request, one of:
GET POST HEAD OPTIONS PUT DELETE TRACE are legal
|
| abstract boolean | usingProxy()
Returns a boolean indicating whether or not this connection is going
through a proxy
|
Since: 1.3
Deprecated:
This error code indicates that some sort of server error occurred.Parameters: url The URL to create this connection for.
null.
Returns: An InputStream for reading error data.
Returns: true if redirects will be followed, false otherwise
Parameters: key the key of the header field value the default value if the header field is not present
Returns: the value of the header field
Returns: true if following redirects is enabled, false otherwise
Returns: the permission necessary for this connection
Throws: IOException If an error occurs
Returns: The request method
Returns: The response code
Throws: IOException If an error occurs
Returns: The response message
Throws: IOException If an error occurs
Parameters: set true if redirects should be followed, false otherwis.
Throws: SecurityException If a security manager exists and its checkSetFactory method doesn't allow the operation
Parameters: follow true to enable following redirects, false otherwise
Parameters: method the method to use
Throws: ProtocolException If the method cannot be reset or if the requested method isn't valid for HTTP
Returns: true if through a proxy, false otherwise