Package org.apache.hc.client5.http.entity.mime

Class MultipartEntityBuilder

java.lang.Object

org.apache.hc.client5.http.entity.mime.MultipartEntityBuilder

public class MultipartEntityBuilder
extends java.lang.Object

Builder for multipart HttpEntitys.

Since:

5.0

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.String	boundary
private java.nio.charset.Charset	charset
private org.apache.hc.core5.http.ContentType	contentType
private static org.apache.hc.core5.http.NameValuePair[]	EMPTY_NAME_VALUE_ARRAY	An empty immutable NameValuePair array.
private HttpMultipartMode	mode
private static char[]	MULTIPART_CHARS	The pool of ASCII chars to be used for generating a multipart boundary.
private java.util.List<MultipartPart>	multipartParts

Constructor Summary

Constructors

Constructor	Description
MultipartEntityBuilder()

Method Summary

Modifier and Type	Method	Description
MultipartEntityBuilder	addBinaryBody(java.lang.String name, byte[] b)
MultipartEntityBuilder	addBinaryBody(java.lang.String name, byte[] b, org.apache.hc.core5.http.ContentType contentType, java.lang.String filename)
MultipartEntityBuilder	addBinaryBody(java.lang.String name, java.io.File file)
MultipartEntityBuilder	addBinaryBody(java.lang.String name, java.io.File file, org.apache.hc.core5.http.ContentType contentType, java.lang.String filename)
MultipartEntityBuilder	addBinaryBody(java.lang.String name, java.io.InputStream stream)
MultipartEntityBuilder	addBinaryBody(java.lang.String name, java.io.InputStream stream, org.apache.hc.core5.http.ContentType contentType, java.lang.String filename)
MultipartEntityBuilder	addParameter(org.apache.hc.core5.http.message.BasicNameValuePair parameter)	Add parameter to the current ContentType.
MultipartEntityBuilder	addPart(java.lang.String name, ContentBody contentBody)
MultipartEntityBuilder	addPart(MultipartPart multipartPart)
MultipartEntityBuilder	addTextBody(java.lang.String name, java.lang.String text)
MultipartEntityBuilder	addTextBody(java.lang.String name, java.lang.String text, org.apache.hc.core5.http.ContentType contentType)
org.apache.hc.core5.http.HttpEntity	build()
(package private) MultipartFormEntity	buildEntity()
static MultipartEntityBuilder	create()
private java.lang.String	generateBoundary()
MultipartEntityBuilder	setBoundary(java.lang.String boundary)
MultipartEntityBuilder	setCharset(java.nio.charset.Charset charset)
MultipartEntityBuilder	setContentType(org.apache.hc.core5.http.ContentType contentType)
MultipartEntityBuilder	setLaxMode()
MultipartEntityBuilder	setMimeSubtype(java.lang.String subType)
MultipartEntityBuilder	setMode(HttpMultipartMode mode)
MultipartEntityBuilder	setStrictMode()

Methods inherited from class java.lang.Object

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

Field Detail

MULTIPART_CHARS

private static final char[] MULTIPART_CHARS

The pool of ASCII chars to be used for generating a multipart boundary.

contentType

private org.apache.hc.core5.http.ContentType contentType

mode

private HttpMultipartMode mode

boundary

private java.lang.String boundary

charset

private java.nio.charset.Charset charset

multipartParts

private java.util.List<MultipartPart> multipartParts

EMPTY_NAME_VALUE_ARRAY

private static final org.apache.hc.core5.http.NameValuePair[] EMPTY_NAME_VALUE_ARRAY

An empty immutable NameValuePair array.

Constructor Detail

MultipartEntityBuilder

MultipartEntityBuilder()

Method Detail

create

public static MultipartEntityBuilder create()

setMode

public MultipartEntityBuilder setMode(HttpMultipartMode mode)

setLaxMode

public MultipartEntityBuilder setLaxMode()

setStrictMode

public MultipartEntityBuilder setStrictMode()

setBoundary

public MultipartEntityBuilder setBoundary(java.lang.String boundary)

setMimeSubtype

public MultipartEntityBuilder setMimeSubtype(java.lang.String subType)

Since:

4.4

setContentType

public MultipartEntityBuilder setContentType(org.apache.hc.core5.http.ContentType contentType)

Since:

4.5

addParameter

public MultipartEntityBuilder addParameter(org.apache.hc.core5.http.message.BasicNameValuePair parameter)

Add parameter to the current ContentType.

Parameters:

parameter - The name-value pair parameter to add to the ContentType.

Returns:

the MultipartEntityBuilder instance.

Since:

5.2

setCharset

public MultipartEntityBuilder setCharset(java.nio.charset.Charset charset)

addPart

public MultipartEntityBuilder addPart(MultipartPart multipartPart)

Since:

4.4

addPart

public MultipartEntityBuilder addPart(java.lang.String name,
                                      ContentBody contentBody)

addTextBody

public MultipartEntityBuilder addTextBody(java.lang.String name,
                                          java.lang.String text,
                                          org.apache.hc.core5.http.ContentType contentType)

addTextBody

public MultipartEntityBuilder addTextBody(java.lang.String name,
                                          java.lang.String text)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            byte[] b,
                                            org.apache.hc.core5.http.ContentType contentType,
                                            java.lang.String filename)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            byte[] b)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            java.io.File file,
                                            org.apache.hc.core5.http.ContentType contentType,
                                            java.lang.String filename)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            java.io.File file)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            java.io.InputStream stream,
                                            org.apache.hc.core5.http.ContentType contentType,
                                            java.lang.String filename)

addBinaryBody

public MultipartEntityBuilder addBinaryBody(java.lang.String name,
                                            java.io.InputStream stream)

generateBoundary

private java.lang.String generateBoundary()

buildEntity

MultipartFormEntity buildEntity()

build

public org.apache.hc.core5.http.HttpEntity build()