| java.lang.Object
 org.apache.commons.httpclient.HttpMethodBase
org.apache.commons.httpclient.methods.ExpectContinueMethod
All known Subclasses: org.apache.commons.httpclient.methods.MultipartPostMethod, org.apache.commons.httpclient.methods.EntityEnclosingMethod,
| ExpectContinueMethod | | abstract public class ExpectContinueMethod extends HttpMethodBase (Code) | |
This abstract class serves as a foundation for all HTTP methods
that support 'Expect: 100-continue' handshake.
The purpose of the 100 (Continue) status (refer to section 10.1.1
of the RFC 2616 for more details) is to allow a client that is
sending a request message with a request body to determine if the
origin server is willing to accept the request (based on the request
headers) before the client sends the request body. In some cases,
it might either be inappropriate or highly inefficient for the
client to send the body if the server will reject the message
without looking at the body.
'Expect: 100-continue' handshake should be used with caution,
as it may cause problems with HTTP servers and proxies that
do not support HTTP/1.1 protocol.
author:
Oleg Kalnichevski
since:
2.0beta1 |
| Method Summary | |
| protected void | addRequestHeaders(HttpState state, HttpConnection conn)
Sets the Expect header if it has not already been set,
in addition to the "standard" set of headers.
Parameters:
state - the HttpState state information associated with this method
Parameters:
conn - the HttpConnection connection used to executethis HTTP method
throws:
IOException - if an I/O (transport) error occurs. | | public boolean | getUseExpectHeader()
Returns true if the 'Expect: 100-Continue' handshake
is activated. | | abstract protected boolean | hasRequestContent()
Returns true if there is a request body to be sent. | | public void | setUseExpectHeader(boolean value)
Activates 'Expect: 100-Continue' handshake. |
| ExpectContinueMethod | | public ExpectContinueMethod()(Code) | | No-arg constructor.
since:
2.0 |
| ExpectContinueMethod | | public ExpectContinueMethod(String uri)(Code) | | Constructor specifying a URI.
Parameters:
uri - either an absolute or relative URI
since:
2.0 |
| addRequestHeaders | | protected void addRequestHeaders(HttpState state, HttpConnection conn) throws IOException, HttpException(Code) | | Sets the Expect header if it has not already been set,
in addition to the "standard" set of headers.
Parameters:
state - the HttpState state information associated with this method
Parameters:
conn - the HttpConnection connection used to executethis HTTP method
throws:
IOException - if an I/O (transport) error occurs. Some transport exceptionscan be recovered from.
throws:
HttpException - if a protocol exception occurs. Usually protocol exceptions cannot be recovered from. |
| getUseExpectHeader | | public boolean getUseExpectHeader()(Code) | |
Returns true if the 'Expect: 100-Continue' handshake
is activated. The purpose of the 'Expect: 100-Continue'
handshake to allow a client that is sending a request message
with a request body to determine if the origin server is
willing to accept the request (based on the request headers)
before the client sends the request body.
true if 'Expect: 100-Continue' handshake is tobe used, false otherwise.
since:
2.0beta1HttpMethodParams
See Also: ExpectContinueMethod.getParams()
See Also: HttpMethodParams
See Also: HttpMethodParams.USE_EXPECT_CONTINUE |
| hasRequestContent | | abstract protected boolean hasRequestContent()(Code) | | Returns true if there is a request body to be sent.
'Expect: 100-continue' handshake may not be used if request
body is not present
boolean
since:
2.0beta1 |
| setUseExpectHeader | | public void setUseExpectHeader(boolean value)(Code) | |
Activates 'Expect: 100-Continue' handshake. The purpose of
the 'Expect: 100-Continue' handshake to allow a client that is
sending a request message with a request body to determine if
the origin server is willing to accept the request (based on
the request headers) before the client sends the request body.
The use of the 'Expect: 100-continue' handshake can result in
noticable peformance improvement for entity enclosing requests
(such as POST and PUT) that require the target server's
authentication.
'Expect: 100-continue' handshake should be used with
caution, as it may cause problems with HTTP servers and
proxies that do not support HTTP/1.1 protocol.
Parameters:
value - boolean value
since:
2.0beta1HttpMethodParams
See Also: ExpectContinueMethod.getParams()
See Also: HttpMethodParams
See Also: HttpMethodParams.USE_EXPECT_CONTINUE |
| Methods inherited from org.apache.commons.httpclient.HttpMethodBase | public void abort()(Code)(Java Doc)
protected void addCookieRequestHeader(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void addHostRequestHeader(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void addProxyConnectionHeader(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
public void addRequestHeader(Header header)(Code)(Java Doc)
public void addRequestHeader(String headerName, String headerValue)(Code)(Java Doc)
protected void addRequestHeaders(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
public void addResponseFooter(Header footer)(Code)(Java Doc)
protected void addUserAgentRequestHeader(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void checkNotUsed() throws IllegalStateException(Code)(Java Doc)
protected void checkUsed() throws IllegalStateException(Code)(Java Doc)
public int execute(HttpState state, HttpConnection conn) throws HttpException, IOException(Code)(Java Doc)
protected static String generateRequestLine(HttpConnection connection, String name, String requestPath, String query, String version)(Code)(Java Doc)
public String getAuthenticationRealm()(Code)(Java Doc)
protected String getContentCharSet(Header contentheader)(Code)(Java Doc)
public boolean getDoAuthentication()(Code)(Java Doc)
public HttpVersion getEffectiveVersion()(Code)(Java Doc)
public boolean getFollowRedirects()(Code)(Java Doc)
public AuthState getHostAuthState()(Code)(Java Doc)
public HostConfiguration getHostConfiguration()(Code)(Java Doc)
public MethodRetryHandler getMethodRetryHandler()(Code)(Java Doc)
abstract public String getName()(Code)(Java Doc)
public HttpMethodParams getParams()(Code)(Java Doc)
public String getPath()(Code)(Java Doc)
public AuthState getProxyAuthState()(Code)(Java Doc)
public String getProxyAuthenticationRealm()(Code)(Java Doc)
public String getQueryString()(Code)(Java Doc)
public int getRecoverableExceptionCount()(Code)(Java Doc)
public String getRequestCharSet()(Code)(Java Doc)
public Header getRequestHeader(String headerName)(Code)(Java Doc)
protected HeaderGroup getRequestHeaderGroup()(Code)(Java Doc)
public Header[] getRequestHeaders()(Code)(Java Doc)
public Header[] getRequestHeaders(String headerName)(Code)(Java Doc)
public byte[] getResponseBody() throws IOException(Code)(Java Doc)
public byte[] getResponseBody(int maxlen) throws IOException(Code)(Java Doc)
public InputStream getResponseBodyAsStream() throws IOException(Code)(Java Doc)
public String getResponseBodyAsString() throws IOException(Code)(Java Doc)
public String getResponseBodyAsString(int maxlen) throws IOException(Code)(Java Doc)
public String getResponseCharSet()(Code)(Java Doc)
public long getResponseContentLength()(Code)(Java Doc)
public Header getResponseFooter(String footerName)(Code)(Java Doc)
public Header[] getResponseFooters()(Code)(Java Doc)
public Header getResponseHeader(String headerName)(Code)(Java Doc)
protected HeaderGroup getResponseHeaderGroup()(Code)(Java Doc)
public Header[] getResponseHeaders(String headerName)(Code)(Java Doc)
public Header[] getResponseHeaders()(Code)(Java Doc)
protected InputStream getResponseStream()(Code)(Java Doc)
protected HeaderGroup getResponseTrailerHeaderGroup()(Code)(Java Doc)
public int getStatusCode()(Code)(Java Doc)
public StatusLine getStatusLine()(Code)(Java Doc)
public String getStatusText()(Code)(Java Doc)
public URI getURI() throws URIException(Code)(Java Doc)
public boolean hasBeenUsed()(Code)(Java Doc)
public boolean isAborted()(Code)(Java Doc)
protected boolean isConnectionCloseForced()(Code)(Java Doc)
public boolean isHttp11()(Code)(Java Doc)
public boolean isRequestSent()(Code)(Java Doc)
public boolean isStrictMode()(Code)(Java Doc)
protected void processCookieHeaders(CookieSpec parser, Header[] headers, HttpState state, HttpConnection conn)(Code)(Java Doc)
protected void processResponseBody(HttpState state, HttpConnection conn)(Code)(Java Doc)
protected void processResponseHeaders(HttpState state, HttpConnection conn)(Code)(Java Doc)
protected void processStatusLine(HttpState state, HttpConnection conn)(Code)(Java Doc)
protected void readResponse(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void readResponseBody(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void readResponseHeaders(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void readStatusLine(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
public void recycle()(Code)(Java Doc)
public void releaseConnection()(Code)(Java Doc)
public void removeRequestHeader(String headerName)(Code)(Java Doc)
public void removeRequestHeader(Header header)(Code)(Java Doc)
protected void responseBodyConsumed()(Code)(Java Doc)
protected void setConnectionCloseForced(boolean b)(Code)(Java Doc)
public void setDoAuthentication(boolean doAuthentication)(Code)(Java Doc)
public void setFollowRedirects(boolean followRedirects)(Code)(Java Doc)
public void setHostConfiguration(HostConfiguration hostconfig)(Code)(Java Doc)
public void setHttp11(boolean http11)(Code)(Java Doc)
public void setMethodRetryHandler(MethodRetryHandler handler)(Code)(Java Doc)
public void setParams(HttpMethodParams params)(Code)(Java Doc)
public void setPath(String path)(Code)(Java Doc)
public void setQueryString(String queryString)(Code)(Java Doc)
public void setQueryString(NameValuePair[] params)(Code)(Java Doc)
public void setRequestHeader(String headerName, String headerValue)(Code)(Java Doc)
public void setRequestHeader(Header header)(Code)(Java Doc)
protected void setResponseStream(InputStream responseStream)(Code)(Java Doc)
public void setStrictMode(boolean strictMode)(Code)(Java Doc)
public void setURI(URI uri) throws URIException(Code)(Java Doc)
protected boolean shouldCloseConnection(HttpConnection conn)(Code)(Java Doc)
public boolean validate()(Code)(Java Doc)
protected void writeRequest(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected boolean writeRequestBody(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void writeRequestHeaders(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
protected void writeRequestLine(HttpState state, HttpConnection conn) throws IOException, HttpException(Code)(Java Doc)
|
|
|