com.lambdaworks.redis.cluster

Interface RedisAdvancedClusterConnection<K,V>

All Superinterfaces:

AutoCloseable, BaseRedisConnection<K,V>, Closeable, RedisClusterConnection<K,V>, RedisGeoConnection<K,V>, RedisHashesConnection<K,V>, RedisHLLConnection<K,V>, RedisKeysConnection<K,V>, RedisListsConnection<K,V>, RedisScriptingConnection<K,V>, RedisServerConnection<K,V>, RedisSetsConnection<K,V>, RedisSortedSetsConnection<K,V>, RedisStringsConnection<K,V>

public interface RedisAdvancedClusterConnection<K,V>
extends RedisClusterConnection<K,V>

Advanced synchronous cluster API.

Since:

3.3

Author:

Mark Paluch

Method Summary

Modifier and Type	Method and Description
RedisClusterConnection<K,V>	getConnection(String nodeId) Retrieve a connection to the specified cluster node using the nodeId.
RedisClusterConnection<K,V>	getConnection(String host, int port) Retrieve a connection to the specified cluster node using the nodeId.
ReadFrom	getReadFrom() Gets the ReadFrom setting for this connection.
void	setReadFrom(ReadFrom readFrom) Set from which nodes data is read.

Methods inherited from interface com.lambdaworks.redis.RedisClusterConnection

asking, close, clusterAddSlots, clusterCountFailureReports, clusterCountKeysInSlot, clusterDelSlots, clusterFailover, clusterFlushslots, clusterForget, clusterGetKeysInSlot, clusterInfo, clusterKeyslot, clusterMeet, clusterMyId, clusterNodes, clusterReplicate, clusterReset, clusterSaveconfig, clusterSetConfigEpoch, clusterSetSlotImporting, clusterSetSlotMigrating, clusterSetSlotNode, clusterSetSlotStable, clusterSlaves, clusterSlots, readOnly, readWrite

Methods inherited from interface com.lambdaworks.redis.RedisHashesConnection

hdel, hexists, hget, hgetall, hgetall, hincrby, hincrbyfloat, hkeys, hkeys, hlen, hmget, hmget, hmset, hscan, hscan, hscan, hscan, hscan, hscan, hscan, hscan, hset, hsetnx, hstrlen, hvals, hvals

Methods inherited from interface com.lambdaworks.redis.RedisKeysConnection

del, dump, exists, exists, expire, expireat, expireat, keys, keys, migrate, move, objectEncoding, objectIdletime, objectRefcount, persist, pexpire, pexpireat, pexpireat, pttl, randomkey, rename, renamenx, restore, scan, scan, scan, scan, scan, scan, scan, scan, sort, sort, sort, sort, sortStore, ttl, type, unlink

Methods inherited from interface com.lambdaworks.redis.RedisStringsConnection

append, bitcount, bitcount, bitopAnd, bitopNot, bitopOr, bitopXor, bitpos, bitpos, decr, decrby, get, getbit, getrange, getset, incr, incrby, incrbyfloat, mget, mget, mset, msetnx, psetex, set, set, setbit, setex, setnx, setrange, strlen

Methods inherited from interface com.lambdaworks.redis.RedisListsConnection

blpop, brpop, brpoplpush, lindex, linsert, llen, lpop, lpush, lpushx, lrange, lrange, lrem, lset, ltrim, rpop, rpoplpush, rpush, rpushx

Methods inherited from interface com.lambdaworks.redis.RedisSetsConnection

sadd, scard, sdiff, sdiff, sdiffstore, sinter, sinter, sinterstore, sismember, smembers, smembers, smove, spop, srandmember, srandmember, srandmember, srem, sscan, sscan, sscan, sscan, sscan, sscan, sscan, sscan, sunion, sunion, sunionstore

Methods inherited from interface com.lambdaworks.redis.RedisSortedSetsConnection

zadd, zadd, zadd, zadd, zaddincr, zcard, zcount, zcount, zincrby, zinterstore, zinterstore, zlexcount, zrange, zrange, zrangebylex, zrangebylex, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscore, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangebyscoreWithScores, zrangeWithScores, zrangeWithScores, zrank, zrem, zremrangebylex, zremrangebyrank, zremrangebyscore, zremrangebyscore, zrevrange, zrevrange, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscore, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangebyscoreWithScores, zrevrangeWithScores, zrevrangeWithScores, zrevrank, zscan, zscan, zscan, zscan, zscan, zscan, zscan, zscan, zscore, zunionstore, zunionstore

Methods inherited from interface com.lambdaworks.redis.RedisScriptingConnection

eval, eval, evalsha, evalsha, scriptExists, scriptFlush, scriptKill, scriptLoad

Methods inherited from interface com.lambdaworks.redis.RedisServerConnection

bgrewriteaof, bgsave, clientGetname, clientKill, clientKill, clientList, clientPause, clientSetname, command, commandCount, commandInfo, commandInfo, configGet, configResetstat, configRewrite, configSet, dbsize, debugHtstats, debugObject, debugOom, debugSegfault, flushall, flushallAsync, flushdb, flushdbAsync, info, info, lastsave, save, shutdown, slaveof, slaveofNoOne, slowlogGet, slowlogGet, slowlogLen, slowlogReset, sync, time

Methods inherited from interface com.lambdaworks.redis.RedisHLLConnection

pfadd, pfcount, pfmerge

Methods inherited from interface com.lambdaworks.redis.RedisGeoConnection

geoadd, geoadd, geodist, geopos, georadius, georadius, georadiusbymember, georadiusbymember

Methods inherited from interface com.lambdaworks.redis.BaseRedisConnection

digest, discard, echo, exec, isOpen, multi, ping, publish, pubsubChannels, pubsubChannels, pubsubNumpat, pubsubNumsub, quit, role, unwatch, waitForReplication, watch

Method Detail

getConnection

RedisClusterConnection<K,V> getConnection(String nodeId)

Retrieve a connection to the specified cluster node using the nodeId. Host and port are looked up in the node list. This connection is bound to the node id. Once the cluster topology view is updated, the connection will try to reconnect the to the node with the specified nodeId, that behavior can also lead to a closed connection once the node with the specified nodeId is no longer part of the cluster. Do not close the connections. Otherwise, unpredictable behavior will occur. The nodeId must be part of the cluster and is validated against the current topology view in Partitions. In contrast to the RedisAdvancedClusterConnection, node-connections do not route commands to other cluster nodes.

Parameters:

nodeId - the node Id

Returns:

a connection to the requested cluster node

Throws:

RedisException - if the requested node identified by nodeId is not part of the cluster

getConnection

RedisClusterConnection<K,V> getConnection(String host,
                                          int port)

Retrieve a connection to the specified cluster node using the nodeId. This connection is bound to a host and port. Updates to the cluster topology view can close the connection once the host, identified by host and port, are no longer part of the cluster. Do not close the connections. Otherwise, unpredictable behavior will occur. The node must be part of the cluster and host/port are validated (exact check) against the current topology view in Partitions. In contrast to the RedisAdvancedClusterConnection, node-connections do not route commands to other cluster nodes.

Parameters:

host - the host

port - the port

Returns:

a connection to the requested cluster node

Throws:

RedisException - if the requested node identified by host and port is not part of the cluster

setReadFrom

void setReadFrom(ReadFrom readFrom)

Set from which nodes data is read. The setting is used as default for read operations on this connection. See the documentation for ReadFrom for more information.

Parameters:

readFrom - the read from setting, must not be null

getReadFrom

ReadFrom getReadFrom()

Gets the ReadFrom setting for this connection. Defaults to ReadFrom.MASTER if not set.

Returns:

the read from setting or null