Package org.apache.commons.httpclient.methods

Class TraceMethod

java.lang.Object

org.apache.commons.httpclient.HttpMethodBase

org.apache.commons.httpclient.methods.TraceMethod

All Implemented Interfaces:

HttpMethod

@Deprecated
public class TraceMethod
extends HttpMethodBase

Deprecated.

Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.

Implements the HTTP TRACE method.

The HTTP TRACE method is defined in section 9.6 of RFC2616:

The TRACE method is used to invoke a remote, application-layer loop- back of the request message. The final recipient of the request SHOULD reflect the message received back to the client as the entity-body of a 200 (OK) response. The final recipient is either the origin server or the first proxy or gateway to receive a Max-Forwards value of zero (0) in the request (see section 14.31). A TRACE request MUST NOT include an entity.

Since:

2.0

Constructor Summary

Constructors

Constructor	Description
TraceMethod(String uri)	Deprecated. Constructor specifying a URI.

Method Summary

Modifier and Type	Method	Description
String	getName()	Deprecated. Returns "TRACE".
void	recycle()	Deprecated. no longer supported and will be removed in the future version of HttpClient

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

abort, addRequestHeader, addRequestHeader, addResponseFooter, execute, getAuthenticationRealm, getDoAuthentication, getEffectiveVersion, getFollowRedirects, getHostAuthState, getHostConfiguration, getMethodRetryHandler, getParams, getPath, getProxyAuthenticationRealm, getProxyAuthState, getQueryString, getRecoverableExceptionCount, getRequestCharSet, getRequestHeader, getRequestHeaders, getRequestHeaders, getResponseBody, getResponseBody, getResponseBodyAsStream, getResponseBodyAsString, getResponseBodyAsString, getResponseCharSet, getResponseContentLength, getResponseFooter, getResponseFooters, getResponseHeader, getResponseHeaders, getResponseHeaders, getStatusCode, getStatusLine, getStatusText, getURI, hasBeenUsed, isAborted, isHttp11, isRequestSent, isStrictMode, releaseConnection, removeRequestHeader, removeRequestHeader, setDoAuthentication, setFollowRedirects, setHostConfiguration, setHttp11, setMethodRetryHandler, setParams, setPath, setQueryString, setQueryString, setRequestHeader, setRequestHeader, setStrictMode, setURI, validate

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TraceMethod

public TraceMethod(String uri)

Deprecated.

Constructor specifying a URI.

Parameters:

uri - either an absolute or relative URI

Since:

2.0

Method Details

getName

public String getName()

Deprecated.

Returns "TRACE".

Specified by:

getName in interface HttpMethod

Specified by:

getName in class HttpMethodBase

Returns:

"TRACE"

Since:

2.0

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 class HttpMethodBase

Since:

2.0

See Also:

• HttpMethodBase.releaseConnection()