com.lambdaworks.redis.resource

Interface ClientResources

All Known Implementing Classes:

DefaultClientResources

public interface ClientResources

Client Configuration. The client configuration provides heavy-weight resources such as thread pools. ClientResources can be shared across different client instances. Shared instances are not shut down by the client, only dedicated instances are shut down.

This interface defines the contract. See the DefaultClientResources class for the default implementation.

The ClientResources instance is stateful. You have to shutdown the instance if you're no longer using it.

ClientResources provide:

• An instance of EventLoopGroupProvider to obtain particular EventLoopGroups
• An instance of EventExecutorGroup for performing internal computation tasks

Since:

3.4

Author:

Mark Paluch

Method Summary

Modifier and Type	Method and Description
CommandLatencyCollector	commandLatencyCollector() Returns the CommandLatencyCollector.
EventPublisherOptions	commandLatencyPublisherOptions() Returns the EventPublisherOptions for latency event publishing.
int	computationThreadPoolSize() Returns the pool size (number of threads) for all computation tasks.
DnsResolver	dnsResolver() Returns the DnsResolver.
EventBus	eventBus() Returns the event bus used to publish events.
EventExecutorGroup	eventExecutorGroup() Returns the computation pool used for internal operations.
EventLoopGroupProvider	eventLoopGroupProvider() Returns the EventLoopGroupProvider that provides access to the particular event loop groups. lettuce requires at least two implementations: NioEventLoopGroup for TCP/IP connections and EpollEventLoopGroup for unix domain socket connections (epoll).
int	ioThreadPoolSize() Returns the pool size (number of threads) for IO threads.
Delay	reconnectDelay() Returns the Delay for reconnect attempts.
Future<Boolean>	shutdown() Shutdown the ClientResources.
Future<Boolean>	shutdown(long quietPeriod, long timeout, TimeUnit timeUnit) Shutdown the ClientResources.

Method Detail

shutdown

Future<Boolean> shutdown()

Shutdown the ClientResources.

Returns:

eventually the success/failure of the shutdown without errors.

shutdown

Future<Boolean> shutdown(long quietPeriod,
                         long timeout,
                         TimeUnit timeUnit)

Shutdown the ClientResources.

Parameters:

quietPeriod - the quiet period as described in the documentation

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

timeUnit - the unit of quietPeriod and timeout

Returns:

eventually the success/failure of the shutdown without errors.

eventLoopGroupProvider

EventLoopGroupProvider eventLoopGroupProvider()

Returns the EventLoopGroupProvider that provides access to the particular event loop groups. lettuce requires at least two implementations: NioEventLoopGroup for TCP/IP connections and EpollEventLoopGroup for unix domain socket connections (epoll). You can use DefaultEventLoopGroupProvider as default implementation or implement an own EventLoopGroupProvider to share existing EventLoopGroup's with lettuce.

Returns:

the EventLoopGroupProvider which provides access to the particular event loop groups

eventExecutorGroup

EventExecutorGroup eventExecutorGroup()

Returns the computation pool used for internal operations. Such tasks are periodic Redis Cluster and Redis Sentinel topology updates and scheduling of connection reconnection by ConnectionWatchdog.

Returns:

the computation pool used for internal operations

ioThreadPoolSize

int ioThreadPoolSize()

Returns the pool size (number of threads) for IO threads. The indicated size does not reflect the number for all IO threads. TCP and socket connections (epoll) require different IO pool.

Returns:

the pool size (number of threads) for all IO tasks.

computationThreadPoolSize

int computationThreadPoolSize()

Returns the pool size (number of threads) for all computation tasks.

Returns:

the pool size (number of threads to use).

eventBus

EventBus eventBus()

Returns the event bus used to publish events.

Returns:

the event bus

commandLatencyPublisherOptions

EventPublisherOptions commandLatencyPublisherOptions()

Returns the EventPublisherOptions for latency event publishing.

Returns:

the EventPublisherOptions for latency event publishing

commandLatencyCollector

CommandLatencyCollector commandLatencyCollector()

Returns the CommandLatencyCollector.

Returns:

the command latency collector

dnsResolver

DnsResolver dnsResolver()

Returns the DnsResolver.

Returns:

the DNS resolver

reconnectDelay

Delay reconnectDelay()

Returns the Delay for reconnect attempts. Each connection uses its own attempt counter.

Returns:

the reconnect Delay.