org.asynchttpclient

Class DefaultAsyncHttpClient

java.lang.Object

org.asynchttpclient.DefaultAsyncHttpClient

All Implemented Interfaces:

Closeable, AutoCloseable, AsyncHttpClient

public class DefaultAsyncHttpClient
extends Object
implements AsyncHttpClient

Field Summary

Fields

Modifier and Type	Field and Description
protected SignatureCalculator	signatureCalculator Default signature calculator to use for all requests constructed by this client instance.

Constructor Summary

Constructors

Constructor and Description
DefaultAsyncHttpClient() Create a new HTTP Asynchronous Client using the default DefaultAsyncHttpClientConfig configuration.
DefaultAsyncHttpClient(AsyncHttpClientConfig config) Create a new HTTP Asynchronous Client using the specified DefaultAsyncHttpClientConfig configuration.

Method Summary

Modifier and Type	Method and Description
void	close()
ListenableFuture<Response>	executeRequest(Request request) Execute an HTTP request.
<T> ListenableFuture<T>	executeRequest(Request request, AsyncHandler<T> handler) Execute an HTTP request.
ListenableFuture<Response>	executeRequest(RequestBuilder requestBuilder) Execute an HTTP request.
<T> ListenableFuture<T>	executeRequest(RequestBuilder requestBuilder, AsyncHandler<T> handler) Execute an HTTP request.
protected void	finalize()
ChannelPool	getChannelPool()
boolean	isClosed() Return true if closed
BoundRequestBuilder	prepareConnect(String url) Prepare an HTTP client CONNECT request.
BoundRequestBuilder	prepareDelete(String url) Prepare an HTTP client DELETE request.
BoundRequestBuilder	prepareGet(String url) Prepare an HTTP client GET request.
BoundRequestBuilder	prepareHead(String url) Prepare an HTTP client HEAD request.
BoundRequestBuilder	prepareOptions(String url) Prepare an HTTP client OPTIONS request.
BoundRequestBuilder	preparePatch(String url) Prepare an HTTP client PATCH request.
BoundRequestBuilder	preparePost(String url) Prepare an HTTP client POST request.
BoundRequestBuilder	preparePut(String url) Prepare an HTTP client PUT request.
BoundRequestBuilder	prepareRequest(Request request) Construct a RequestBuilder using a Request
BoundRequestBuilder	prepareRequest(RequestBuilder requestBuilder) Construct a RequestBuilder using a RequestBuilder
BoundRequestBuilder	prepareTrace(String url) Prepare an HTTP client TRACE request.
protected BoundRequestBuilder	requestBuilder(Request prototype)
protected BoundRequestBuilder	requestBuilder(String method, String url)
DefaultAsyncHttpClient	setSignatureCalculator(SignatureCalculator signatureCalculator) Set default signature calculator to use for requests build by this client instance

Methods inherited from class java.lang.Object

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

Field Detail

signatureCalculator

protected SignatureCalculator signatureCalculator

Default signature calculator to use for all requests constructed by this client instance.

Since:

1.1

Constructor Detail

DefaultAsyncHttpClient

public DefaultAsyncHttpClient()

Create a new HTTP Asynchronous Client using the default DefaultAsyncHttpClientConfig configuration. The default AsyncHttpClient that will be used will be based on the classpath configuration. If none of those providers are found, then the engine will throw an IllegalStateException.

DefaultAsyncHttpClient

public DefaultAsyncHttpClient(AsyncHttpClientConfig config)

Create a new HTTP Asynchronous Client using the specified DefaultAsyncHttpClientConfig configuration. This configuration will be passed to the default AsyncHttpClient that will be selected based on the classpath configuration.

Parameters:

config - a DefaultAsyncHttpClientConfig

Method Detail

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

isClosed

public boolean isClosed()

Description copied from interface: AsyncHttpClient

Return true if closed

Specified by:

isClosed in interface AsyncHttpClient

Returns:

true if closed

setSignatureCalculator

public DefaultAsyncHttpClient setSignatureCalculator(SignatureCalculator signatureCalculator)

Description copied from interface: AsyncHttpClient

Set default signature calculator to use for requests build by this client instance

Specified by:

setSignatureCalculator in interface AsyncHttpClient

Parameters:

signatureCalculator - a signature calculator

Returns:

RequestBuilder

prepareGet

public BoundRequestBuilder prepareGet(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client GET request.

Specified by:

prepareGet in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareConnect

public BoundRequestBuilder prepareConnect(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client CONNECT request.

Specified by:

prepareConnect in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareOptions

public BoundRequestBuilder prepareOptions(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client OPTIONS request.

Specified by:

prepareOptions in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareHead

public BoundRequestBuilder prepareHead(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client HEAD request.

Specified by:

prepareHead in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

preparePost

public BoundRequestBuilder preparePost(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client POST request.

Specified by:

preparePost in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

preparePut

public BoundRequestBuilder preparePut(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client PUT request.

Specified by:

preparePut in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareDelete

public BoundRequestBuilder prepareDelete(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client DELETE request.

Specified by:

prepareDelete in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

preparePatch

public BoundRequestBuilder preparePatch(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client PATCH request.

Specified by:

preparePatch in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareTrace

public BoundRequestBuilder prepareTrace(String url)

Description copied from interface: AsyncHttpClient

Prepare an HTTP client TRACE request.

Specified by:

prepareTrace in interface AsyncHttpClient

Parameters:

url - A well formed URL.

Returns:

RequestBuilder

prepareRequest

public BoundRequestBuilder prepareRequest(Request request)

Description copied from interface: AsyncHttpClient

Construct a RequestBuilder using a Request

Specified by:

prepareRequest in interface AsyncHttpClient

Parameters:

request - a Request

Returns:

RequestBuilder

prepareRequest

public BoundRequestBuilder prepareRequest(RequestBuilder requestBuilder)

Description copied from interface: AsyncHttpClient

Construct a RequestBuilder using a RequestBuilder

Specified by:

prepareRequest in interface AsyncHttpClient

Parameters:

requestBuilder - a RequestBuilder

Returns:

RequestBuilder

executeRequest

public <T> ListenableFuture<T> executeRequest(Request request,
                                              AsyncHandler<T> handler)

Description copied from interface: AsyncHttpClient

Execute an HTTP request.

Specified by:

executeRequest in interface AsyncHttpClient

Type Parameters:

T - Type of the value that will be returned by the associated Future

Parameters:

request - Request

handler - an instance of AsyncHandler

Returns:

a Future of type T

executeRequest

public <T> ListenableFuture<T> executeRequest(RequestBuilder requestBuilder,
                                              AsyncHandler<T> handler)

Description copied from interface: AsyncHttpClient

Execute an HTTP request.

Specified by:

executeRequest in interface AsyncHttpClient

Type Parameters:

T - Type of the value that will be returned by the associated Future

Parameters:

requestBuilder - RequestBuilder

handler - an instance of AsyncHandler

Returns:

a Future of type T

executeRequest

public ListenableFuture<Response> executeRequest(Request request)

Description copied from interface: AsyncHttpClient

Execute an HTTP request.

Specified by:

executeRequest in interface AsyncHttpClient

Parameters:

request - Request

Returns:

a Future of type Response

executeRequest

public ListenableFuture<Response> executeRequest(RequestBuilder requestBuilder)

Description copied from interface: AsyncHttpClient

Execute an HTTP request.

Specified by:

executeRequest in interface AsyncHttpClient

Parameters:

requestBuilder - RequestBuilder

Returns:

a Future of type Response

getChannelPool

public ChannelPool getChannelPool()

requestBuilder

protected BoundRequestBuilder requestBuilder(String method,
                                             String url)

requestBuilder

protected BoundRequestBuilder requestBuilder(Request prototype)