org.apache.commons.httpclient.methods
public class HeadMethod extends HttpMethodBase
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.
Since: 1.0
Version: $Revision: 480424 $
Constructor Summary | |
---|---|
HeadMethod()
No-arg constructor.
| |
HeadMethod(String uri)
Constructor specifying a URI.
|
Method Summary | |
---|---|
int | getBodyCheckTimeout()
Returns non-compliant response body check timeout.
|
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()
Recycles the HTTP method so that it can be used again.
|
void | setBodyCheckTimeout(int timeout)
Sets non-compliant response body check timeout.
|
Since: 1.0
Parameters: uri either an absolute or relative URI
Since: 1.0
Deprecated: Use HttpMethodParams
Returns non-compliant response body check timeout.Returns: The period of time in milliseconds to wait for a response body from a non-compliant server. -1 returned when non-compliant response body check is disabled
See Also: HeadMethod HttpMethodParams HEAD_BODY_CHECK_TIMEOUT
Returns: "HEAD"
Since: 2.0
Parameters: state the state
information associated with this method conn the connection
used to execute
this HTTP method
Throws: IOException if an I/O (transport) error occurs. Some transport exceptions can be recovered from. HttpException if a protocol exception occurs. Usually protocol exceptions cannot be recovered from.
Since: 2.0
See Also: HeadMethod HeadMethod
Deprecated: no longer supported and will be removed in the future version of HttpClient
Recycles the HTTP method so that it can be used again. Note that all of the instance variables will be reset once this method has been called. This method will also release the connection being used by this HTTP method.Since: 1.0
Deprecated: Use HttpMethodParams
Sets non-compliant response body check timeout.Parameters: 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
See Also: HeadMethod HttpMethodParams HEAD_BODY_CHECK_TIMEOUT