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

Class EntityBuilder

java.lang.Object

org.apache.hc.client5.http.entity.EntityBuilder

public class EntityBuilder
extends Object

Builder for HttpEntity instances.

Several setter methods of this builder are mutually exclusive. In case of multiple invocations of the following methods only the last one will have effect:

• setText(String)
• setBinary(byte[])
• setStream(java.io.InputStream)
• setSerializable(java.io.Serializable)
• setParameters(java.util.List)
• setParameters(NameValuePair...)
• setFile(java.io.File)

Since:

4.3

Field Summary

Fields

Modifier and Type	Field	Description
private byte[]	binary
private boolean	chunked
private String	contentEncoding
private org.apache.hc.core5.http.ContentType	contentType
private File	file
private boolean	gzipCompressed
private List<org.apache.hc.core5.http.NameValuePair>	parameters
private Serializable	serializable
private InputStream	stream
private String	text

Constructor Summary

Constructors

Constructor	Description
EntityBuilder()

Method Summary

Modifier and Type	Method	Description
org.apache.hc.core5.http.HttpEntity	build()	Builds a new instance of HttpEntity based on the current state.
EntityBuilder	chunked()	Sets entities to be chunked.
private void	clearContent()
static EntityBuilder	create()
byte[]	getBinary()	Gets entity content as a byte array if set using setBinary(byte[]).
String	getContentEncoding()	Gets the content encoding of the entity, may be null.
private org.apache.hc.core5.http.ContentType	getContentOrDefault(org.apache.hc.core5.http.ContentType def)
org.apache.hc.core5.http.ContentType	getContentType()	Gets the ContentType of the entity, may be null.
File	getFile()	Gets the entity content as a File if set using setFile(java.io.File).
List<org.apache.hc.core5.http.NameValuePair>	getParameters()	Gets entity content as a parameter list if set using setParameters(java.util.List) or setParameters(NameValuePair...).
Serializable	getSerializable()	Gets entity content as a Serializable if set using setSerializable(java.io.Serializable) method.
InputStream	getStream()	Gets entity content as an InputStream if set using setStream(java.io.InputStream) method.
String	getText()	Gets the entity content as a string if set using setText(String).
EntityBuilder	gzipCompressed()	Sets entities to be GZIP compressed.
boolean	isChunked()	Tests if the entity is to be chunk coded (true), or not (false).
boolean	isGzipCompressed()	Tests if entities are to be GZIP compressed (true), or not (false).
EntityBuilder	setBinary(byte[] binary)	Sets entity content as a byte array.
EntityBuilder	setContentEncoding(String contentEncoding)	Sets the content encoding of the entity.
EntityBuilder	setContentType(org.apache.hc.core5.http.ContentType contentType)	Sets the ContentType of the entity.
EntityBuilder	setFile(File file)	Sets entity content as a File.
EntityBuilder	setParameters(List<org.apache.hc.core5.http.NameValuePair> parameters)	Sets entity content as a parameter list.
EntityBuilder	setParameters(org.apache.hc.core5.http.NameValuePair... parameters)	Sets entity content as a parameter list.
EntityBuilder	setSerializable(Serializable serializable)	Sets entity content as a Serializable.
EntityBuilder	setStream(InputStream stream)	Sets entity content as an InputStream.
EntityBuilder	setText(String text)	Sets entity content as a string.

Methods inherited from class java.lang.Object

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

Field Details

text

private String text

binary

private byte[] binary

stream

private InputStream stream

parameters

private List<org.apache.hc.core5.http.NameValuePair> parameters

serializable

private Serializable serializable

file

private File file

contentType

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

contentEncoding

private String contentEncoding

chunked

private boolean chunked

gzipCompressed

private boolean gzipCompressed

Constructor Details

EntityBuilder

EntityBuilder()

Method Details

create

public static EntityBuilder create()

clearContent

private void clearContent()

getText

public String getText()

Gets the entity content as a string if set using setText(String).

Returns:

the entity content as a string, may be null.

setText

public EntityBuilder setText(String text)

Sets entity content as a string. This method is mutually exclusive with setBinary(byte[]), setStream(java.io.InputStream), setSerializable(java.io.Serializable), setParameters(java.util.List), setParameters(NameValuePair...) setFile(java.io.File) methods.

Parameters:

text - entity content as a string.

Returns:

this

getBinary

public byte[] getBinary()

Gets entity content as a byte array if set using setBinary(byte[]).

Returns:

entity content as a byte array.

setBinary

public EntityBuilder setBinary(byte[] binary)

Sets entity content as a byte array. This method is mutually exclusive with setText(String), setStream(java.io.InputStream), setSerializable(java.io.Serializable), setParameters(java.util.List), setParameters(NameValuePair...) setFile(java.io.File).

Parameters:

binary - The new entity content as a byte array.

Returns:

this

getStream

public InputStream getStream()

Gets entity content as an InputStream if set using setStream(java.io.InputStream) method.

Returns:

entity content as an InputStream

setStream

public EntityBuilder setStream(InputStream stream)

Sets entity content as an InputStream. This method is mutually exclusive with setText(String), setBinary(byte[]), setSerializable(java.io.Serializable), setParameters(java.util.List), setParameters(NameValuePair...) setFile(java.io.File).

Parameters:

stream - The new entity content as an InputStream.

Returns:

this

getParameters

public List<org.apache.hc.core5.http.NameValuePair> getParameters()

Gets entity content as a parameter list if set using setParameters(java.util.List) or setParameters(NameValuePair...).

Returns:

entity content as a parameter list.

setParameters

public EntityBuilder setParameters(List<org.apache.hc.core5.http.NameValuePair> parameters)

Sets entity content as a parameter list. This method is mutually exclusive with setText(String), setBinary(byte[]), setStream(java.io.InputStream), setSerializable(java.io.Serializable), setFile(java.io.File).

Parameters:

parameters - entity content as a parameter list.

Returns:

this

setParameters

public EntityBuilder setParameters(org.apache.hc.core5.http.NameValuePair... parameters)

Sets entity content as a parameter list. This method is mutually exclusive with setText(String), setBinary(byte[]), setStream(java.io.InputStream), setSerializable(java.io.Serializable), setFile(java.io.File).

Parameters:

parameters - entity content as a parameter list.

Returns:

this

getSerializable

public Serializable getSerializable()

Gets entity content as a Serializable if set using setSerializable(java.io.Serializable) method.

Returns:

entity content as a Serializable.

setSerializable

public EntityBuilder setSerializable(Serializable serializable)

Sets entity content as a Serializable. This method is mutually exclusive with setText(String), setBinary(byte[]), setStream(java.io.InputStream), setParameters(java.util.List), setParameters(NameValuePair...) setFile(java.io.File).

Parameters:

serializable - entity content as a Serializable.

Returns:

this

getFile

public File getFile()

Gets the entity content as a File if set using setFile(java.io.File).

Returns:

Gets the entity content as a File.

setFile

public EntityBuilder setFile(File file)

Sets entity content as a File. This method is mutually exclusive with setText(String), setBinary(byte[]), setStream(java.io.InputStream), setParameters(java.util.List), setParameters(NameValuePair...) setSerializable(java.io.Serializable).

Parameters:

file - entity content as a File.

Returns:

this

getContentType

public org.apache.hc.core5.http.ContentType getContentType()

Gets the ContentType of the entity, may be null.

Returns:

the ContentType of the entity, may be null.

setContentType

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

Sets the ContentType of the entity.

Parameters:

contentType - the ContentType of the entity, may be null.

Returns:

this

getContentEncoding

public String getContentEncoding()

Gets the content encoding of the entity, may be null.

Returns:

the content encoding of the entity, may be null.

setContentEncoding

public EntityBuilder setContentEncoding(String contentEncoding)

Sets the content encoding of the entity.

Parameters:

contentEncoding - the content encoding of the entity, may be null.

Returns:

this

isChunked

public boolean isChunked()

Tests if the entity is to be chunk coded (true), or not (false).

Returns:

true if entity is to be chunk coded, false otherwise.

chunked

public EntityBuilder chunked()

Sets entities to be chunked.

Returns:

this

isGzipCompressed

public boolean isGzipCompressed()

Tests if entities are to be GZIP compressed (true), or not (false).

Returns:

true if entity is to be GZIP compressed, false otherwise.

gzipCompressed

public EntityBuilder gzipCompressed()

Sets entities to be GZIP compressed.

Returns:

this

getContentOrDefault

private org.apache.hc.core5.http.ContentType getContentOrDefault(org.apache.hc.core5.http.ContentType def)

build

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

Builds a new instance of HttpEntity based on the current state.

Returns:

a new instance.