org.apache.commons.httpclient.util
Class HttpURLConnection
java.lang.Object
|
+--java.net.URLConnection
|
+--java.net.HttpURLConnection
|
+--org.apache.commons.httpclient.util.HttpURLConnection
- public class HttpURLConnection
- extends HttpURLConnection
Provides a HttpURLConnection
wrapper around HttpClient's
HttpMethod
. This allows existing code to easily switch to
HttpClieht without breaking existing interfaces using the JDK
HttpURLConnection.
Note 1: The current implementations wraps only a connected
HttpMethod
, ie a method that has alreayd been used to connect
to an HTTP server.
Note 2: It is a best try effort as different version of the JDK have
different behaviours for HttpURLConnection
(And I'm not even
including the numerous HttpURLConnection
bugs!).
- Since:
- 2.0
- Version:
- $Id: HttpURLConnection.java,v 1.11 2003/01/31 00:33:37 jsdever Exp $
- Author:
- Vincent Massol, Jeff Dever, Mike Bowler
Fields inherited from class java.net.HttpURLConnection |
HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, 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, HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE, HTTP_NOT_FOUND, HTTP_NOT_IMPLEMENTED, HTTP_NOT_MODIFIED, HTTP_OK, HTTP_PARTIAL, HTTP_PAYMENT_REQUIRED, HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, HTTP_SEE_OTHER, HTTP_SERVER_ERROR, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, instanceFollowRedirects, method, responseCode, responseMessage |
Methods inherited from class java.net.URLConnection |
addRequestProperty, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getExpiration, getFileNameMap, getHeaderFieldInt, getHeaderFields, getLastModified, getRequestProperties, guessContentTypeFromName, guessContentTypeFromStream, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setFileNameMap, toString |
HttpURLConnection
public HttpURLConnection(HttpMethod method,
URL url)
- Creates an
HttpURLConnection
from a HttpMethod
.
- Parameters:
method
- the theMethod that was used to connect to the HTTP
server and which contains the returned data.url
- the URL to which we are connected (includes query string)
HttpURLConnection
protected HttpURLConnection(URL url)
- Create an instance.
- Parameters:
url
- The URL.- See Also:
HttpURLConnection.HttpURLConnection(URL)
getInputStream
public InputStream getInputStream()
throws IOException
- Gets an input stream for the HttpMethod response body.
- Overrides:
getInputStream
in class URLConnection
- Returns:
- The input stream.
- Throws:
IOException
- If an IO problem occurs.- See Also:
URLConnection.getInputStream()
,
HttpMethod.getResponseBodyAsStream()
getErrorStream
public InputStream getErrorStream()
- Not yet implemented.
Return the error stream.
- Overrides:
getErrorStream
in class HttpURLConnection
- See Also:
HttpURLConnection.getErrorStream()
disconnect
public void disconnect()
- Not yet implemented.
- Specified by:
disconnect
in class HttpURLConnection
- See Also:
HttpURLConnection.disconnect()
connect
public void connect()
throws IOException
- Not available: the data must have already been retrieved.
- Specified by:
connect
in class URLConnection
- Throws:
IOException
- If an IO problem occurs.- See Also:
URLConnection.connect()
usingProxy
public boolean usingProxy()
- Not yet implemented.
- Specified by:
usingProxy
in class HttpURLConnection
- Returns:
- true if we are using a proxy.
- See Also:
HttpURLConnection.usingProxy()
getRequestMethod
public String getRequestMethod()
- Return the request method.
- Overrides:
getRequestMethod
in class HttpURLConnection
- Returns:
- The request method.
- See Also:
HttpURLConnection.getRequestMethod()
,
HttpMethod.getName()
getResponseCode
public int getResponseCode()
throws IOException
- Return the response code.
- Overrides:
getResponseCode
in class HttpURLConnection
- Returns:
- The response code.
- Throws:
IOException
- If an IO problem occurs.- See Also:
HttpURLConnection.getResponseCode()
,
HttpMethod.getStatusCode()
getResponseMessage
public String getResponseMessage()
throws IOException
- Return the response message
- Overrides:
getResponseMessage
in class HttpURLConnection
- Returns:
- The response message
- Throws:
IOException
- If an IO problem occurs.- See Also:
HttpURLConnection.getResponseMessage()
,
HttpMethod.getStatusText()
getHeaderField
public String getHeaderField(String name)
- Return the header field
- Overrides:
getHeaderField
in class URLConnection
- Parameters:
name
- the name of the header
- Returns:
- the header field.
- See Also:
URLConnection.getHeaderField(String)
,
HttpMethod.getResponseHeaders()
getHeaderFieldKey
public String getHeaderFieldKey(int keyPosition)
- Return the header field key
- Overrides:
getHeaderFieldKey
in class URLConnection
- Parameters:
keyPosition
- The key position
- Returns:
- The header field key.
- See Also:
URLConnection.getHeaderFieldKey(int)
,
HttpMethod.getResponseHeaders()
getHeaderField
public String getHeaderField(int position)
- Return the header field at the specified position
- Overrides:
getHeaderField
in class URLConnection
- Parameters:
position
- The position
- Returns:
- The header field.
- See Also:
URLConnection.getHeaderField(int)
,
HttpMethod.getResponseHeaders()
getURL
public URL getURL()
- Return the URL
- Overrides:
getURL
in class URLConnection
- Returns:
- The URL.
- See Also:
URLConnection.getURL()
setInstanceFollowRedirects
public void setInstanceFollowRedirects(boolean isFollowingRedirects)
- Not available: the data must have already been retrieved.
- Overrides:
setInstanceFollowRedirects
in class HttpURLConnection
- See Also:
HttpURLConnection.setInstanceFollowRedirects(boolean)
getInstanceFollowRedirects
public boolean getInstanceFollowRedirects()
- Not yet implemented.
- Overrides:
getInstanceFollowRedirects
in class HttpURLConnection
- See Also:
HttpURLConnection.getInstanceFollowRedirects()
setRequestMethod
public void setRequestMethod(String method)
throws ProtocolException
- Not available: the data must have already been retrieved.
- Overrides:
setRequestMethod
in class HttpURLConnection
ProtocolException
- See Also:
HttpURLConnection.setRequestMethod(String)
getPermission
public Permission getPermission()
throws IOException
- Not yet implemented.
- Overrides:
getPermission
in class HttpURLConnection
IOException
- See Also:
HttpURLConnection.getPermission()
getContent
public Object getContent()
throws IOException
- Not yet implemented.
- Overrides:
getContent
in class URLConnection
IOException
- See Also:
URLConnection.getContent()
getContent
public Object getContent(Class[] classes)
throws IOException
- Not yet implemented.
- Overrides:
getContent
in class URLConnection
IOException
- See Also:
URLConnection.getContent(Class[])
getOutputStream
public OutputStream getOutputStream()
throws IOException
- Overrides:
getOutputStream
in class URLConnection
IOException
- See Also:
URLConnection.getOutputStream()
setDoInput
public void setDoInput(boolean isInput)
- Not available: the data must have already been retrieved.
- Overrides:
setDoInput
in class URLConnection
- See Also:
URLConnection.setDoInput(boolean)
getDoInput
public boolean getDoInput()
- Not yet implemented.
- Overrides:
getDoInput
in class URLConnection
- See Also:
URLConnection.getDoInput()
setDoOutput
public void setDoOutput(boolean isOutput)
- Not available: the data must have already been retrieved.
- Overrides:
setDoOutput
in class URLConnection
- See Also:
URLConnection.setDoOutput(boolean)
getDoOutput
public boolean getDoOutput()
- Not yet implemented.
- Overrides:
getDoOutput
in class URLConnection
- See Also:
URLConnection.getDoOutput()
setAllowUserInteraction
public void setAllowUserInteraction(boolean isAllowInteraction)
- Not available: the data must have already been retrieved.
- Overrides:
setAllowUserInteraction
in class URLConnection
- See Also:
URLConnection.setAllowUserInteraction(boolean)
getAllowUserInteraction
public boolean getAllowUserInteraction()
- Not yet implemented.
- Overrides:
getAllowUserInteraction
in class URLConnection
- See Also:
URLConnection.getAllowUserInteraction()
setUseCaches
public void setUseCaches(boolean isUsingCaches)
- Not available: the data must have already been retrieved.
- Overrides:
setUseCaches
in class URLConnection
- See Also:
URLConnection.setUseCaches(boolean)
getUseCaches
public boolean getUseCaches()
- Not yet implemented.
- Overrides:
getUseCaches
in class URLConnection
- See Also:
URLConnection.getUseCaches()
setIfModifiedSince
public void setIfModifiedSince(long modificationDate)
- Not available: the data must have already been retrieved.
- Overrides:
setIfModifiedSince
in class URLConnection
- See Also:
URLConnection.setIfModifiedSince(long)
getIfModifiedSince
public long getIfModifiedSince()
- Not yet implemented.
- Overrides:
getIfModifiedSince
in class URLConnection
- See Also:
URLConnection.getIfModifiedSince()
getDefaultUseCaches
public boolean getDefaultUseCaches()
- Not available: the data must have already been retrieved.
- Overrides:
getDefaultUseCaches
in class URLConnection
- See Also:
URLConnection.getDefaultUseCaches()
setDefaultUseCaches
public void setDefaultUseCaches(boolean isUsingCaches)
- Not available: the data must have already been retrieved.
- Overrides:
setDefaultUseCaches
in class URLConnection
- See Also:
URLConnection.setDefaultUseCaches(boolean)
setRequestProperty
public void setRequestProperty(String key,
String value)
- Not available: the data must have already been retrieved.
- Overrides:
setRequestProperty
in class URLConnection
- See Also:
URLConnection.setRequestProperty(String,String)
getRequestProperty
public String getRequestProperty(String key)
- Not yet implemented.
- Overrides:
getRequestProperty
in class URLConnection
- See Also:
URLConnection.getRequestProperty(String)
Copyright (c) 1999-2002 - Apache Software Foundation