com.lambdaworks.redis.cluster.models.partitions

Class Partitions

java.lang.Object

com.lambdaworks.redis.cluster.models.partitions.Partitions

All Implemented Interfaces:

Iterable<RedisClusterNode>, Collection<RedisClusterNode>

public class Partitions
extends Object
implements Collection<RedisClusterNode>

Cluster topology view. An instance of Partitions provides access to the partitions of a Redis Cluster. A partition is represented by a Redis Cluster node that has a nodeId and connection point details.

Partitions can be looked up by nodeId or slot (masters only). A nodeId can be migrated to a different host. Partitions are cached to ensure a cheap lookup by slot. Users of Partitions are required to call updateCache() after topology changes occur.

Topology changes are:

• Changes in RedisClusterNode.NodeFlag.MASTER/ RedisClusterNode.NodeFlag.SLAVE state
• Newly added or removed nodes to/from the Redis Cluster
• Changes in RedisClusterNode.getSlots() responsibility
• Changes to the slave replication source (the master of a slave)
• Changes to the RedisClusterNode.getUri() () connection point}

Since:

3.0

Author:

Mark Paluch

Constructor Summary

Constructors

Constructor and Description
Partitions()

Method Summary

Modifier and Type	Method and Description
boolean	add(RedisClusterNode redisClusterNode)
boolean	addAll(Collection<? extends RedisClusterNode> c)
void	addPartition(RedisClusterNode partition)
void	clear()
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
RedisClusterNode	getPartition(int index)
RedisClusterNode	getPartitionByNodeId(String nodeId) Retrieve a RedisClusterNode by its node id.
RedisClusterNode	getPartitionBySlot(int slot) Retrieve a RedisClusterNode by its slot number.
List<RedisClusterNode>	getPartitions()
boolean	isEmpty()
Iterator<RedisClusterNode>	iterator()
void	reload(List<RedisClusterNode> partitions) Update partitions and rebuild slot cache.
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] a)
String	toString()
void	updateCache() Update the partition cache.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

Partitions

public Partitions()

Method Detail

getPartitionBySlot

public RedisClusterNode getPartitionBySlot(int slot)

Retrieve a RedisClusterNode by its slot number. This method does not distinguish between masters and slaves.

Parameters:

slot - the slot

Returns:

RedisClusterNode or null

getPartitionByNodeId

public RedisClusterNode getPartitionByNodeId(String nodeId)

Retrieve a RedisClusterNode by its node id.

Parameters:

nodeId - the nodeId

Returns:

RedisClusterNode or null

updateCache

public void updateCache()

Update the partition cache. Updates are necessary after the partition details have changed.

iterator

public Iterator<RedisClusterNode> iterator()

Specified by:

iterator in interface Iterable<RedisClusterNode>

Specified by:

iterator in interface Collection<RedisClusterNode>

getPartitions

public List<RedisClusterNode> getPartitions()

addPartition

public void addPartition(RedisClusterNode partition)

toString

public String toString()

Overrides:

toString in class Object

size

public int size()

Specified by:

size in interface Collection<RedisClusterNode>

getPartition

public RedisClusterNode getPartition(int index)

reload

public void reload(List<RedisClusterNode> partitions)

Update partitions and rebuild slot cache.

Parameters:

partitions - list of new partitions

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<RedisClusterNode>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<RedisClusterNode>

addAll

public boolean addAll(Collection<? extends RedisClusterNode> c)

Specified by:

addAll in interface Collection<RedisClusterNode>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<RedisClusterNode>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<RedisClusterNode>

clear

public void clear()

Specified by:

clear in interface Collection<RedisClusterNode>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<RedisClusterNode>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<RedisClusterNode>

add

public boolean add(RedisClusterNode redisClusterNode)

Specified by:

add in interface Collection<RedisClusterNode>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<RedisClusterNode>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<RedisClusterNode>