io.lettuce.core.cluster

Class ClusterClientOptions.Builder

java.lang.Object

io.lettuce.core.ClientOptions.Builder

io.lettuce.core.cluster.ClusterClientOptions.Builder

Enclosing class:

ClusterClientOptions

public static class ClusterClientOptions.Builder
extends ClientOptions.Builder

Builder for ClusterClientOptions.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Builder()

Method Summary

Modifier and Type	Method and Description
ClusterClientOptions.Builder	autoReconnect(boolean autoReconnect) Enables or disables auto reconnection on connection loss.
ClusterClientOptions.Builder	bufferUsageRatio(int bufferUsageRatio) Buffer usage ratio for CommandHandler.
ClusterClientOptions	build() Create a new instance of ClusterClientOptions
ClusterClientOptions.Builder	cancelCommandsOnReconnectFailure(boolean cancelCommandsOnReconnectFailure) Allows cancelling queued commands in case a reconnect fails.Defaults to false.
ClusterClientOptions.Builder	disconnectedBehavior(ClientOptions.DisconnectedBehavior disconnectedBehavior) Sets the behavior for command invocation when connections are in a disconnected state.
ClusterClientOptions.Builder	maxRedirects(int maxRedirects) Number of maximal cluster redirects (-MOVED and -ASK) to follow in case a key was moved from one node to another node.
ClusterClientOptions.Builder	pingBeforeActivateConnection(boolean pingBeforeActivateConnection) Deprecated.
ClusterClientOptions.Builder	publishOnScheduler(boolean publishOnScheduler) Use a dedicated Scheduler to emit reactive data signals.
ClusterClientOptions.Builder	requestQueueSize(int requestQueueSize) Set the per-connection request queue size.
ClusterClientOptions.Builder	socketOptions(SocketOptions socketOptions) Sets the low-level SocketOptions for the connections kept to Redis servers.
ClusterClientOptions.Builder	sslOptions(SslOptions sslOptions) Sets the SslOptions for SSL connections kept to Redis servers.
ClusterClientOptions.Builder	suspendReconnectOnProtocolFailure(boolean suspendReconnectOnProtocolFailure) Suspends reconnect when reconnects run into protocol failures (SSL verification, PING before connect fails).
ClusterClientOptions.Builder	timeoutOptions(TimeoutOptions timeoutOptions) Sets the TimeoutOptions to expire and cancel commands.
ClusterClientOptions.Builder	topologyRefreshOptions(ClusterTopologyRefreshOptions topologyRefreshOptions) Sets the ClusterTopologyRefreshOptions for detailed control of topology updates.
ClusterClientOptions.Builder	validateClusterNodeMembership(boolean validateClusterNodeMembership) Validate the cluster node membership before allowing connections to a cluster node.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

protected Builder()

Method Detail

validateClusterNodeMembership

public ClusterClientOptions.Builder validateClusterNodeMembership(boolean validateClusterNodeMembership)

Validate the cluster node membership before allowing connections to a cluster node. Defaults to true. See ClusterClientOptions.DEFAULT_VALIDATE_CLUSTER_MEMBERSHIP.

Parameters:

validateClusterNodeMembership - true if validation is enabled.

Returns:

this

maxRedirects

public ClusterClientOptions.Builder maxRedirects(int maxRedirects)

Number of maximal cluster redirects (-MOVED and -ASK) to follow in case a key was moved from one node to another node. Defaults to 5. See ClusterClientOptions.DEFAULT_MAX_REDIRECTS.

Parameters:

maxRedirects - the limit of maximal cluster redirects

Returns:

this

topologyRefreshOptions

public ClusterClientOptions.Builder topologyRefreshOptions(ClusterTopologyRefreshOptions topologyRefreshOptions)

Sets the ClusterTopologyRefreshOptions for detailed control of topology updates.

Parameters:

topologyRefreshOptions - the ClusterTopologyRefreshOptions

Returns:

this

pingBeforeActivateConnection

@Deprecated
public ClusterClientOptions.Builder pingBeforeActivateConnection(boolean pingBeforeActivateConnection)

Deprecated.

Description copied from class: ClientOptions.Builder

Sets the PING before activate connection flag. Defaults to false. See ClientOptions.DEFAULT_PING_BEFORE_ACTIVATE_CONNECTION.

Overrides:

pingBeforeActivateConnection in class ClientOptions.Builder

Parameters:

pingBeforeActivateConnection - true/false

Returns:

this

autoReconnect

public ClusterClientOptions.Builder autoReconnect(boolean autoReconnect)

Description copied from class: ClientOptions.Builder

Enables or disables auto reconnection on connection loss. Defaults to true. See ClientOptions.DEFAULT_AUTO_RECONNECT.

Overrides:

autoReconnect in class ClientOptions.Builder

Parameters:

autoReconnect - true/false

Returns:

this

suspendReconnectOnProtocolFailure

public ClusterClientOptions.Builder suspendReconnectOnProtocolFailure(boolean suspendReconnectOnProtocolFailure)

Description copied from class: ClientOptions.Builder

Suspends reconnect when reconnects run into protocol failures (SSL verification, PING before connect fails). Defaults to false. See ClientOptions.DEFAULT_SUSPEND_RECONNECT_PROTO_FAIL.

Overrides:

suspendReconnectOnProtocolFailure in class ClientOptions.Builder

Parameters:

suspendReconnectOnProtocolFailure - true/false

Returns:

this

cancelCommandsOnReconnectFailure

public ClusterClientOptions.Builder cancelCommandsOnReconnectFailure(boolean cancelCommandsOnReconnectFailure)

Description copied from class: ClientOptions.Builder

Allows cancelling queued commands in case a reconnect fails.Defaults to false. See ClientOptions.DEFAULT_CANCEL_CMD_RECONNECT_FAIL.

Overrides:

cancelCommandsOnReconnectFailure in class ClientOptions.Builder

Parameters:

cancelCommandsOnReconnectFailure - true/false

Returns:

this

publishOnScheduler

public ClusterClientOptions.Builder publishOnScheduler(boolean publishOnScheduler)

Description copied from class: ClientOptions.Builder

Use a dedicated Scheduler to emit reactive data signals. Enabling this option can be useful for reactive sequences that require a significant amount of processing with a single/a few Redis connections.

A single Redis connection operates on a single thread. Operations that require a significant amount of processing can lead to a single-threaded-like behavior for all consumers of the Redis connection. When enabled, data signals will be emitted using a different thread served by ClientResources.eventExecutorGroup(). Defaults to false , see ClientOptions.DEFAULT_PUBLISH_ON_SCHEDULER.

Overrides:

publishOnScheduler in class ClientOptions.Builder

Parameters:

publishOnScheduler - true/false

Returns:

this

See Also:

Subscriber.onNext(Object), ClientResources.eventExecutorGroup()

requestQueueSize

public ClusterClientOptions.Builder requestQueueSize(int requestQueueSize)

Description copied from class: ClientOptions.Builder

Set the per-connection request queue size. The command invocation will lead to a RedisException if the queue size is exceeded. Setting the requestQueueSize to a lower value will lead earlier to exceptions during overload or while the connection is in a disconnected state. A higher value means hitting the boundary will take longer to occur, but more requests will potentially be queued up and more heap space is used. Defaults to Integer.MAX_VALUE. See ClientOptions.DEFAULT_REQUEST_QUEUE_SIZE.

Overrides:

requestQueueSize in class ClientOptions.Builder

Parameters:

requestQueueSize - the queue size.

Returns:

this

disconnectedBehavior

public ClusterClientOptions.Builder disconnectedBehavior(ClientOptions.DisconnectedBehavior disconnectedBehavior)

Description copied from class: ClientOptions.Builder

Sets the behavior for command invocation when connections are in a disconnected state. Defaults to true. See ClientOptions.DEFAULT_DISCONNECTED_BEHAVIOR.

Overrides:

disconnectedBehavior in class ClientOptions.Builder

Parameters:

disconnectedBehavior - must not be null.

Returns:

this

socketOptions

public ClusterClientOptions.Builder socketOptions(SocketOptions socketOptions)

Description copied from class: ClientOptions.Builder

Sets the low-level SocketOptions for the connections kept to Redis servers. See ClientOptions.DEFAULT_SOCKET_OPTIONS.

Overrides:

socketOptions in class ClientOptions.Builder

Parameters:

socketOptions - must not be null.

Returns:

this

sslOptions

public ClusterClientOptions.Builder sslOptions(SslOptions sslOptions)

Description copied from class: ClientOptions.Builder

Sets the SslOptions for SSL connections kept to Redis servers. See ClientOptions.DEFAULT_SSL_OPTIONS.

Overrides:

sslOptions in class ClientOptions.Builder

Parameters:

sslOptions - must not be null.

Returns:

this

timeoutOptions

public ClusterClientOptions.Builder timeoutOptions(TimeoutOptions timeoutOptions)

Description copied from class: ClientOptions.Builder

Sets the TimeoutOptions to expire and cancel commands. See ClientOptions.DEFAULT_TIMEOUT_OPTIONS.

Overrides:

timeoutOptions in class ClientOptions.Builder

Parameters:

timeoutOptions - must not be null.

Returns:

this

bufferUsageRatio

public ClusterClientOptions.Builder bufferUsageRatio(int bufferUsageRatio)

Description copied from class: ClientOptions.Builder

Buffer usage ratio for CommandHandler. This ratio controls how often bytes are discarded during decoding. In particular, when buffer usage reaches bufferUsageRatio / bufferUsageRatio + 1. E.g. setting bufferUsageRatio to 3, will discard read bytes once the buffer usage reaches 75 percent. See ClientOptions.DEFAULT_BUFFER_USAGE_RATIO.

Overrides:

bufferUsageRatio in class ClientOptions.Builder

Parameters:

bufferUsageRatio - must greater between 0 and 2^31-1, typically a value between 1 and 10 representing 50% to 90%.

Returns:

this

build

public ClusterClientOptions build()

Create a new instance of ClusterClientOptions

Overrides:

build in class ClientOptions.Builder

Returns:

new instance of ClusterClientOptions