6.0.7.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.0.7 service release!
This release ships with bugfixes and dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.0.7.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.0.7.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.0.7.RELEASE/api/

🪲 Bug Fixes

• Exception thrown during RedisClusterClient shutdown #1800

💡 Other

• Dependency upgrades #1808

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @jdeppe-pivotal

6.1.3.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.1.3 service release!
This release ships with bugfixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.1.3.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and
works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.1.3.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.1.3.RELEASE/api/

⭐ New Features

• Introduce API to allow for extending RedisClusterClient and its connections #1754
• Could not initialize JfrConnectionCreatedEvent #1767
• Add support for double timeouts for BZPOP and BLPOP/BRPOP commands #1772

🪲 Bug Fixes

• AbstractRedisClient#shutdown() never ends when Redis is unstable #1768
• Closing ClusterNodeEndpoint asynchronously doesn't retrigger buffered commands #1769
• CopyArgs should honor replace parameter value instead of doing null check only #1777

💡 Other

• Upgrade to Netty 4.1.65.Final #1778
• Upgrade to Reactor 3.3.18 #1779

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @Alfagun74
• @christophstrobl
• @ikeyat
• @jruaux

6.0.6.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.0.6 service release!
This release ships with bugfixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.0.6.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.0.6.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.0.6.RELEASE/api/

🪲 Bug Fixes

• AbstractRedisClient#shutdown() never ends when Redis is unstable #1768
• Closing ClusterNodeEndpoint asynchronously doesn't retrigger buffered commands #1769

💡 Other

• Upgrade to Netty 4.1.65.Final #1778
• Upgrade to Reactor 3.3.18 #1779

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @ikeyat

6.1.2.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.1.2 service release!
This release ships with bugfixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.1.2.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and
works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.1.2.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.1.2.RELEASE/api/

⭐ New Features

🪲 Bug Fixes

• Cannot refresh Redis Cluster topology #1706
• Additional Redis PubSub types missing from reflect-config.json #1737

💡 Other

• Edit wiki for versioned pages #1699
• Upgrade to Reactor 3.3.17 #1746

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @eleftherias
• @jay-june

6.0.5.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.0.5 service release!
This release ships with bugfixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.0.5.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.0.5.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.0.5.RELEASE/api/

🪲 Bug Fixes

• Additional Redis PubSub types missing from reflect-config.json #1737

💡 Other

• Edit wiki for versioned pages #1699
• Upgrade to Reactor 3.3.17 #1746

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @eleftherias

6.1.1.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.1.1 service release!
This release ships with bug fixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.1.1.RELEASE possible. Lettuce 6 supports Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.1.1.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.1.1.RELEASE/api/

⭐ New Features

• Allow configuring a default ThreadFactoryProvider to create ClientResources #1711

🪲 Bug Fixes

• Fix potential null-dereference in CommandHandler #1703 (Thanks to @wbzj1110)
• RedisPubSubCommands,RedisClusterPubSubCommands, and other types missing in reflect-config.json #1710

💡 Other

• Upgrade to Netty 4.1.63.Final #1696
• RedisURI: improve deprecation notice in withPassword() #1707 (Thanks to @perlun)
• Upgrade to Reactor 3.3.16.RELEASE #1720

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @perlun
• @wbzj1110

6.0.4.RELEASE

The Lettuce team is pleased to announce the Lettuce 6.0.4 service release!
This release ships with bug fixes and selected enhancements along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 6.0.4.RELEASE possible. Lettuce 6 supports
Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

• Reference documentation: https://lettuce.io/core/6.0.4.RELEASE/reference/
• Javadoc: https://lettuce.io/core/6.0.4.RELEASE/api/

⭐ New Features

• Add overload to ScanArgs to accept a binary match #1675
• Allow configuring a default ThreadFactoryProvider to create ClientResources #1711

🪲 Bug Fixes

• Fix potential null-dereference in CommandHandler #1703 (Thanks to @wbzj1110)
• RedisPubSubCommands,RedisClusterPubSubCommands, and other types missing
  in reflect-config.json #1710

💡 Other

• Upgrade to Netty 4.1.63.Final #1696
• RedisURI: improve deprecation notice in withPassword() #1707 (Thanks to @perlun)
• Upgrade to Reactor 3.3.16.RELEASE #1720

❤️ Contributors

We'd like to thank all the contributors who worked on this release!

• @perlun
• @wbzj1110

5.3.7.RELEASE

The Lettuce team is pleased to announce the Lettuce 5.3.7 service release!
This release ships with 8 tickets fixed along with dependency upgrades.

Find the full changelog at the end of this document.

Thanks to all contributors who made Lettuce 5.3.7.RELEASE possible. Lettuce 6 supports Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16. It is tested continuously against the latest Redis source-build.

📗 Links

Reference documentation: https://lettuce.io/core/5.3.7.RELEASE/reference/
Javadoc: https://lettuce.io/core/5.3.7.RELEASE/api/

🪲 Bug Fixes

• Sentinel lookup connection leaks if no master address reported #1558 (Thanks to
  @wwwjinlong)
• NullPointerException in BoundedAsyncPool.createIdle() when availableCapacity=0 #1611 (
  Thanks to @fbotis)
• XREADGROUP skips messages if body is nil #1622 (Thanks to @asalabaev)
• Fix potential null-dereference in CommandHandler #1703 (Thanks to @wbzj1110)
• RedisPubSubCommands,RedisClusterPubSubCommands, and other types missing
  in reflect-config.json #1710

💡 Other

• Typo in string reactive commands #1632 (Thanks to @paualarco)
• Upgrade to Netty 4.1.63.Final #1696
• Upgrade to Reactor 3.3.16.RELEASE #1720

6.1.0.RELEASE

The Lettuce team is delighted to announce general availability of Lettuce 6.1.

This is a massive release thanks to all the community contributions.
Most notable changes that ship with this release are:

• Support for Redis 6.2 commands and modifier/argument updates
• Micrometer integration
• CommandListeners API to intercept Redis commands
• extended Keep-Alive options
• Coroutine variant of ScanStream
• TCP NoDelay enabled by default
• Experimental support for io_uring
• Java Flight Recorder Integration for Connection and Cluster Events

Lettuce 6 supports Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16.

Thanks to all contributors who made Lettuce 6.1.0 possible.

Documentation

Reference documentation: https://lettuce.io/core/6.1.0.RELEASE/reference/
Javadoc: https://lettuce.io/core/6.1.0.RELEASE/api/

Micrometer Integration

Lettuce ships an integration for Micrometer. Commands are tracked by using two Micrometer Times: lettuce.command.firstresponse and lettuce.command.completion. The following tags are attached to each timer:

• command: Name of the command (GET, SET, …)
• local: Local socket (localhost/127.0.0.1:45243 or ANY when local distinction is disabled, which is the default behavior)
• remote: Remote socket (localhost/127.0.0.1:6379)

To enable Micrometer, create MicrometerCommandLatencyRecorder from MeterRegistry and register it in ClientResources:

MeterRegistry meterRegistry = …;
MicrometerOptions options = MicrometerOptions.create();
ClientResources resources = ClientResources.builder().commandLatencyRecorder(new MicrometerCommandLatencyRecorder(meterRegistry, options)).build();

RedisClient client = RedisClient.create(resources);

Make sure to have Micrometer on your class path (example from a Maven pom.xml):

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-core</artifactId>
    <version>${micrometer.version}</version>
</dependency>

See also: https://github.com/lettuce-io/lettuce-core/wiki/Command-Latency-Metrics#command.latency.metrics.micrometer

CommandListeners

Command listeners allow intercepting Redis Command calls before the command is sent and upon completion (success/failure). A CommandListener can be registered with RedisClient and RedisClusterClient:

RedisClient client = …;

client.addListener(new CommandListener() {
    @Override
    public void commandStarted(CommandStartedEvent event) {
        Map<String, Object> context = event.getContext();
        context.put(…);
    }

    @Override
    public void commandSucceeded(CommandSucceededEvent event) {
        Map<String, Object> context = event.getContext();
    }

    @Override
    public void commandFailed(CommandFailedEvent event) {
        CommandListener.super.commandFailed(event);
    }
});


StatefulRedisConnection<String, String> connection = client.connect();

Command events allow attaching contextual details that can be accessed upon completion.

Experimental support for io_uring

We've adopted Netty's experimental io_uring support for Linux-based systems to allow participating in improved I/O performance.

io_uring will be enabled automatically if you're running on Linux and you have the dependency on your classpath:

<dependency>
    <groupId>io.netty.incubator</groupId>
    <artifactId>netty-incubator-transport-native-io_uring</artifactId>
    <version>${netty.transport-native-io_uring.version}</version>
    <classifier>linux-x86_64</classifier>
</dependency>

When having both native transports enabled (io_uring and epoll), then io_uring has precedence over epoll.
We'd love to hear from you how io_uring works out for you.

Java Flight Recorder Integration

Lettuce emits Connection and Cluster events as Java Flight Recorder events. EventBus emits all events to EventRecorder and the actual event bus.

EventRecorder verifies whether your runtime provides the required JFR classes (available as of JDK 8 update 262 or later) and if so, then it creates Flight Recorder variants of the event and commits these to JFR.

The following events are supported out of the box:

Redis Connection Events

• Connection Attempt
• Connect, Disconnect, Connection Activated, Connection Deactivated
• Reconnect Attempt and Reconnect Failed

Redis Cluster Events

• Topology Refresh initiated
• Topology Changed
• ASK and MOVED redirects

Redis Master/Replica Events

• Sentinel Topology Refresh initiated
• Master/Replica Topology Changed

Events come with a rich set of event attributes such as channelId, epId (endpoint Id), Redis URI and many more.

You can record data by starting your application with:

java -XX:StartFlightRecording:filename=recording.jfr,duration=10s …

Hostname support for Redis Sentinel

Since Redis 6.2, Redis Sentinel and Redis itself can use hostnames to announce its replication partner.
Lettuce accepts this information as SocketAddress and passes on the address to Netty which then can perform the hostname resolution.

Please pay special attention when using ReadFrom.subnet(…) as ReadFrom operates on the raw addressing information reported by Redis without applying further hostname resolution.

Option to configure SSL/TLS verification level

RedisURI.setVerifyPeer(…) now accepts SslVerifyMode which can be one of NONE (corresponds with setVerifyPeer(false)), CA and FULL (corresponds with setVerifyPeer(true)).

Peer verification settings update on SSLParameters for CA and FULL verification mode and NONE overwrites trustManager(…) during SSL bootstrapping.

Commands

• Add support for SET … GET option #1442
• Add support for (B)LMOVE source destination LEFT|RIGHT LEFT|RIGHT command #1448
• Add support for ZMSCORE key member [member ...] command #1449
• Add support for ZINTER/ZUNION commands #1450
• Add support for ZADD GT/LT options #1451
• Add support for SMISMEMBER key member [member ...] command #1452
• Support NOMKSTREAM option in XADD command #1502
• Support option CREATECONSUMER in XGROUP command #1505 (Thanks to @dengliming)
• Add support for ZRANGESTORE command #1506
• Add support for ZDIFF and ZDIFFSTORE commands #1507
• Add support for COPY command #1508
• Add support for local addr in CLIENT KILL #1536
• Add support for IDLE option in XPENDING #1537
• Support for ACL commands #1538 (Thanks to @GraemeMitchell84)
• Add support for LPOP and RPOP with COUNT #1545
• Missing support for TYPE parameter of SCAN command #1559 (Thanks to @mvmn)
• Add support for GEOSEARCH and GEOSEARCHSTORE #1561
• Add support for ReadFrom.subnet #1569 (Thanks to @yueki1993)
• Add support for MINID trimming strategy and the LIMIT argument to XADD and XTRIM #1582
• Add exclusive range query to XPENDING #1585
• Add support for GEOADD [CH] [NX|XX] options #1584
• Add support for HRANDFIELD and ZRANDMEMBER commands #1605
• Add support for GETEX, GETDEL commands #1606
• Add support for PXAT/EXAT arguments to SET command #1607
• Add FlushMode to FLUSHALL and FLUSHDB, and to SCRIPT FLUSH #1608
• Add support for MIGRATE AUTH2 option #1633
• Add support for RESTORE ABSTTL #1634
• Add support for XAUTOCLAIM #1574
• Add support for CLIENT KILL USER #1672 (Thanks to @dengliming)
• Add support IDLETIME and FREQ args to RESTORE command #1683 (Thanks to @dengliming)
• Add support for OBJECT FREQ #1684 (Thanks to @dengliming)

Enhancements

• Add Micrometer integration #795
• Add support for CommandListeners #1382 (Thanks to @sokomishalov)
• Add support for Java Flight Recorder #1430
• Provide a Coroutine variant of ScanStream/ScanIterator #1435
• Introduce extended Keep-Alive options #1437
• Add anyReplica setting for ReadFrom #1444 (Thanks to @omer-cilingir)
• Option to configure SSL/TLS verification level #1460 (Thanks to @Lucas3oo)
• Use Netty's asynchronous DNS resolver #1498 (Thanks to @yueki1993)
• Extend CommandDetailParser to include ACL details #1503
• Consider reinstating master-replica wording #1518 (Thanks to @perlun)
• Add support for io_uring #1522
• Provide VoidOutput for Fire&Forget command usage #1529 (Thanks to @jaredpetersen)
• Improve unsupported error logging for CommandOutput #1532
• Allow providing custom ClusterTopologyRefresh implementation. #1598 (Thanks to @alessandrosimi-sa)
• Introduce LettuceStrings.isEmpty(String) overload with optimized isEmpty checking #1609
• Add hostname support to Sentinel #1635
• Introduce GeoValue value type #1643
• Add overload to ScanArgs to accept a binary match #1675

Fixes

• Fix EXEC without MULTI when using coroutines over async #1441 (Thanks to @sokomishalov)
• Lettuce with Tracing enabled fails to connect to a Redis Sentinel #1470 (Thanks to @jsonwan)
• Lettuce doesn't handle deleted stream items (NullPointerException) #1474 (Thanks to @chemist777)
• LettuceStrings does not handle -nan which is returned by FT.INFO in redisearch #1482 (Thanks to @krm1312)
• Improperly decoding command responses #1512 (Thanks to @johnny-costanzo)
• Fix timeout parameter for nanoseconds in RedisURI #1528 (Thanks to @izeye)
• Fix build break when missing netty-dns-resolver #1546 (Thanks to @yueki1993)
• Sentinel lookup connection leaks if no master address reported #1558 (Thanks to @wwwjinlong)
• Lettuce 6.0.1 fails with GraalVM 20.3 #1562 (Thanks to @atrianac)
• Reactive stream spec violation when using command timeout #157...

6.1.0.RC1

The Lettuce team is delighted to announce the availability of Lettuce 6.1 RC1.

This is a massive release thanks to all the community contributions. This release ships mostly with command updates to support Redis 6.2.
Besides that, Lettuce publishes now events to Java Flight Recorder if your Java runtime supports JFR events (JDK 8 update 262 or later).

Lettuce 6 supports Redis 2.6+ up to Redis 6.x. In terms of Java runtime, Lettuce requires at least Java 8 and works with Java 16.
Thanks to all contributors who made Lettuce 6.1.0.RC1 possible.

Documentation

Reference documentation: https://lettuce.io/core/6.1.0.RC1/reference/
Javadoc: https://lettuce.io/core/6.1.0.RC1/api/

Commands

• Add support for IDLE option in XPENDING #1537
• Support for ACL commands #1538 (Thanks to @GraemeMitchell84)
• Add support for MINID trimming strategy and the LIMIT argument to XADD and XTRIM #1582
• Add support for GEOADD [CH] [NX|XX] options #1584
• Add support for HRANDFIELD and ZRANDMEMBER commands #1605
• Add support for GETEX, GETDEL commands #1606
• Add FlushMode to FLUSHALL and FLUSHDB, and to SCRIPT FLUSH #1608
• Add support for MIGRATE AUTH2 option #1633
• Add support for RESTORE ABSTTL #1634

Enhancements

• Add support for Java Flight Recorder #1430
• Add hostname support to Sentinel #1635
• Introduce GeoValue value type #1643

Fixes

• XREADGROUP skips messages if body is nil #1622 (Thanks to @asalabaev)
• TransactionCommand applied incorrectly #1625 (Thanks to @checky)
• ScoredValueUnitTests test fail #1647 (Thanks to @dengliming)
• Create traced endpoint when ready #1653 (Thanks to @anuraaga)

Other

• Ping command is not supported in Pub/Sub connection #1601 (Thanks to @TsybulskyStepan)
• Fix formatting indent in kotlin files #1603 (Thanks to @sokomishalov)
• Upgrade kotlin to 1.4.30, kotlinx-coroutines to 1.4.2 #1620 (Thanks to @sokomishalov)
• Typo in string reactive commands #1632 (Thanks to @paualarco)
• Let nullable ScoredValue factory methods return Value instead of ScoredValue #1644
• Cleanup MULTI state if MULTI command fails #1650
• Upgrade to Kotlin 1.4.31 #1657
• Use kotlin and kotlinx-coroutines bills of materials #1660 (Thanks to @sokomishalov)
• Fix travis links due to its domain name migration #1661 (Thanks to @sokomishalov)
• Rename zrandmemberWithscores to zrandmemberWithScores #1663 (Thanks to @dengliming)