com.aliyun.apache.hc.core5.http.io.entity

类 BasicHttpEntity

java.lang.Object

com.aliyun.apache.hc.core5.http.io.entity.AbstractHttpEntity

com.aliyun.apache.hc.core5.http.io.entity.BasicHttpEntity

所有已实现的接口:

EntityDetails, HttpEntity, Closeable, AutoCloseable

@Contract(threading=IMMUTABLE_CONDITIONAL)
public class BasicHttpEntity
extends AbstractHttpEntity

A generic streamed, non-repeatable entity that obtains its content from an InputStream.

从以下版本开始:

4.0

构造器概要

构造器

构造器和说明
BasicHttpEntity(InputStream content, ContentType contentType)
BasicHttpEntity(InputStream content, ContentType contentType, boolean chunked)
BasicHttpEntity(InputStream content, ContentType contentType, String contentEncoding)
BasicHttpEntity(InputStream content, long length, ContentType contentType)
BasicHttpEntity(InputStream content, long length, ContentType contentType, String contentEncoding)
BasicHttpEntity(InputStream content, long length, ContentType contentType, String contentEncoding, boolean chunked)

方法概要

限定符和类型	方法和说明
void	close()
InputStream	getContent() Returns a content stream of the entity.
long	getContentLength() Returns length of the entity, if known.
boolean	isRepeatable() Tells if the entity is capable of producing its data more than once.
boolean	isStreaming() Tells whether this entity depends on an underlying stream.

从类继承的方法 com.aliyun.apache.hc.core5.http.io.entity.AbstractHttpEntity

getContentEncoding, getContentType, getTrailerNames, getTrailers, isChunked, toString, writeTo, writeTo

从类继承的方法 java.lang.Object

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

构造器详细资料

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       long length,
                       ContentType contentType,
                       String contentEncoding,
                       boolean chunked)

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       long length,
                       ContentType contentType,
                       String contentEncoding)

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       long length,
                       ContentType contentType)

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       ContentType contentType,
                       String contentEncoding)

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       ContentType contentType)

BasicHttpEntity

public BasicHttpEntity(InputStream content,
                       ContentType contentType,
                       boolean chunked)

方法详细资料

getContentLength

public final long getContentLength()

从接口复制的说明: EntityDetails

Returns length of the entity, if known.

getContent

public final InputStream getContent()
                             throws IllegalStateException

从接口复制的说明: HttpEntity

Returns a content stream of the entity. Repeatable entities are expected to create a new instance of InputStream for each invocation of this method and therefore can be consumed multiple times. Entities that are not repeatable are expected to return the same InputStream instance and therefore may not be consumed more than once.

If this entity belongs to an incoming HTTP message, calling InputStream.close() on the returned InputStream will try to consume the complete entity content to keep the connection alive. In cases where this is undesired, e.g. when only a small part of the content is relevant and consuming the complete entity content would be too inefficient, only the HTTP message from which this entity was obtained should be closed (if supported).

IMPORTANT: Please note all entity implementations must ensure that all allocated resources are properly deallocated after the InputStream.close() method is invoked.

返回:

content stream of the entity.

抛出:

IllegalStateException

另请参阅:

HttpEntity.isRepeatable()

isRepeatable

public final boolean isRepeatable()

从接口复制的说明: HttpEntity

Tells if the entity is capable of producing its data more than once. A repeatable entity's getContent() and writeTo(OutputStream) methods can be called more than once whereas a non-repeatable entity's can not.

指定者:

isRepeatable 在接口中 HttpEntity

覆盖:

isRepeatable 在类中 AbstractHttpEntity

返回:

true if the entity is repeatable, false otherwise.

isStreaming

public final boolean isStreaming()

从接口复制的说明: HttpEntity

Tells whether this entity depends on an underlying stream. Streamed entities that read data directly from the socket should return true. Self-contained entities should return false. Wrapping entities should delegate this call to the wrapped entity.

返回:

true if the entity content is streamed, false otherwise

close

public final void close()
                 throws IOException

抛出:

IOException