Package org.apache.http.conn

Class BasicManagedEntity

java.lang.Object

org.apache.http.entity.HttpEntityWrapper

org.apache.http.conn.BasicManagedEntity

All Implemented Interfaces:

ConnectionReleaseTrigger, EofSensorWatcher, org.apache.http.HttpEntity

@Deprecated
public class BasicManagedEntity
extends org.apache.http.entity.HttpEntityWrapper
implements ConnectionReleaseTrigger, EofSensorWatcher

Deprecated.

(4.3) do not use.

An entity that releases a connection. A ManagedClientConnection will typically not return a managed entity, but you can replace the unmanaged entity in the response with a managed one.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	attemptReuse	Deprecated. Whether to keep the connection alive.
protected ManagedClientConnection	managedConn	Deprecated. The connection to release.

Fields inherited from class org.apache.http.entity.HttpEntityWrapper

wrappedEntity

Constructor Summary

Constructors

Constructor	Description
BasicManagedEntity(org.apache.http.HttpEntity entity, ManagedClientConnection conn, boolean reuse)	Deprecated. Creates a new managed entity that can release a connection.

Method Summary

Modifier and Type	Method	Description
void	abortConnection()	Deprecated. Releases the connection without the option of keep-alive.
void	consumeContent()	Deprecated. (4.1) Use EntityUtils.consume(HttpEntity)
boolean	eofDetected(java.io.InputStream wrapped)	Deprecated. Indicates that EOF is detected.
java.io.InputStream	getContent()	Deprecated.
boolean	isRepeatable()	Deprecated.
void	releaseConnection()	Deprecated. Releases the connection with the option of keep-alive.
protected void	releaseManagedConnection()	Deprecated. Releases the connection gracefully.
boolean	streamAbort(java.io.InputStream wrapped)	Deprecated. Indicates that the stream is aborted.
boolean	streamClosed(java.io.InputStream wrapped)	Deprecated. Indicates that the stream is closed.
void	writeTo(java.io.OutputStream outStream)	Deprecated.

Methods inherited from class org.apache.http.entity.HttpEntityWrapper

getContentEncoding, getContentLength, getContentType, isChunked, isStreaming

Methods inherited from class java.lang.Object

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

Field Detail

managedConn

protected ManagedClientConnection managedConn

Deprecated.

The connection to release.

attemptReuse

protected final boolean attemptReuse

Deprecated.

Whether to keep the connection alive.

Constructor Detail

BasicManagedEntity

public BasicManagedEntity(org.apache.http.HttpEntity entity,
                          ManagedClientConnection conn,
                          boolean reuse)

Deprecated.

Creates a new managed entity that can release a connection.

Parameters:

entity - the entity of which to wrap the content. Note that the argument entity can no longer be used afterwards, since the content will be taken by this managed entity.

conn - the connection to release

reuse - whether the connection should be re-used

Method Detail

isRepeatable

public boolean isRepeatable()

Deprecated.

Specified by:

isRepeatable in interface org.apache.http.HttpEntity

Overrides:

isRepeatable in class org.apache.http.entity.HttpEntityWrapper

getContent

public java.io.InputStream getContent()
                               throws java.io.IOException

Deprecated.

Specified by:

getContent in interface org.apache.http.HttpEntity

Overrides:

getContent in class org.apache.http.entity.HttpEntityWrapper

Throws:

java.io.IOException

consumeContent

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

Deprecated.

(4.1) Use EntityUtils.consume(HttpEntity)

Specified by:

consumeContent in interface org.apache.http.HttpEntity

Overrides:

consumeContent in class org.apache.http.entity.HttpEntityWrapper

Throws:

java.io.IOException

writeTo

public void writeTo(java.io.OutputStream outStream)
             throws java.io.IOException

Deprecated.

Specified by:

writeTo in interface org.apache.http.HttpEntity

Overrides:

writeTo in class org.apache.http.entity.HttpEntityWrapper

Throws:

java.io.IOException

releaseConnection

public void releaseConnection()
                       throws java.io.IOException

Deprecated.

Description copied from interface: ConnectionReleaseTrigger

Releases the connection with the option of keep-alive. This is a "graceful" release and may cause IO operations for consuming the remainder of a response entity. Use abortConnection for a hard release. The connection may be reused as specified by the duration.

Specified by:

releaseConnection in interface ConnectionReleaseTrigger

Throws:

java.io.IOException - in case of an IO problem. The connection will be released anyway.

abortConnection

public void abortConnection()
                     throws java.io.IOException

Deprecated.

Description copied from interface: ConnectionReleaseTrigger

Releases the connection without the option of keep-alive. This is a "hard" release that implies a shutdown of the connection. Use ConnectionReleaseTrigger.releaseConnection() for a graceful release.

Specified by:

abortConnection in interface ConnectionReleaseTrigger

Throws:

java.io.IOException - in case of an IO problem. The connection will be released anyway.

eofDetected

public boolean eofDetected(java.io.InputStream wrapped)
                    throws java.io.IOException

Deprecated.

Description copied from interface: EofSensorWatcher

Indicates that EOF is detected.

Specified by:

eofDetected in interface EofSensorWatcher

Parameters:

wrapped - the underlying stream which has reached EOF

Returns:

true if wrapped should be closed, false if it should be left alone

Throws:

java.io.IOException - in case of an IO problem, for example if the watcher itself closes the underlying stream. The caller will leave the wrapped stream alone, as if false was returned.

streamClosed

public boolean streamClosed(java.io.InputStream wrapped)
                     throws java.io.IOException

Deprecated.

Description copied from interface: EofSensorWatcher

Indicates that the stream is closed. This method will be called only if EOF was not detected before closing. Otherwise, eofDetected is called.

Specified by:

streamClosed in interface EofSensorWatcher

Parameters:

wrapped - the underlying stream which has not reached EOF

Returns:

true if wrapped should be closed, false if it should be left alone

Throws:

java.io.IOException - in case of an IO problem, for example if the watcher itself closes the underlying stream. The caller will leave the wrapped stream alone, as if false was returned.

streamAbort

public boolean streamAbort(java.io.InputStream wrapped)
                    throws java.io.IOException

Deprecated.

Description copied from interface: EofSensorWatcher

Indicates that the stream is aborted. This method will be called only if EOF was not detected before aborting. Otherwise, eofDetected is called.

This method will also be invoked when an input operation causes an IOException to be thrown to make sure the input stream gets shut down.

Specified by:

streamAbort in interface EofSensorWatcher

Parameters:

wrapped - the underlying stream which has not reached EOF

Returns:

true if wrapped should be closed, false if it should be left alone

Throws:

java.io.IOException - in case of an IO problem, for example if the watcher itself closes the underlying stream. The caller will leave the wrapped stream alone, as if false was returned.

releaseManagedConnection

protected void releaseManagedConnection()
                                 throws java.io.IOException

Deprecated.

Releases the connection gracefully. The connection attribute will be nullified. Subsequent invocations are no-ops.

Throws:

java.io.IOException - in case of an IO problem. The connection attribute will be nullified anyway.