RedisClusterClient clusterClient = new RedisClusterClient(RedisURI.Builder.redis("localhost", 7379).build());
StatefulRedisClusterConnection<String, String> connection = clusterClient.connect();

connection.setReadFrom(ReadFrom.SLAVE);

String value = connection.sync().get("key");

The code example illustrates how to connect a Redis Cluster. The ReadFrom is set to SLAVE. Writes are issued always to the master but reads are dispatched in this case to a slave node. lettuce takes care that it uses the right slave. Keys are partitioned by slot hashes; A slot is handled by one master which can be backed by zero, one or multiple slaves. A slave holds the copy of exactly one master and not the whole cluster.

Use Cases for non-master reads

The following use cases are common for using non-master read settings and encourage eventual consistency:

• Providing local reads for geographically distributed applications. If you have Redis and application servers in multiple data centers, you may consider having a geographically distributed cluster. Using the NEAREST setting allows the client to read from the lowest-latency members, rather than always reading from the master node.
• Maintaining availability during a failover. Use MASTER_PREFERRED if you want an application to read from the master by default, but to allow stale reads from slaves when the master node is unavailable. MASTER_PREFERRED allows a "read-only mode" for your application during a failover.
• Increase read throughput by allowing stale reads If you want to increase your read throughput by adding additional slave nodes to your cluster Use SLAVE to read explicitly from slaves and reduce read load on the master node. Using slave reads can highly lead to stale reads.

All ReadFrom settings except MASTER may return stale data because slaves replication is asynchronous and requires some delay. You need to ensure that your application can tolerate stale data.

Read from settings

Custom read settings can be implemented by extending the com.lambdaworks.redis.ReadFrom class.

ReadFrom Settings are available in lettuce 4.0.Beta2 and can be downloaded from Github or the Maven Central Repository.

Links

• Release on Github
• Download lettuce 4.0.Beta2
• Wiki
• Javadoc

Maven coordinates:

<dependency>
    <groupId>biz.paluch.redis</groupId>
    <artifactId>lettuce</artifactId>
    <version>4.0.Beta2</version>
</dependency>

<dependency>
    <groupId>biz.paluch.redis</groupId>
    <artifactId>lettuce</artifactId>
    <version>4.0.Beta2</version>
    <classifier>shaded</classifier>
</dependency>

Any feedback is appreciated or file an issue on GitHub.