org.apache.hc.client5.http.impl.classic

Class AbstractHttpClientResponseHandler<T>

java.lang.Object

org.apache.hc.client5.http.impl.classic.AbstractHttpClientResponseHandler<T>

All Implemented Interfaces:

HttpClientResponseHandler<T>

Direct Known Subclasses:

BasicHttpClientResponseHandler

@Contract(threading=STATELESS)
public abstract class AbstractHttpClientResponseHandler<T>
extends Object
implements HttpClientResponseHandler<T>

A generic HttpClientResponseHandler that works with the response entity for successful (2xx) responses. If the response code was >= 300, the response body is consumed and an HttpResponseException is thrown.

If this is used with HttpClient.execute( org.apache.hc.core5.http.ClassicHttpRequest, HttpClientResponseHandler), HttpClient may handle redirects (3xx responses) internally.

Since:

4.4

Constructor Summary

Constructors

Constructor and Description
AbstractHttpClientResponseHandler()

Method Summary

Modifier and Type	Method and Description
abstract T	handleEntity(HttpEntity entity) Handle the response entity and transform it into the actual response object.
T	handleResponse(ClassicHttpResponse response) Read the entity from the response body and pass it to the entity handler method if the response was successful (a 2xx status code).

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractHttpClientResponseHandler

public AbstractHttpClientResponseHandler()

Method Detail

handleEntity

public abstract T handleEntity(HttpEntity entity)
                        throws IOException

Handle the response entity and transform it into the actual response object.

Throws:

IOException

handleResponse

public T handleResponse(ClassicHttpResponse response)
                 throws IOException

Read the entity from the response body and pass it to the entity handler method if the response was successful (a 2xx status code). If no response body exists, this returns null. If the response was unsuccessful (>= 300 status code), throws an HttpResponseException.

Specified by:

handleResponse in interface HttpClientResponseHandler<T>

Parameters:

response - The response to process

Returns:

A value determined by the response

Throws:

IOException - in case of a problem or the connection was aborted