java.net
public abstract class HttpURLConnection extends URLConnection
Modifier and Type | Field and Description |
---|---|
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_NO_CONTENT
The server performed the request, but there is no data to send
back.
|
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_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
Deprecated.
|
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.
|
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches
Modifier | Constructor and Description |
---|---|
protected |
HttpURLConnection(URL url)
Create an HttpURLConnection for the specified URL
|
Modifier and Type | Method and Description |
---|---|
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
|
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldInt, getHeaderFieldKey, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString
public static final int HTTP_OK
public static final int HTTP_CREATED
public static final int HTTP_ACCEPTED
public static final int HTTP_NOT_AUTHORITATIVE
public static final int HTTP_NO_CONTENT
public static final int HTTP_RESET
public static final int HTTP_PARTIAL
public static final int HTTP_MULT_CHOICE
public static final int HTTP_MOVED_PERM
public static final int HTTP_MOVED_TEMP
public static final int HTTP_SEE_OTHER
public static final int HTTP_NOT_MODIFIED
public static final int HTTP_USE_PROXY
public static final int HTTP_BAD_REQUEST
public static final int HTTP_UNAUTHORIZED
public static final int HTTP_PAYMENT_REQUIRED
public static final int HTTP_FORBIDDEN
public static final int HTTP_NOT_FOUND
public static final int HTTP_BAD_METHOD
public static final int HTTP_NOT_ACCEPTABLE
public static final int HTTP_PROXY_AUTH
public static final int HTTP_CLIENT_TIMEOUT
public static final int HTTP_CONFLICT
public static final int HTTP_GONE
public static final int HTTP_LENGTH_REQUIRED
public static final int HTTP_PRECON_FAILED
public static final int HTTP_ENTITY_TOO_LARGE
public static final int HTTP_REQ_TOO_LONG
public static final int HTTP_UNSUPPORTED_TYPE
public static final int HTTP_SERVER_ERROR
public static final int HTTP_INTERNAL_ERROR
public static final int HTTP_NOT_IMPLEMENTED
public static final int HTTP_BAD_GATEWAY
public static final int HTTP_UNAVAILABLE
public static final int HTTP_GATEWAY_TIMEOUT
public static final int HTTP_VERSION
protected int responseCode
protected String responseMessage
protected boolean instanceFollowRedirects
protected HttpURLConnection(URL url)
url
- The URL to create this connection for.public abstract void disconnect()
public abstract boolean usingProxy()
public static void setFollowRedirects(boolean set)
set
- true if redirects should be followed, false otherwis.SecurityException
- If a security manager exists and its
checkSetFactory method doesn't allow the operationpublic static boolean getFollowRedirects()
public boolean getInstanceFollowRedirects()
public void setInstanceFollowRedirects(boolean follow)
follow
- true to enable following redirects, false otherwisepublic void setRequestMethod(String method) throws ProtocolException
method
- the method to useProtocolException
- If the method cannot be reset or if the
requested method isn't valid for HTTPpublic String getRequestMethod()
public int getResponseCode() throws IOException
IOException
- If an error occurspublic String getResponseMessage() throws IOException
IOException
- If an error occurspublic Permission getPermission() throws IOException
getPermission
in class URLConnection
IOException
- If an error occurspublic InputStream getErrorStream()
null
.InputStream
for reading error data.public long getHeaderFieldDate(String key, long value)
getHeaderFieldDate
in class URLConnection
key
- the key of the header fieldvalue
- the default value if the header field is not present