| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.commons.httpclient.params.DefaultHttpParams
org.apache.commons.httpclient.params.HttpMethodParams
public class HttpMethodParams
This class represents a collection of HTTP protocol parameters applicable to 
 HTTP methods. Protocol 
 parameters may be linked together to form a hierarchy. If a particular 
 parameter value has not been explicitly defined in the collection itself, 
 its value will be drawn from the parent collection of parameters.
| Field Summary | |
|---|---|
| static String | BUFFER_WARN_TRIGGER_LIMITSets the maximum buffered response size (in bytes) that triggers no warning. | 
| static String | COOKIE_POLICYDefines cookie policyto be used for cookie management. | 
| static String | CREDENTIAL_CHARSETDefines the charset to be used when encoding Credentials. | 
| static String | DATE_PATTERNSThe key used to look up the date patterns used for parsing. | 
| static String | HEAD_BODY_CHECK_TIMEOUTSets period of time in milliseconds to wait for a content body sent in response to HEAD methodfrom a 
 non-compliant server. | 
| static String | HTTP_CONTENT_CHARSETDefines the charset to be used for encoding content body. | 
| static String | HTTP_ELEMENT_CHARSETDefines the charset to be used for encoding HTTP protocol elements. | 
| static String | HTTP_URI_CHARSETDefines the charset to be used for parsing URIs. | 
| static String | MULTIPART_BOUNDARYSets the value to use as the multipart boundary. | 
| static String | PROTOCOL_VERSIONDefines the HTTP protocol versionused byHTTP methodsper
 default. | 
| static String | REJECT_HEAD_BODYDefines whether the content body sent in response to HeadMethodshould be rejected. | 
| static String | RETRY_HANDLERSets the method retry handler parameter. | 
| static String | SINGLE_COOKIE_HEADERDefines whether cookiesshould be put on 
 a singleresponse header. | 
| static String | SO_TIMEOUTSets the socket timeout (SO_TIMEOUT) in milliseconds to be used when executing the method. | 
| static String | STATUS_LINE_GARBAGE_LIMITDefines the maximum number of ignorable lines before we expect a HTTP response's status code. | 
| static String | STRICT_TRANSFER_ENCODINGDefines whether responses with an invalid Transfer-Encoding header should be rejected. | 
| static String | UNAMBIGUOUS_STATUS_LINEDefines whether HTTP methodsshould
 reject ambiguousHTTP status line. | 
| static String | USE_EXPECT_CONTINUEActivates 'Expect: 100-Continue' handshake for the entity enclosing methods. | 
| static String | USER_AGENTDefines the content of the User-Agent header used by HTTP methods. | 
| static String | VIRTUAL_HOSTDefines the virtual host name. | 
| static String | WARN_EXTRA_INPUTDefines HttpClient's behavior when a response provides more bytes than expected (specified with Content-Length, for example). | 
| Constructor Summary | |
|---|---|
| HttpMethodParams()Creates a new collection of parameters with the collection returned by DefaultHttpParams.getDefaultParams()as a parent. | |
| HttpMethodParams(HttpParams defaults)Creates a new collection of parameters with the given parent. | |
| Method Summary | |
|---|---|
|  String | getContentCharset()Returns the default charset to be used for writing content body, when no charset explicitly specified. | 
|  String | getCookiePolicy()Returns cookie policyto be used by theHTTP methodsthis collection of parameters applies to. | 
|  String | getCredentialCharset()Returns the charset to be used for Credentials. | 
|  String | getHttpElementCharset()Returns the charset to be used for writing HTTP headers. | 
|  int | getSoTimeout()Returns the default socket timeout (SO_TIMEOUT) in milliseconds which is the timeout for waiting for data. | 
|  String | getUriCharset()Returns the charset to be used for parsing URIs. | 
|  HttpVersion | getVersion()Returns HTTP protocol versionto be used by theHTTP methodsthat 
 this collection of parameters applies to. | 
|  String | getVirtualHost()Returns the virtual host name. | 
|  void | makeLenient()Makes the HTTP methodsattempt to mimic the exact behaviour of commonly used HTTP agents, 
 which many HTTP servers expect, even though such behaviour may violate   
 the HTTP protocol specification (RFC 2616 and other relevant RFCs). | 
|  void | makeStrict()Makes the HTTP methodsstrictly follow the HTTP protocol specification (RFC 2616 and other relevant RFCs). | 
|  void | setContentCharset(String charset)Sets the default charset to be used for writing content body, when no charset explicitly specified. | 
|  void | setCookiePolicy(String policy)Assigns the cookie policyto be used by theHTTP methodsthis collection of parameters applies to. | 
|  void | setCredentialCharset(String charset)Sets the charset to be used for writing HTTP headers. | 
|  void | setHttpElementCharset(String charset)Sets the charset to be used for writing HTTP headers. | 
|  void | setSoTimeout(int timeout)Sets the default socket timeout (SO_TIMEOUT) in milliseconds which is the timeout for waiting for data. | 
|  void | setUriCharset(String charset)Sets the charset to be used for parsing URIs. | 
|  void | setVersion(HttpVersion version)Assigns the HTTP protocol versionto be used by theHTTP methodsthat 
 this collection of parameters applies to. | 
|  void | setVirtualHost(String hostname)Sets the virtual host name. | 
| Methods inherited from class org.apache.commons.httpclient.params.DefaultHttpParams | 
|---|
| clear, clone, getBooleanParameter, getDefaultParams, getDefaults, getDoubleParameter, getIntParameter, getLongParameter, getParameter, isParameterFalse, isParameterSet, isParameterSetLocally, isParameterTrue, setBooleanParameter, setDefaults, setDoubleParameter, setHttpParamsFactory, setIntParameter, setLongParameter, setParameter, setParameters | 
| Methods inherited from class java.lang.Object | 
|---|
| equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | 
| Field Detail | 
|---|
public static final String USER_AGENT
HTTP methods.
 
 This parameter expects a value of type String.
 
public static final String PROTOCOL_VERSION
HTTP protocol version used by  
 HTTP methods per
 default.
 
 This parameter expects a value of type HttpVersion.
 
public static final String UNAMBIGUOUS_STATUS_LINE
HTTP methods should
 reject ambiguous HTTP status line.
 
 This parameter expects a value of type Boolean.
 
public static final String SINGLE_COOKIE_HEADER
cookies should be put on 
 a single response header.
 
 This parameter expects a value of type Boolean.
 
public static final String STRICT_TRANSFER_ENCODING
 This parameter expects a value of type Boolean.
 
public static final String REJECT_HEAD_BODY
HeadMethod should be rejected.
 
 This parameter expects a value of type Boolean.
 
public static final String HEAD_BODY_CHECK_TIMEOUT
HEAD method from a 
 non-compliant server. If the parameter is not set or set to -1 non-compliant 
 response body check is disabled.
 
 This parameter expects a value of type Integer.
 
public static final String USE_EXPECT_CONTINUE
 Activates 'Expect: 100-Continue' handshake for the 
 entity enclosing methods. 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.
This parameter expects a value of typeBoolean.
public static final String CREDENTIAL_CHARSET
Credentials. If not defined then the 
 HTTP_ELEMENT_CHARSET should be used.
 
 This parameter expects a value of type String.
 
public static final String HTTP_ELEMENT_CHARSET
 This parameter expects a value of type String.
 
public static final String HTTP_URI_CHARSET
 This parameter expects a value of type String.
 
public static final String HTTP_CONTENT_CHARSET
 This parameter expects a value of type String.
 
public static final String COOKIE_POLICY
cookie policy to be used for cookie management.
 
 This parameter expects a value of type String.
 
public static final String WARN_EXTRA_INPUT
Such surplus data makes the HTTP connection unreliable for keep-alive requests, as malicious response data (faked headers etc.) can lead to undesired results on the next request using that connection.
 If this parameter is set to true, any detection of extra
 input data will generate a warning in the log.
 
 This parameter expects a value of type Boolean.
 
public static final String STATUS_LINE_GARBAGE_LIMIT
 With HTTP/1.1 persistent connections, the problem arises that
 broken scripts could return a wrong Content-Length
 (there are more bytes sent than specified).
 Unfortunately, in some cases, this is not possible after the bad response,
 but only before the next one. 
 So, HttpClient must be able to skip those surplus lines this way.
 
 Set this to 0 to disallow any garbage/empty lines before the status line.
 To specify no limit, use Integer.MAX_VALUE (default in lenient mode).
 
Integer.
public static final String SO_TIMEOUT
 This parameter expects a value of type Integer.
 
SocketOptions.SO_TIMEOUT, 
Constant Field Valuespublic static final String DATE_PATTERNS
Collection and must be compatible with 
 SimpleDateFormat.
 
 This parameter expects a value of type Collection.
 
public static final String RETRY_HANDLER
 This parameter expects a value of type HttpMethodRetryHandler.
 
public static final String BUFFER_WARN_TRIGGER_LIMIT
 This parameter expects a value if type Integer.
 
public static final String VIRTUAL_HOST
 This parameter expects a value of type String. 
 
public static final String MULTIPART_BOUNDARY
 This parameter expects a value if type String.
 
MultipartRequestEntity, 
Constant Field Values| Constructor Detail | 
|---|
public HttpMethodParams()
DefaultHttpParams.getDefaultParams() as a parent. The collection will defer
 to its parent for a default value if a particular parameter is not 
 explicitly set in the collection itself.
DefaultHttpParams.getDefaultParams()public HttpMethodParams(HttpParams defaults)
defaults - the parent collection to defer to, if a parameter
 is not explictly set in the collection itself.DefaultHttpParams.getDefaultParams()| Method Detail | 
|---|
public String getHttpElementCharset()
public void setHttpElementCharset(String charset)
charset - The charsetpublic String getContentCharset()
public void setUriCharset(String charset)
charset - The charsetpublic String getUriCharset()
public void setContentCharset(String charset)
charset - The charsetpublic String getCredentialCharset()
Credentials. If
 not configured the HTTP element charset is used.
public void setCredentialCharset(String charset)
charset - The charsetpublic HttpVersion getVersion()
HTTP protocol version to be used by the 
 HTTP methods that 
 this collection of parameters applies to.
HTTP protocol versionpublic void setVersion(HttpVersion version)
HTTP protocol version to be used by the 
 HTTP methods that 
 this collection of parameters applies to.
version - the HTTP protocol versionpublic String getCookiePolicy()
cookie policy to be used by the 
 HTTP methods 
 this collection of parameters applies to.
cookie policypublic void setCookiePolicy(String policy)
cookie policy to be used by the 
 HTTP methods 
 this collection of parameters applies to.
policy - the cookie policypublic int getSoTimeout()
public void setSoTimeout(int timeout)
timeout - Timeout in millisecondspublic void setVirtualHost(String hostname)
hostname - The host namepublic String getVirtualHost()
public void makeStrict()
HTTP methods 
 strictly follow the HTTP protocol specification (RFC 2616 and other relevant RFCs).
 It must be noted that popular HTTP agents have different degree of HTTP protocol 
 compliance and some HTTP serves are programmed to expect the behaviour that does not 
 strictly adhere to the HTTP specification.
public void makeLenient()
HTTP methods
 attempt to mimic the exact behaviour of commonly used HTTP agents, 
 which many HTTP servers expect, even though such behaviour may violate   
 the HTTP protocol specification (RFC 2616 and other relevant RFCs).
| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||