|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.httpclient.HttpMethodBase
org.apache.commons.httpclient.methods.HeadMethod
Implements the HTTP HEAD method.
The HTTP HEAD method is defined in section 9.4 of RFC2616:
The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response. The metainformation contained in the HTTP headers in response to a HEAD request SHOULD be identical to the information sent in response to a GET request. This method can be used for obtaining metainformation about the entity implied by the request without transferring the entity-body itself. This method is often used for testing hypertext links for validity, accessibility, and recent modification.
Field Summary |
---|
Fields inherited from class org.apache.commons.httpclient.HttpMethodBase |
---|
USER_AGENT |
Constructor Summary | |
---|---|
HeadMethod()
No-arg constructor. |
|
HeadMethod(java.lang.String uri)
Constructor specifying a URI. |
Method Summary | |
---|---|
int |
getBodyCheckTimeout()
Return non-compliant response body check timeout. |
java.lang.String |
getName()
Returns "HEAD". |
protected void |
readResponseBody(HttpState state,
HttpConnection conn)
Overrides HttpMethodBase method to not read a response
body, despite the presence of a Content-Length or
Transfer-Encoding header. |
void |
recycle()
Deprecated. no longer supported and will be removed in the future version of HttpClient |
void |
setBodyCheckTimeout(int timeout)
Set non-compliant response body check timeout. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public HeadMethod()
public HeadMethod(java.lang.String uri)
uri
- either an absolute or relative URIMethod Detail |
public java.lang.String getName()
getName
in interface HttpMethod
getName
in class HttpMethodBase
public void recycle()
recycle
in interface HttpMethod
recycle
in class HttpMethodBase
HttpMethodBase.releaseConnection()
protected void readResponseBody(HttpState state, HttpConnection conn) throws java.io.IOException
HttpMethodBase
method to not read a response
body, despite the presence of a Content-Length or
Transfer-Encoding header.
readResponseBody
in class HttpMethodBase
state
- the state
information associated with this methodconn
- the connection
used to execute
this HTTP method
java.io.IOException
- if an I/O (transport) error occurs
HttpException
- if a protocol exception occurs.
HttpRecoverableException
- if a recoverable transport error occurs.
Usually this kind of exceptions can be recovered from by
retrying the HTTP methodHttpMethodBase.readResponse(org.apache.commons.httpclient.HttpState, org.apache.commons.httpclient.HttpConnection)
,
HttpMethodBase.processResponseBody(org.apache.commons.httpclient.HttpState, org.apache.commons.httpclient.HttpConnection)
public int getBodyCheckTimeout()
public void setBodyCheckTimeout(int timeout)
timeout
- The period of time in milliseconds to wait for a response
body from a non-compliant server. -1 can be used to
disable non-compliant response body check
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |