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.12 2003/04/22 18:11:01 olegk 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, 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.
- 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.
- See Also:
HttpURLConnection.getErrorStream()
disconnect
public void disconnect()
- Not yet implemented.
- See Also:
HttpURLConnection.disconnect()
connect
public void connect()
throws IOException
- Not available: the data must have already been retrieved.
- Throws:
IOException
- If an IO problem occurs.- See Also:
URLConnection.connect()
usingProxy
public boolean usingProxy()
- Not yet implemented.
- Returns:
- true if we are using a proxy.
- See Also:
HttpURLConnection.usingProxy()
getRequestMethod
public String getRequestMethod()
- Return the request method.
- Returns:
- The request method.
- See Also:
HttpURLConnection.getRequestMethod()
,
HttpMethod.getName()
getResponseCode
public int getResponseCode()
throws IOException
- Return the response code.
- 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
- 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
- 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
- Parameters:
keyPosition
- The key position
- Returns:
- The header field key.
- See Also:
HttpURLConnection.getHeaderFieldKey(int)
,
HttpMethod.getResponseHeaders()
getHeaderField
public String getHeaderField(int position)
- Return the header field at the specified position
- Parameters:
position
- The position
- Returns:
- The header field.
- See Also:
HttpURLConnection.getHeaderField(int)
,
HttpMethod.getResponseHeaders()
getURL
public URL getURL()
- Return the URL
- Returns:
- The URL.
- See Also:
URLConnection.getURL()
setInstanceFollowRedirects
public void setInstanceFollowRedirects(boolean isFollowingRedirects)
- Not available: the data must have already been retrieved.
getInstanceFollowRedirects
public boolean getInstanceFollowRedirects()
- Not yet implemented.
setRequestMethod
public void setRequestMethod(String method)
throws ProtocolException
- Not available: the data must have already been retrieved.
- Throws:
ProtocolException
- See Also:
HttpURLConnection.setRequestMethod(String)
getPermission
public Permission getPermission()
throws IOException
- Not yet implemented.
- Throws:
IOException
- See Also:
HttpURLConnection.getPermission()
getContent
public Object getContent()
throws IOException
- Not yet implemented.
- Throws:
IOException
- See Also:
URLConnection.getContent()
getContent
public Object getContent(Class[] classes)
throws IOException
- Not yet implemented.
- Throws:
IOException
getOutputStream
public OutputStream getOutputStream()
throws IOException
- Throws:
IOException
- See Also:
URLConnection.getOutputStream()
setDoInput
public void setDoInput(boolean isInput)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setDoInput(boolean)
getDoInput
public boolean getDoInput()
- Not yet implemented.
- See Also:
URLConnection.getDoInput()
setDoOutput
public void setDoOutput(boolean isOutput)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setDoOutput(boolean)
getDoOutput
public boolean getDoOutput()
- Not yet implemented.
- See Also:
URLConnection.getDoOutput()
setAllowUserInteraction
public void setAllowUserInteraction(boolean isAllowInteraction)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setAllowUserInteraction(boolean)
getAllowUserInteraction
public boolean getAllowUserInteraction()
- Not yet implemented.
- See Also:
URLConnection.getAllowUserInteraction()
setUseCaches
public void setUseCaches(boolean isUsingCaches)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setUseCaches(boolean)
getUseCaches
public boolean getUseCaches()
- Not yet implemented.
- See Also:
URLConnection.getUseCaches()
setIfModifiedSince
public void setIfModifiedSince(long modificationDate)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setIfModifiedSince(long)
getIfModifiedSince
public long getIfModifiedSince()
- Not yet implemented.
- See Also:
URLConnection.getIfModifiedSince()
getDefaultUseCaches
public boolean getDefaultUseCaches()
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.getDefaultUseCaches()
setDefaultUseCaches
public void setDefaultUseCaches(boolean isUsingCaches)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setDefaultUseCaches(boolean)
setRequestProperty
public void setRequestProperty(String key,
String value)
- Not available: the data must have already been retrieved.
- See Also:
URLConnection.setRequestProperty(String,String)
getRequestProperty
public String getRequestProperty(String key)
- Not yet implemented.
- See Also:
URLConnection.getRequestProperty(String)
Copyright (c) 1999-2003 - Apache Software Foundation