io.lettuce.core

Class AbstractRedisClient

java.lang.Object

io.lettuce.core.AbstractRedisClient

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

RedisClient, RedisClusterClient

public abstract class AbstractRedisClient
extends Object
implements AutoCloseable

Base Redis client. This class holds the netty infrastructure, ClientOptions and the basic connection procedure. This class creates different Netty EventLoopGroups depending on the Transports.NativeTransports used.

You can set the number of threads by using the ClientResources configuration. For more details, check the documentation of the DefaultClientResources class.

Since:

3.0

Author:

Mark Paluch, Jongyeol Choi, Poorva Gokhale, Tihomir Mateev

See Also:

ClientResources, DefaultClientResources

Field Summary

Fields

Modifier and Type	Field and Description
protected ChannelGroup	channels
protected Set<Closeable>	closeableResources
protected ConnectionEvents	connectionEvents

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractRedisClient(ClientResources clientResources) Create a new instance with client resources.

Method Summary

Modifier and Type	Method and Description
void	addListener(CommandListener listener) Add a listener for Redis Command events.
void	addListener(RedisConnectionStateListener listener) Add a listener for the RedisConnectionState.
protected void	channelType(ConnectionBuilder connectionBuilder, ConnectionPoint connectionPoint)
void	close()
protected void	connectionBuilder(Mono<SocketAddress> socketAddressSupplier, ConnectionBuilder connectionBuilder, ConnectionEvents connectionEvents, RedisURI redisURI) Populate connection builder with necessary resources.
protected void	connectionBuilder(Mono<SocketAddress> socketAddressSupplier, ConnectionBuilder connectionBuilder, RedisURI redisURI) Populate connection builder with necessary resources.
protected io.lettuce.core.RedisHandshake	createHandshake(ConnectionState state)
protected int	getChannelCount()
protected List<CommandListener>	getCommandListeners()
protected <T> T	getConnection(CompletableFuture<T> connectionFuture) Retrieve the connection from ConnectionFuture.
protected <T> T	getConnection(ConnectionFuture<T> connectionFuture) Retrieve the connection from ConnectionFuture.
ClientOptions	getOptions() Returns the ClientOptions which are valid for that client.
protected int	getResourceCount()
ClientResources	getResources() Returns the ClientResources which are used with that client.
protected <K,V,T extends RedisChannelHandler<K,V>> ConnectionFuture<T>	initializeChannelAsync(ConnectionBuilder connectionBuilder) Connect and initialize a channel from ConnectionBuilder.
void	removeListener(CommandListener listener) Removes a listener.
void	removeListener(RedisConnectionStateListener listener) Removes a listener.
protected void	setOptions(ClientOptions clientOptions) Set the ClientOptions for the client.
void	shutdown() Shutdown this client and close all open connections once this method is called.
void	shutdown(Duration quietPeriod, Duration timeout) Shutdown this client and close all open connections once this method is called.
void	shutdown(long quietPeriod, long timeout, TimeUnit timeUnit) Shutdown this client and close all open connections once this method is called.
CompletableFuture<Void>	shutdownAsync() Shutdown this client and close all open connections asynchronously.
CompletableFuture<Void>	shutdownAsync(long quietPeriod, long timeout, TimeUnit timeUnit) Shutdown this client and close all open connections asynchronously.

Methods inherited from class java.lang.Object

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

Field Detail

connectionEvents

protected final ConnectionEvents connectionEvents

closeableResources

protected final Set<Closeable> closeableResources

channels

protected final ChannelGroup channels

Constructor Detail

AbstractRedisClient

protected AbstractRedisClient(ClientResources clientResources)

Create a new instance with client resources.

Parameters:

clientResources - the client resources. If null, the client will create a new dedicated instance of client resources and keep track of them.

Method Detail

getChannelCount

protected int getChannelCount()

getOptions

public ClientOptions getOptions()

Returns the ClientOptions which are valid for that client. Connections inherit the current options at the moment the connection is created. Changes to options will not affect existing connections.

Returns:

the ClientOptions for this client

setOptions

protected void setOptions(ClientOptions clientOptions)

Set the ClientOptions for the client.

Parameters:

clientOptions - client options for the client and connections that are created after setting the options

getResources

public ClientResources getResources()

Returns the ClientResources which are used with that client.

Returns:

the ClientResources for this client.

Since:

6.0

getResourceCount

protected int getResourceCount()

addListener

public void addListener(RedisConnectionStateListener listener)

Add a listener for the RedisConnectionState. The listener is notified every time a connect/disconnect/IO exception happens. The listeners are not bound to a specific connection, so every time a connection event happens on any connection, the listener will be notified. The corresponding netty channel handler (async connection) is passed on the event.

Parameters:

listener - must not be null.

removeListener

public void removeListener(RedisConnectionStateListener listener)

Removes a listener.

Parameters:

listener - must not be null.

addListener

public void addListener(CommandListener listener)

Add a listener for Redis Command events. The listener is notified on each command start/success/failure.

Parameters:

listener - must not be null.

Since:

6.1

removeListener

public void removeListener(CommandListener listener)

Removes a listener.

Parameters:

listener - must not be null.

Since:

6.1

getCommandListeners

protected List<CommandListener> getCommandListeners()

connectionBuilder

protected void connectionBuilder(Mono<SocketAddress> socketAddressSupplier,
                                 ConnectionBuilder connectionBuilder,
                                 RedisURI redisURI)

Populate connection builder with necessary resources.

Parameters:

socketAddressSupplier - address supplier for initial connect and re-connect

connectionBuilder - connection builder to configure the connection

redisURI - URI of the Redis instance

connectionBuilder

protected void connectionBuilder(Mono<SocketAddress> socketAddressSupplier,
                                 ConnectionBuilder connectionBuilder,
                                 ConnectionEvents connectionEvents,
                                 RedisURI redisURI)

Populate connection builder with necessary resources.

Parameters:

socketAddressSupplier - address supplier for initial connect and re-connect

connectionBuilder - connection builder to configure the connection

connectionEvents - connection events dispatcher

redisURI - URI of the Redis instance

Since:

6.2

channelType

protected void channelType(ConnectionBuilder connectionBuilder,
                           ConnectionPoint connectionPoint)

getConnection

protected <T> T getConnection(ConnectionFuture<T> connectionFuture)

Retrieve the connection from ConnectionFuture. Performs a blocking ConnectionFuture.get() to synchronize the channel/connection initialization. Any exception is rethrown as RedisConnectionException.

Type Parameters:

T - Connection type.

Parameters:

connectionFuture - must not be null.

Returns:

the connection.

Throws:

RedisConnectionException - in case of connection failures.

Since:

4.4

getConnection

protected <T> T getConnection(CompletableFuture<T> connectionFuture)

Retrieve the connection from ConnectionFuture. Performs a blocking ConnectionFuture.get() to synchronize the channel/connection initialization. Any exception is rethrown as RedisConnectionException.

Type Parameters:

T - Connection type.

Parameters:

connectionFuture - must not be null.

Returns:

the connection.

Throws:

RedisConnectionException - in case of connection failures.

Since:

5.0

initializeChannelAsync

protected <K,V,T extends RedisChannelHandler<K,V>> ConnectionFuture<T> initializeChannelAsync(ConnectionBuilder connectionBuilder)

Connect and initialize a channel from ConnectionBuilder.

Parameters:

connectionBuilder - must not be null.

Returns:

the ConnectionFuture to synchronize the connection process.

Since:

4.4

shutdown

public void shutdown()

Shutdown this client and close all open connections once this method is called. Once all connections are closed, the associated ClientResources are shut down/released gracefully considering quiet time and the shutdown timeout. The client should be discarded after calling shutdown. The shutdown is executed without quiet time and a timeout of 2 TimeUnit.SECONDS.

See Also:

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit)

close

public void close()

Specified by:

close in interface AutoCloseable

shutdown

public void shutdown(Duration quietPeriod,
                     Duration timeout)

Shutdown this client and close all open connections once this method is called. Once all connections are closed, the associated ClientResources are shut down/released gracefully considering quiet time and the shutdown timeout. The client should be discarded after calling shutdown.

Parameters:

quietPeriod - the quiet period to allow the executor gracefully shut down.

timeout - the maximum amount of time to wait until the backing executor is shutdown regardless if a task was submitted during the quiet period.

Since:

5.0

See Also:

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit)

shutdown

public void shutdown(long quietPeriod,
                     long timeout,
                     TimeUnit timeUnit)

Shutdown this client and close all open connections once this method is called. Once all connections are closed, the associated ClientResources are shut down/released gracefully considering quiet time and the shutdown timeout. The client should be discarded after calling shutdown.

Parameters:

quietPeriod - the quiet period to allow the executor gracefully shut down.

timeout - the maximum amount of time to wait until the backing executor is shutdown regardless if a task was submitted during the quiet period.

timeUnit - the unit of quietPeriod and timeout.

See Also:

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit)

shutdownAsync

public CompletableFuture<Void> shutdownAsync()

Shutdown this client and close all open connections asynchronously. Once all connections are closed, the associated ClientResources are shut down/released gracefully considering quiet time and the shutdown timeout. The client should be discarded after calling shutdown. The shutdown is executed without quiet time and a timeout of 2 TimeUnit.SECONDS.

Since:

4.4

See Also:

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit)

shutdownAsync

public CompletableFuture<Void> shutdownAsync(long quietPeriod,
                                             long timeout,
                                             TimeUnit timeUnit)

Shutdown this client and close all open connections asynchronously. Once all connections are closed, the associated ClientResources are shut down/released gracefully considering quiet time and the shutdown timeout. The client should be discarded after calling shutdown.

Parameters:

quietPeriod - the quiet period to allow the executor gracefully shut down.

timeout - the maximum amount of time to wait until the backing executor is shutdown regardless if a task was submitted during the quiet period.

timeUnit - the unit of quietPeriod and timeout.

Since:

4.4

See Also:

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit)

createHandshake

protected io.lettuce.core.RedisHandshake createHandshake(ConnectionState state)