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
static String	TLS_HANDLER

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.
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

TLS_HANDLER

public static final String TLS_HANDLER

See Also:

Constant Field Values

Constructor Detail

ConnectionPool

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

ConnectionPool

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

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

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)