Package org.apache.pulsar.client.impl

Class ConnectionPool

java.lang.Object

org.apache.pulsar.client.impl.ConnectionPool

All Implemented Interfaces:

AutoCloseable

public class ConnectionPool
extends Object
implements AutoCloseable

Field Summary

Fields

Modifier and Type	Field	Description
protected final io.netty.resolver.AddressResolver<InetSocketAddress>	addressResolver
static final int	IDLE_DETECTION_INTERVAL_SECONDS_MIN
protected final ConcurrentHashMap<InetSocketAddress,ConcurrentMap<Integer,CompletableFuture<ClientCnx>>>	pool

Constructor Summary

Constructors

Constructor	Description
ConnectionPool(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup)
ConnectionPool(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup, Supplier<ClientCnx> clientCnxSupplier)
ConnectionPool(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup, Supplier<ClientCnx> clientCnxSupplier, Optional<io.netty.resolver.AddressResolver<InetSocketAddress>> addressResolver)

Method Summary

Modifier and Type	Method	Description
void	close()
void	doMarkAndReleaseUselessConnections()
int	genRandomKeyToSelectCon()
CompletableFuture<ClientCnx>	getConnection(InetSocketAddress address)
CompletableFuture<ClientCnx>	getConnection(InetSocketAddress logicalAddress, InetSocketAddress physicalAddress, int randomKey)	Get a connection from the pool.
Set<CompletableFuture<ClientCnx>>	getConnections()
void	releaseConnection(ClientCnx cnx)

Methods inherited from class java.lang.Object

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

Field Details

IDLE_DETECTION_INTERVAL_SECONDS_MIN

public static final int IDLE_DETECTION_INTERVAL_SECONDS_MIN

See Also:

• Constant Field Values

pool

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

addressResolver

protected final io.netty.resolver.AddressResolver<InetSocketAddress> addressResolver

Constructor Details

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

ConnectionPool

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

Throws:

PulsarClientException

Method Details

genRandomKeyToSelectCon

public int genRandomKeyToSelectCon()

getConnection

public CompletableFuture<ClientCnx> getConnection(InetSocketAddress address)

getConnection

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

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 Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception

doMarkAndReleaseUselessConnections

public void doMarkAndReleaseUselessConnections()

getConnections

public Set<CompletableFuture<ClientCnx>> getConnections()