org.apache.pulsar.client.impl

Class ConnectionPool

java.lang.Object

org.apache.pulsar.client.impl.ConnectionPool

All Implemented Interfaces:

Closeable, AutoCloseable

public class ConnectionPool
extends Object
implements Closeable

Field Summary

Fields

Modifier and Type	Field and Description
protected io.netty.resolver.dns.DnsNameResolver	dnsResolver
protected ConcurrentHashMap<InetSocketAddress,ConcurrentMap<Integer,CompletableFuture<ClientCnx>>>	pool

Constructor Summary

Constructors

Constructor and Description
ConnectionPool(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup)
ConnectionPool(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup, Supplier<ClientCnx> clientCnxSupplier)

Method Summary

Modifier and Type	Method and Description
void	close()
CompletableFuture<ClientCnx>	getConnection(InetSocketAddress address)
CompletableFuture<ClientCnx>	getConnection(InetSocketAddress logicalAddress, InetSocketAddress physicalAddress) Get a connection from the pool.
void	releaseConnection(ClientCnx cnx)
static int	signSafeMod(long dividend, int divisor)

Methods inherited from class java.lang.Object

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

Field Detail

pool

protected final ConcurrentHashMap<InetSocketAddress,ConcurrentMap<Integer,CompletableFuture<ClientCnx>>> pool

dnsResolver

protected final io.netty.resolver.dns.DnsNameResolver dnsResolver

Constructor Detail

ConnectionPool

public ConnectionPool(ClientConfigurationData conf,
                      io.netty.channel.EventLoopGroup eventLoopGroup)
               throws PulsarClientException

Throws:

PulsarClientException

ConnectionPool

public ConnectionPool(ClientConfigurationData conf,
                      io.netty.channel.EventLoopGroup eventLoopGroup,
                      Supplier<ClientCnx> clientCnxSupplier)
               throws PulsarClientException

Throws:

PulsarClientException

Method Detail

getConnection

public CompletableFuture<ClientCnx> getConnection(InetSocketAddress address)

getConnection

public CompletableFuture<ClientCnx> getConnection(InetSocketAddress logicalAddress,
                                                  InetSocketAddress physicalAddress)

Get a connection from the pool.

The connection can either be created or be coming from the pool itself.

When specifying multiple addresses, the logicalAddress is used as a tag for the broker, while the physicalAddress is where the connection is actually happening.

These two addresses can be different when the client is forced to connect through a proxy layer. Essentially, the pool is using the logical address as a way to decide whether to reuse a particular connection.

Parameters:

logicalAddress - the address to use as the broker tag

physicalAddress - the real address where the TCP connection should be made

Returns:

a future that will produce the ClientCnx object

releaseConnection

public void releaseConnection(ClientCnx cnx)

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

signSafeMod

public static int signSafeMod(long dividend,
                              int divisor)