io.vertx.redis.client

Class RedisClusterConnectOptions

java.lang.Object

io.vertx.redis.client.RedisConnectOptions

io.vertx.redis.client.RedisClusterConnectOptions

public class RedisClusterConnectOptions
extends RedisConnectOptions

Constructor Summary

Constructors

Constructor and Description
RedisClusterConnectOptions()
RedisClusterConnectOptions(JsonObject json)
RedisClusterConnectOptions(RedisClusterConnectOptions other)
RedisClusterConnectOptions(RedisOptions options)

Method Summary

Modifier and Type	Method and Description
long	getHashSlotCacheTTL() Returns the TTL of the hash slot cache.
RedisReplicas	getUseReplicas() Get whether or not to use replica nodes (only considered in Cluster mode).
RedisClusterConnectOptions	setConnectionString(String connectionString) Sets a single connection string (endpoint) to use while connecting to the redis server.
RedisClusterConnectOptions	setEndpoints(List<String> endpoints) Set the endpoints to use while connecting to the redis server.
RedisClusterConnectOptions	setHashSlotCacheTTL(long hashSlotCacheTTL) Sets the TTL of the hash slot cache.
RedisClusterConnectOptions	setMaxNestedArrays(int maxNestedArrays) Tune how much nested arrays are allowed on a redis response.
RedisClusterConnectOptions	setMaxWaitingHandlers(int maxWaitingHandlers) The client will always work on pipeline mode, this means that messages can start queueing.
RedisClusterConnectOptions	setPassword(String password) Set the default password for cluster/sentinel connections.
RedisClusterConnectOptions	setProtocolNegotiation(boolean protocolNegotiation) Should the client perform REST protocol negotiation during the connection acquire.
RedisClusterConnectOptions	setUseReplicas(RedisReplicas useReplicas) Set whether or not to use replica nodes (only considered in Cluster mode).
JsonObject	toJson() Converts this object to JSON notation.

Methods inherited from class io.vertx.redis.client.RedisConnectOptions

addConnectionString, getEndpoint, getEndpoints, getMaxNestedArrays, getMaxWaitingHandlers, getPassword, isProtocolNegotiation

Methods inherited from class java.lang.Object

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

Constructor Detail

RedisClusterConnectOptions

public RedisClusterConnectOptions(RedisOptions options)

RedisClusterConnectOptions

public RedisClusterConnectOptions()

RedisClusterConnectOptions

public RedisClusterConnectOptions(RedisClusterConnectOptions other)

RedisClusterConnectOptions

public RedisClusterConnectOptions(JsonObject json)

Method Detail

getUseReplicas

public RedisReplicas getUseReplicas()

Get whether or not to use replica nodes (only considered in Cluster mode).

Returns:

the cluster replica node use mode.

setUseReplicas

public RedisClusterConnectOptions setUseReplicas(RedisReplicas useReplicas)

Set whether or not to use replica nodes (only considered in Cluster mode).

Parameters:

useReplicas - the cluster replica use mode.

Returns:

fluent self.

getHashSlotCacheTTL

public long getHashSlotCacheTTL()

Returns the TTL of the hash slot cache. This is only meaningful in case of a clustered Redis client.

The TTL is expressed in milliseconds. Defaults to 1000 millis (1 second).

Returns:

the TTL of the hash slot cache

setHashSlotCacheTTL

public RedisClusterConnectOptions setHashSlotCacheTTL(long hashSlotCacheTTL)

Sets the TTL of the hash slot cache. This is only meaningful in case of a clustered Redis client.

The TTL is expressed in milliseconds. Defaults to 1000 millis (1 second).

Parameters:

hashSlotCacheTTL - the TTL of the hash slot cache, in millis

setMaxNestedArrays

public RedisClusterConnectOptions setMaxNestedArrays(int maxNestedArrays)

Description copied from class: RedisConnectOptions

Tune how much nested arrays are allowed on a redis response. This affects the parser performance.

Overrides:

setMaxNestedArrays in class RedisConnectOptions

Parameters:

maxNestedArrays - the configured max nested arrays allowance.

Returns:

fluent self.

setProtocolNegotiation

public RedisClusterConnectOptions setProtocolNegotiation(boolean protocolNegotiation)

Description copied from class: RedisConnectOptions

Should the client perform REST protocol negotiation during the connection acquire. By default this is true, but there are situations when using broken servers it may be useful to skip this and always fallback to RESP2 without using the HELLO command.

Overrides:

setProtocolNegotiation in class RedisConnectOptions

Parameters:

protocolNegotiation - false to disable HELLO (not recommended) unless reasons...

Returns:

fluent self

setPassword

public RedisClusterConnectOptions setPassword(String password)

Description copied from class: RedisConnectOptions

Set the default password for cluster/sentinel connections.

Overrides:

setPassword in class RedisConnectOptions

Parameters:

password - the default password

Returns:

fluent self

setEndpoints

public RedisClusterConnectOptions setEndpoints(List<String> endpoints)

Description copied from class: RedisConnectOptions

Set the endpoints to use while connecting to the redis server. Only the cluster mode will consider more than 1 element. If more are provided, they are not considered by the client when in single server mode.

Overrides:

setEndpoints in class RedisConnectOptions

Parameters:

endpoints - list of socket addresses.

Returns:

fluent self.

setConnectionString

public RedisClusterConnectOptions setConnectionString(String connectionString)

Description copied from class: RedisConnectOptions

Sets a single connection string (endpoint) to use while connecting to the redis server. Will replace the previously configured connection strings.

Overrides:

setConnectionString in class RedisConnectOptions

Parameters:

connectionString - a string following the scheme: redis://[username:password@][host][:port][/[database].

Returns:

fluent self.

See Also:

Redis scheme on iana.org

setMaxWaitingHandlers

public RedisClusterConnectOptions setMaxWaitingHandlers(int maxWaitingHandlers)

Description copied from class: RedisConnectOptions

The client will always work on pipeline mode, this means that messages can start queueing. You can control how much backlog you're willing to accept. This methods sets how much handlers is the client willing to queue.

Overrides:

setMaxWaitingHandlers in class RedisConnectOptions

Parameters:

maxWaitingHandlers - max allowed queued waiting handlers.

Returns:

fluent self.

toJson

public JsonObject toJson()

Converts this object to JSON notation.

Overrides:

toJson in class RedisConnectOptions

Returns:

JSON