org.apache.commons.httpclient.methods

Class HeadMethod

Implemented Interfaces:
HttpMethod

public class HeadMethod
extends HttpMethodBase

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.
Version:
$Revision: 155418 $
Authors:
Remy Maucherat
Mike Bowler
Jeff Dever
oleg Kalnichevski
Since:
1.0

Constructor Summary

HeadMethod()
No-arg constructor.
HeadMethod(String uri)
Constructor specifying a URI.

Method Summary

int
getBodyCheckTimeout()
Deprecated. Use HttpMethodParams
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)
Deprecated. Use HttpMethodParams

Methods inherited from class org.apache.commons.httpclient.HttpMethodBase

abort, addCookieRequestHeader, addHostRequestHeader, addProxyConnectionHeader, addRequestHeader, addRequestHeader, addRequestHeaders, addResponseFooter, addUserAgentRequestHeader, checkNotUsed, checkUsed, execute, generateRequestLine, getAuthenticationRealm, getContentCharSet, getDoAuthentication, getEffectiveVersion, getFollowRedirects, getHostAuthState, getHostConfiguration, getMethodRetryHandler, getName, getParams, getPath, getProxyAuthState, getProxyAuthenticationRealm, getQueryString, getRecoverableExceptionCount, getRequestCharSet, getRequestHeader, getRequestHeaderGroup, getRequestHeaders, getRequestHeaders, getResponseBody, getResponseBodyAsStream, getResponseBodyAsString, getResponseCharSet, getResponseContentLength, getResponseFooter, getResponseFooters, getResponseHeader, getResponseHeaderGroup, getResponseHeaders, getResponseHeaders, getResponseStream, getResponseTrailerHeaderGroup, getStatusCode, getStatusLine, getStatusText, getURI, hasBeenUsed, isAborted, isConnectionCloseForced, isHttp11, isRequestSent, isStrictMode, processResponseBody, processResponseHeaders, processStatusLine, readResponse, readResponseBody, readResponseHeaders, readStatusLine, recycle, releaseConnection, removeRequestHeader, removeRequestHeader, responseBodyConsumed, setConnectionCloseForced, setDoAuthentication, setFollowRedirects, setHostConfiguration, setHttp11, setMethodRetryHandler, setParams, setPath, setQueryString, setQueryString, setRequestHeader, setRequestHeader, setResponseStream, setStrictMode, setURI, shouldCloseConnection, validate, writeRequest, writeRequestBody, writeRequestHeaders, writeRequestLine

Constructor Details

HeadMethod

public HeadMethod()
No-arg constructor.
Since:
1.0

HeadMethod

public HeadMethod(String uri)
Constructor specifying a URI.
Parameters:
uri - either an absolute or relative URI
Since:
1.0

Method Details

getBodyCheckTimeout

public int getBodyCheckTimeout()

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

getName

public String getName()
Returns "HEAD".
Specified by:
getName in interface HttpMethod
Overrides:
getName in interface HttpMethodBase
Returns:
"HEAD"
Since:
2.0

readResponseBody

protected void readResponseBody(HttpState state,
                                HttpConnection conn)
            throws HttpException,
                   IOException
Overrides HttpMethodBase method to not read a response body, despite the presence of a Content-Length or Transfer-Encoding header.
Overrides:
readResponseBody in interface HttpMethodBase
Parameters:
state - the state information associated with this method
conn - the connection used to execute this HTTP method
Throws:
HttpException - if a protocol exception occurs. Usually protocol exceptions cannot be recovered from.
Since:
2.0
See Also:
HeadMethod, HeadMethod

recycle

public void recycle()

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.
Specified by:
recycle in interface HttpMethod
Overrides:
recycle in interface HttpMethodBase
Since:
1.0

setBodyCheckTimeout

public void setBodyCheckTimeout(int timeout)

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

Copyright (c) 1999-2005 - Apache Software Foundation