Package org.apache.http.nio.protocol

Class AbstractAsyncResponseConsumer<T>

java.lang.Object

org.apache.http.nio.protocol.AbstractAsyncResponseConsumer<T>

All Implemented Interfaces:

Closeable, AutoCloseable, Cancellable, HttpAsyncResponseConsumer<T>

Direct Known Subclasses:

BasicAsyncResponseConsumer

public abstract class AbstractAsyncResponseConsumer<T>
extends Object
implements HttpAsyncResponseConsumer<T>

Abstract HttpAsyncResponseConsumer implementation that relieves its subclasses from having to manage internal state and provides a number of protected event methods that they need to implement.

Since:

4.2

Constructor Summary

Constructors

Constructor	Description
AbstractAsyncResponseConsumer()

Method Summary

Modifier and Type	Method	Description
final boolean	cancel()
final void	close()
final void	consumeContent(ContentDecoder decoder, IOControl ioctrl)	Use onContentReceived(ContentDecoder, IOControl) instead.
final void	failed(Exception ex)	Invoked to signal that the response processing terminated abnormally.
Exception	getException()	Returns an exception in case of an abnormal termination.
T	getResult()	Returns a result of the response processing, when available.
boolean	isDone()	Determines whether or not the response processing completed.
final void	responseCompleted(HttpContext context)	Use buildResult(HttpContext) instead.
final void	responseReceived(HttpResponse response)	Use onResponseReceived(HttpResponse) instead.

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractAsyncResponseConsumer

public AbstractAsyncResponseConsumer()

Method Details

responseReceived

public final void responseReceived(HttpResponse response)
                            throws IOException,
HttpException

Use onResponseReceived(HttpResponse) instead.

Specified by:

responseReceived in interface HttpAsyncResponseConsumer<T>

Parameters:

response - HTTP response message.

Throws:

IOException - in case of an I/O error

HttpException - in case of HTTP protocol violation

consumeContent

public final void consumeContent(ContentDecoder decoder,
 IOControl ioctrl)
                          throws IOException

Use onContentReceived(ContentDecoder, IOControl) instead.

Specified by:

consumeContent in interface HttpAsyncResponseConsumer<T>

Parameters:

decoder - content decoder.

ioctrl - I/O control of the underlying connection.

Throws:

IOException - in case of an I/O error

responseCompleted

public final void responseCompleted(HttpContext context)

Use buildResult(HttpContext) instead.

Specified by:

responseCompleted in interface HttpAsyncResponseConsumer<T>

Parameters:

context - HTTP context

cancel

public final boolean cancel()

Specified by:

cancel in interface Cancellable

failed

public final void failed(Exception ex)

Description copied from interface: HttpAsyncResponseConsumer

Invoked to signal that the response processing terminated abnormally.

Specified by:

failed in interface HttpAsyncResponseConsumer<T>

Parameters:

ex - exception

close

public final void close()
                 throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

getException

public Exception getException()

Description copied from interface: HttpAsyncResponseConsumer

Returns an exception in case of an abnormal termination. This method returns null if the response processing is still ongoing or if it completed successfully.

Specified by:

getException in interface HttpAsyncResponseConsumer<T>

See Also:

• HttpAsyncResponseConsumer.isDone()

getResult

public T getResult()

Description copied from interface: HttpAsyncResponseConsumer

Returns a result of the response processing, when available. This method returns null if the response processing is still ongoing.

Specified by:

getResult in interface HttpAsyncResponseConsumer<T>

See Also:

• HttpAsyncResponseConsumer.isDone()

isDone

public boolean isDone()

Description copied from interface: HttpAsyncResponseConsumer

Determines whether or not the response processing completed. If the response processing terminated normally HttpAsyncResponseConsumer.getResult() can be used to obtain the result. If the response processing terminated abnormally HttpAsyncResponseConsumer.getException() can be used to obtain the cause.

Specified by:

isDone in interface HttpAsyncResponseConsumer<T>