Class HttpClientPool

java.lang.Object

com.github.nhenneaux.resilienthttpclient.monitoredclientpool.HttpClientPool

All Implemented Interfaces:

AutoCloseable

public class HttpClientPool
extends Object
implements AutoCloseable

A HTTP clients pool which keeps internally a round robin list of HTTP clients.
Each HTTP client represents a connection to the acquirer using a distinct IP address, taken from endpoint resolving.
The number of distinct HTTP clients in this connection pool is equal to the number of different IP addresses for the given acquirer hostname.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HttpClientPool(DnsLookupWrapper dnsLookupWrapper, ScheduledExecutorService scheduledExecutorService, ServerConfiguration serverConfiguration, Function<InetAddress,HttpClient> singleHttpClientProvider)

Method Summary

Modifier and Type	Method	Description
static HttpClientPoolBuilder	builder(ServerConfiguration serverConfiguration)
HealthCheckResult	check()	Returns status HealthCheckResult.HealthStatus.OK if all httpClientsCache are healthy. Returns status HealthCheckResult.HealthStatus.ERROR if all httpClientsCache are unhealthy. Returns status HealthCheckResult.HealthStatus.WARNING if only some httpClientsCache are healthy.
void	close()
Optional<SingleIpHttpClient>	getNextHttpClient()	Take the next HTTP client from the pool. Please note that it uses a round-robin internally.
static HttpClientPool	newHttpClientPool(ServerConfiguration serverConfiguration)
HttpClient	resilientClient()	Return a resilient client with the following features.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

HttpClientPool

protected HttpClientPool(DnsLookupWrapper dnsLookupWrapper,
 ScheduledExecutorService scheduledExecutorService,
 ServerConfiguration serverConfiguration,
 Function<InetAddress,HttpClient> singleHttpClientProvider)

Method Details

builder

public static HttpClientPoolBuilder builder(ServerConfiguration serverConfiguration)

newHttpClientPool

public static HttpClientPool newHttpClientPool(ServerConfiguration serverConfiguration)

getNextHttpClient

public Optional<SingleIpHttpClient> getNextHttpClient()

Take the next HTTP client from the pool.
Please note that it uses a round-robin internally. So once it reaches the end of the list it starts returning items from the beginning and so on.

resilientClient

public HttpClient resilientClient()

Return a resilient client with the following features.

DNS failover if an IP resolved by DNS is not reachable it automatically fallbacks to another IP

Monitored each IP connection to the server is monitored in HTTP

Load balanced the traffic is load balanced on DNS records

check

public HealthCheckResult check()

Returns status HealthCheckResult.HealthStatus.OK if all httpClientsCache are healthy.
Returns status HealthCheckResult.HealthStatus.ERROR if all httpClientsCache are unhealthy.
Returns status HealthCheckResult.HealthStatus.WARNING if only some httpClientsCache are healthy.

toString

public String toString()

Overrides:

toString in class Object

close

public void close()

Specified by:

close in interface AutoCloseable