Package org.apache.http.entity

Class AbstractHttpEntity

java.lang.Object

org.apache.http.entity.AbstractHttpEntity

All Implemented Interfaces:

HttpEntity

Direct Known Subclasses:

BasicHttpEntity, ByteArrayEntity, EntityTemplate, FileEntity, InputStreamEntity, NByteArrayEntity, NFileEntity, NStringEntity, SerializableEntity, StringEntity

public abstract class AbstractHttpEntity
extends java.lang.Object
implements HttpEntity

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

Since:

4.0

Method Summary

Modifier and Type	Method	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.
Header	getContentEncoding()	Obtains the Content-Encoding header.
Header	getContentType()	Obtains the Content-Type header.
boolean	isChunked()	Obtains the 'chunked' flag.
void	setChunked(boolean b)	Specifies the 'chunked' flag.
void	setContentEncoding(java.lang.String ceString)	Specifies the Content-Encoding header, as a string.
void	setContentEncoding(Header contentEncoding)	Specifies the Content-Encoding header.
void	setContentType(java.lang.String ctString)	Specifies the Content-Type header, as a string.
void	setContentType(Header contentType)	Specifies the Content-Type header.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.http.HttpEntity

getContent, getContentLength, isRepeatable, isStreaming, writeTo

Method Detail

getContentType

public Header getContentType()

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

Specified by:

getContentType in interface HttpEntity

Returns:

the Content-Type header, or null

getContentEncoding

public Header getContentEncoding()

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

Specified by:

getContentEncoding in interface 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 HttpEntity

Returns:

the 'chunked' flag

setContentType

public void setContentType(Header contentType)

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

Parameters:

contentType - the new Content-Type 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(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 HttpEntity

Throws:

java.io.IOException - if an I/O error occurs.

See Also:

and #writeTo(OutputStream)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object