Class HttpPost

java.lang.Object

org.apache.http.message.AbstractHttpMessage

org.apache.http.client.methods.AbstractExecutionAwareRequest

org.apache.http.client.methods.HttpRequestBase

org.apache.http.client.methods.HttpEntityEnclosingRequestBase

org.apache.http.client.methods.HttpPost

All Implemented Interfaces:

Cloneable, AbortableHttpRequest, Configurable, HttpExecutionAware, HttpUriRequest, HttpEntityEnclosingRequest, HttpMessage, HttpRequest

@NotThreadSafe
public class HttpPost
extends HttpEntityEnclosingRequestBase

HTTP POST method.

The HTTP POST method is defined in section 9.5 of RFC2616:

The POST method is used to request that the origin server accept the entity enclosed in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line. POST is designed to allow a uniform method to cover the following functions:

• Annotation of existing resources
• Posting a message to a bulletin board, newsgroup, mailing list, or similar group of articles
• Providing a block of data, such as the result of submitting a form, to a data-handling process
• Extending a database through an append operation

Since:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	METHOD_NAME

Fields inherited from class AbstractHttpMessage

headergroup, params

Constructor Summary

Constructors

Constructor	Description
HttpPost()
HttpPost(String uri)
HttpPost(URI uri)

Method Summary

Modifier and Type	Method	Description
String	getMethod()	Returns the HTTP method this request uses, such as GET, PUT, POST, or other.

Methods inherited from class HttpEntityEnclosingRequestBase

clone, expectContinue, getEntity, setEntity

Methods inherited from class HttpRequestBase

getConfig, getProtocolVersion, getRequestLine, getURI, releaseConnection, setConfig, setProtocolVersion, setURI, started, toString

Methods inherited from class AbstractExecutionAwareRequest

abort, completed, isAborted, reset, setCancellable, setConnectionRequest, setReleaseTrigger

Methods inherited from class AbstractHttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, getParams, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface HttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, getParams, getProtocolVersion, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Methods inherited from interface HttpRequest

getRequestLine

Methods inherited from interface HttpUriRequest

abort, isAborted

Field Details

METHOD_NAME

public static final String METHOD_NAME

See Also:

• Constant Field Values

Constructor Details

HttpPost

public HttpPost()

HttpPost

public HttpPost(URI uri)

HttpPost

public HttpPost(String uri)

Throws:

IllegalArgumentException - if the uri is invalid.

Method Details

getMethod

public String getMethod()

Description copied from interface: HttpUriRequest

Returns the HTTP method this request uses, such as GET, PUT, POST, or other.

Specified by:

getMethod in interface HttpUriRequest

Specified by:

getMethod in class HttpRequestBase