org.apache.http.entity

Class AbstractHttpEntityHC4

java.lang.Object

org.apache.http.entity.AbstractHttpEntityHC4

All Implemented Interfaces:

org.apache.http.HttpEntity

Direct Known Subclasses:

BasicHttpEntityHC4, ByteArrayEntityHC4, FileEntityHC4, InputStreamEntityHC4, SerializableEntityHC4, StringEntityHC4

@NotThreadSafe
public abstract class AbstractHttpEntityHC4
extends java.lang.Object
implements org.apache.http.HttpEntity

Abstract base class for entities. Provides the commonly used attributes for streamed and self-contained implementations of HttpEntity.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	chunked
protected org.apache.http.Header	contentEncoding
protected org.apache.http.Header	contentType
protected static int	OUTPUT_BUFFER_SIZE Buffer size for output stream processing.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractHttpEntityHC4() Protected default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	consumeContent() Deprecated. (4.1) Either use HttpEntity.getContent() and call InputStream.close() on that; otherwise call HttpEntity.writeTo(java.io.OutputStream) which is required to free the resources.
org.apache.http.Header	getContentEncoding() Obtains the Content-Encoding header.
org.apache.http.Header	getContentType() Obtains the Content-Type header.
boolean	isChunked() Obtains the 'chunked' flag.
void	setChunked(boolean b) Specifies the 'chunked' flag.
void	setContentEncoding(org.apache.http.Header contentEncoding) Specifies the Content-Encoding header.
void	setContentEncoding(java.lang.String ceString) Specifies the Content-Encoding header, as a string.
void	setContentType(org.apache.http.Header contentType) Specifies the Content-Type header.
void	setContentType(java.lang.String ctString) Specifies the Content-Type header, as a string.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.http.HttpEntity

getContent, getContentLength, isRepeatable, isStreaming, writeTo

Field Detail

OUTPUT_BUFFER_SIZE

protected static final int OUTPUT_BUFFER_SIZE

Buffer size for output stream processing.

Since:

4.3

See Also:

Constant Field Values

contentType

protected org.apache.http.Header contentType

contentEncoding

protected org.apache.http.Header contentEncoding

chunked

protected boolean chunked

Constructor Detail

AbstractHttpEntityHC4

protected AbstractHttpEntityHC4()

Protected default constructor. The contentType, contentEncoding and chunked attributes of the created object are set to null, null and false, respectively.

Method Detail

getContentType

public org.apache.http.Header getContentType()

Obtains the Content-Type header. The default implementation returns the value of the contentType attribute.

Specified by:

getContentType in interface org.apache.http.HttpEntity

Returns:

the Content-Type header, or null

getContentEncoding

public org.apache.http.Header getContentEncoding()

Obtains the Content-Encoding header. The default implementation returns the value of the contentEncoding attribute.

Specified by:

getContentEncoding in interface org.apache.http.HttpEntity

Returns:

the Content-Encoding header, or null

isChunked

public boolean isChunked()

Obtains the 'chunked' flag. The default implementation returns the value of the chunked attribute.

Specified by:

isChunked in interface org.apache.http.HttpEntity

Returns:

the 'chunked' flag

setContentType

public void setContentType(org.apache.http.Header contentType)

Specifies the Content-Type header. The default implementation sets the value of the contentType attribute.

Parameters:

contentType - the new Content-Encoding header, or null to unset

setContentType

public void setContentType(java.lang.String ctString)

Specifies the Content-Type header, as a string. The default implementation calls setContentType(Header).

Parameters:

ctString - the new Content-Type header, or null to unset

setContentEncoding

public void setContentEncoding(org.apache.http.Header contentEncoding)

Specifies the Content-Encoding header. The default implementation sets the value of the contentEncoding attribute.

Parameters:

contentEncoding - the new Content-Encoding header, or null to unset

setContentEncoding

public void setContentEncoding(java.lang.String ceString)

Specifies the Content-Encoding header, as a string. The default implementation calls setContentEncoding(Header).

Parameters:

ceString - the new Content-Encoding header, or null to unset

setChunked

public void setChunked(boolean b)

Specifies the 'chunked' flag.

Note that the chunked setting is a hint only. If using HTTP/1.0, chunking is never performed. Otherwise, even if chunked is false, HttpClient must use chunk coding if the entity content length is unknown (-1).

The default implementation sets the value of the chunked attribute.

Parameters:

b - the new 'chunked' flag

consumeContent

@Deprecated
public void consumeContent()
                    throws java.io.IOException

Deprecated. (4.1) Either use HttpEntity.getContent() and call InputStream.close() on that; otherwise call HttpEntity.writeTo(java.io.OutputStream) which is required to free the resources.

The default implementation does not consume anything.

Specified by:

consumeContent in interface org.apache.http.HttpEntity

Throws:

java.io.IOException