package com.turbomanage.httpclient;
import com.turbomanage.httpclient.multipart.BodyPart;
import com.turbomanage.httpclient.multipart.MultipartWrapper;
import java.util.Collection;
/**
* An HTTP POST request.
*
* @author David M. Chandler
*/
public class HttpPost extends HttpRequest {
/**
* Constructs an HTTP POST request with name-value pairs to
* be sent in the request BODY.
*
* @param path Partial URL
* @param params Name-value pairs to be sent in request BODY
*/
public HttpPost(String path, ParameterMap params) {
super(path, null);
this.httpMethod = HttpMethod.POST;
this.path = path;
this.contentType = URLENCODED;
if (params != null) {
this.content = params.urlEncodedBytes();
}
}
/**
* Constructs an HTTP POST request with arbitrary content.
* If params is non-null, the name-value pairs will be appended to the QUERY STRING
* while the content is sent in the request BODY.
* This is not a common use case and is therefore not represented in the post()
* methods in {@link AbstractHttpClient} or {@link AsyncHttpClient},
* but is nevertheless possible using this constructor.
*
* @param path Partial URL
* @param params Optional name-value pairs to be appended to QUERY STRING
* @param contentType MIME type
* @param data Content to be sent in the request body
*/
public HttpPost(String path, ParameterMap params, String contentType, byte[] data) {
super(path, params);
this.httpMethod = HttpMethod.POST;
this.contentType = contentType;
this.content = data;
}
/**
* Constructs an HTTP POST request with arbitrary content.
* If params is non-null, the name-value pairs will be appended to the QUERY STRING
* Uses multipart/form-data to send the files with the request
*
* @param path Partial URL
* @param params Optional name-value pairs to be appended to QUERY STRING
* @param parts Content to be sent using multipart-form data
*/
public HttpPost(String path, ParameterMap params, Collection<BodyPart> parts)
{
super(path, params);
this.httpMethod = HttpMethod.POST;
this.contentType = MULTIPART;
this.multipartWrapper = new MultipartWrapper(Long.toHexString(System.currentTimeMillis()), parts);
}
}