Module lettuce.core
Package io.lettuce.core.masterslave

Class MasterSlave

java.lang.Object
io.lettuce.core.masterslave.MasterSlave
@Deprecated
public class MasterSlave
extends Object
Deprecated.
since 5.2, use MasterReplica
Master-Slave connection API.

This API allows connections to Redis Master/Slave setups which run either in a static Master/Slave setup or are managed by Redis Sentinel. Master-Slave connections can discover topologies and select a source for read operations using ReadFrom.

Connections can be obtained by providing the RedisClient, a RedisURI and a RedisCodec. 

 RedisClient client = RedisClient.create();
 StatefulRedisMasterSlaveConnection<String, String> connection = MasterSlave.connect(client,
         RedisURI.create("redis://localhost"), StringCodec.UTF8);
 // ...

 connection.close();
 client.shutdown();

Topology Discovery

Master-Slave topologies are either static or semi-static. Redis Standalone instances with attached slaves provide no failover/HA mechanism. Redis Sentinel managed instances are controlled by Redis Sentinel and allow failover (which include master promotion). The MasterSlave API supports both mechanisms. The topology is provided by a TopologyProvider:

  • MasterReplicaTopologyProvider: Dynamic topology lookup using the INFO REPLICATION output. Slaves are listed as slaveN=... entries. The initial connection can either point to a master or a replica and the topology provider will discover nodes. The connection needs to be re-established outside of lettuce in a case of Master/Slave failover or topology changes.
  • StaticMasterReplicaTopologyProvider: Topology is defined by the list of URIs and the ROLE output. MasterSlave uses only the supplied nodes and won't discover additional nodes in the setup. The connection needs to be re-established outside of lettuce in a case of Master/Slave failover or topology changes.
  • SentinelTopologyProvider: Dynamic topology lookup using the Redis Sentinel API. In particular, SENTINEL MASTER and SENTINEL SLAVES output. Master/Slave failover is handled by lettuce.

Topology Updates

  • Standalone Master/Slave: Performs a one-time topology lookup which remains static afterward
  • Redis Sentinel: Subscribes to all Sentinels and listens for Pub/Sub messages to trigger topology refreshing

Connection Fault-Tolerance

Connecting to Master/Slave bears the possibility that individual nodes are not reachable. MasterSlave can still connect to a partially-available set of nodes.
  • Redis Sentinel: At least one Sentinel must be reachable, the masterId must be registered and at least one host must be available (master or slave). Allows for runtime-recovery based on Sentinel Events.
  • Static Setup (auto-discovery): The initial endpoint must be reachable. No recovery/reconfiguration during runtime.
  • Static Setup (provided hosts): All endpoints must be reachable. No recovery/reconfiguration during runtime.
Since:
4.1
Author:
Mark Paluch

  • Constructor Details

    • MasterSlave

      public MasterSlave()
      Deprecated.

  • Method Details

    • connect

      public static <K,​ V> StatefulRedisMasterSlaveConnection<K,​V> connect​(RedisClient redisClient, RedisCodec<K,​V> codec, RedisURI redisURI)
      Deprecated.
      Open a new connection to a Redis Master-Slave server/servers using the supplied RedisURI and the supplied codec to encode/decode keys.

      This MasterSlave performs auto-discovery of nodes using either Redis Sentinel or Master/Slave. A RedisURI can point to either a master or a replica host.

      Type Parameters:
      K - Key type.
      V - Value type.
      Parameters:
      redisClient - the Redis client.
      codec - Use this codec to encode/decode keys and values, must not be null.
      redisURI - the Redis server to connect to, must not be null.
      Returns:
      a new connection.

    • connectAsync

      public static <K,​ V> CompletableFuture<StatefulRedisMasterSlaveConnection<K,​V>> connectAsync​(RedisClient redisClient, RedisCodec<K,​V> codec, RedisURI redisURI)
      Deprecated.
      Open asynchronously a new connection to a Redis Master-Slave server/servers using the supplied RedisURI and the supplied codec to encode/decode keys.

      This MasterSlave performs auto-discovery of nodes using either Redis Sentinel or Master/Slave. A RedisURI can point to either a master or a replica host.

      Type Parameters:
      K - Key type.
      V - Value type.
      Parameters:
      redisClient - the Redis client.
      codec - Use this codec to encode/decode keys and values, must not be null.
      redisURI - the Redis server to connect to, must not be null.
      Returns:
      CompletableFuture that is notified once the connect is finished.
      Since:

    • connect

      public static <K,​ V> StatefulRedisMasterSlaveConnection<K,​V> connect​(RedisClient redisClient, RedisCodec<K,​V> codec, Iterable<RedisURI> redisURIs)
      Deprecated.
      Open a new connection to a Redis Master-Slave server/servers using the supplied RedisURI and the supplied codec to encode/decode keys.

      This MasterSlave performs auto-discovery of nodes if the URI is a Redis Sentinel URI. Master/Slave URIs will be treated as static topology and no additional hosts are discovered in such case. Redis Standalone Master/Slave will discover the roles of the supplied URIs and issue commands to the appropriate node.

      When using Redis Sentinel, ensure that redisURIs contains only a single entry as only the first URI is considered. RedisURI pointing to multiple Sentinels can be configured through RedisURI.Builder.withSentinel(java.lang.String).

      Type Parameters:
      K - Key type.
      V - Value type.
      Parameters:
      redisClient - the Redis client.
      codec - Use this codec to encode/decode keys and values, must not be null.
      redisURIs - the Redis server(s) to connect to, must not be null.
      Returns:
      a new connection.

    • connectAsync

      public static <K,​ V> CompletableFuture<StatefulRedisMasterSlaveConnection<K,​V>> connectAsync​(RedisClient redisClient, RedisCodec<K,​V> codec, Iterable<RedisURI> redisURIs)
      Deprecated.
      Open asynchronously a new connection to a Redis Master-Slave server/servers using the supplied RedisURI and the supplied codec to encode/decode keys.

      This MasterSlave performs auto-discovery of nodes if the URI is a Redis Sentinel URI. Master/Slave URIs will be treated as static topology and no additional hosts are discovered in such case. Redis Standalone Master/Slave will discover the roles of the supplied URIs and issue commands to the appropriate node.

      When using Redis Sentinel, ensure that redisURIs contains only a single entry as only the first URI is considered. RedisURI pointing to multiple Sentinels can be configured through RedisURI.Builder.withSentinel(java.lang.String).

      Type Parameters:
      K - Key type.
      V - Value type.
      Parameters:
      redisClient - the Redis client.
      codec - Use this codec to encode/decode keys and values, must not be null.
      redisURIs - the Redis server(s) to connect to, must not be null.
      Returns:
      CompletableFuture that is notified once the connect is finished.