io.dropwizard.client

Class HttpClientBuilder

java.lang.Object

io.dropwizard.client.HttpClientBuilder

public class HttpClientBuilder
extends Object

A convenience class for building HttpClient instances.

Among other things,

• Disables stale connection checks
• Disables Nagle's algorithm
• Disables cookie management by default

Constructor Summary

Constructors

Constructor and Description
HttpClientBuilder(Environment environment)
HttpClientBuilder(com.codahale.metrics.MetricRegistry metricRegistry)

Method Summary

Methods

Modifier and Type	Method and Description
org.apache.http.impl.client.CloseableHttpClient	build(String name) Builds the HttpClient.
protected com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager	configureConnectionManager(com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager connectionManager)
protected org.apache.http.impl.client.CloseableHttpClient	createClient(org.apache.http.impl.client.HttpClientBuilder builder, com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager manager, String name) Map the parameters in HttpClientConfiguration to configuration on a HttpClientBuilder instance
protected com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager	createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry, String name) Create a InstrumentedHttpClientConnectionManager based on the HttpClientConfiguration.
protected String	createUserAgent(String name) Create a user agent string using the configured user agent if defined, otherwise using a combination of the environment name and this client name
HttpClientBuilder	name(String environmentName) Use the given environment name.
HttpClientBuilder	using(org.apache.http.client.CredentialsProvider credentialsProvider) Use the given CredentialsProvider instance.
HttpClientBuilder	using(org.apache.http.conn.DnsResolver resolver) Use the given DnsResolver instance.
HttpClientBuilder	using(HttpClientConfiguration configuration) Use the given HttpClientConfiguration instance.
HttpClientBuilder	using(com.codahale.metrics.httpclient.HttpClientMetricNameStrategy metricNameStrategy) Use the given HttpClientMetricNameStrategy instance.
HttpClientBuilder	using(org.apache.http.client.HttpRequestRetryHandler httpRequestRetryHandler) Uses the HttpRequestRetryHandler for handling request retries.
HttpClientBuilder	using(org.apache.http.conn.routing.HttpRoutePlanner routePlanner) Use the given HttpRoutePlanner instance.
HttpClientBuilder	using(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry) Use the given Registry instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClientBuilder

public HttpClientBuilder(com.codahale.metrics.MetricRegistry metricRegistry)

HttpClientBuilder

public HttpClientBuilder(Environment environment)

Method Detail

name

public HttpClientBuilder name(String environmentName)

Use the given environment name. This is used in the user agent.

Parameters:

environmentName - an environment name to use in the user agent.

Returns:

this

using

public HttpClientBuilder using(HttpClientConfiguration configuration)

Use the given HttpClientConfiguration instance.

Parameters:

configuration - a HttpClientConfiguration instance

Returns:

this

using

public HttpClientBuilder using(org.apache.http.conn.DnsResolver resolver)

Use the given DnsResolver instance.

Parameters:

resolver - a DnsResolver instance

Returns:

this

using

public HttpClientBuilder using(org.apache.http.client.HttpRequestRetryHandler httpRequestRetryHandler)

Uses the HttpRequestRetryHandler for handling request retries.

Parameters:

httpRequestRetryHandler - an httpRequestRetryHandler

Returns:

this

using

public HttpClientBuilder using(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry)

Use the given Registry instance.

Parameters:

registry -

Returns:

this

using

public HttpClientBuilder using(org.apache.http.conn.routing.HttpRoutePlanner routePlanner)

Use the given HttpRoutePlanner instance.

Parameters:

routePlanner - a HttpRoutePlanner instance

Returns:

this

using

public HttpClientBuilder using(org.apache.http.client.CredentialsProvider credentialsProvider)

Use the given CredentialsProvider instance.

Parameters:

credentialsProvider - a CredentialsProvider instance

Returns:

this

using

public HttpClientBuilder using(com.codahale.metrics.httpclient.HttpClientMetricNameStrategy metricNameStrategy)

Use the given HttpClientMetricNameStrategy instance.

Parameters:

metricNameStrategy - a HttpClientMetricNameStrategy instance

Returns:

this

build

public org.apache.http.impl.client.CloseableHttpClient build(String name)

Builds the HttpClient.

Parameters:

name -

Returns:

an CloseableHttpClient

createClient

protected org.apache.http.impl.client.CloseableHttpClient createClient(org.apache.http.impl.client.HttpClientBuilder builder,
                                                           com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager manager,
                                                           String name)

Map the parameters in HttpClientConfiguration to configuration on a HttpClientBuilder instance

Parameters:

builder -

manager -

name -

Returns:

the configured CloseableHttpClient

createUserAgent

protected String createUserAgent(String name)

Create a user agent string using the configured user agent if defined, otherwise using a combination of the environment name and this client name

Parameters:

name - the name of this client

Returns:

the user agent string to be used by this client

createConnectionManager

protected com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager createConnectionManager(org.apache.http.config.Registry<org.apache.http.conn.socket.ConnectionSocketFactory> registry,
                                                                                              String name)

Create a InstrumentedHttpClientConnectionManager based on the HttpClientConfiguration. It sets the maximum connections per route and the maximum total connections that the connection manager can create

Parameters:

registry -

name -

Returns:

a InstrumentedHttpClientConnectionManger instance

configureConnectionManager

protected com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager configureConnectionManager(com.codahale.metrics.httpclient.InstrumentedHttpClientConnectionManager connectionManager)