lettuce超时问题_Lettuce 架构解剖&源码精读

小鱼儿 2022-10-25 04:54 526阅读 0赞

# 背景 #

从 SpringBoot 2.X 版本开始，Lettuce 作为 Redis Java 客户端程序集成到 Spring Data，在 Jedis 横行的年代，Lettuce 能够进入 Spring Boot 的阵营，这引起了庖丁的好奇，在对 Lettuce 认真了解后，发现这个 Redis 的 Java 客户端确实非常优秀，非常值得解刨，于是有了本系列文章。

本文主要对 Lettuce 的主要功能和优秀支持进行介绍，读完本文你可以了解 Lettuce 的核心功能，唤醒你对 Lettuce 架构设计以及源码的极度好奇。

# Lettuce 简介 #

想要解刨一个框架，最好的办法是先去官网的首页看看，可以快速了解这个框架的核心目标，主要功能和设计思想或者哲学，lettuce 也不例外，下图是 Lettuce 官网的截图。

![922070ce7fefbe18592b938e813e93f7.png][]

来源于 Lettuce 官网：构建弹性数据访问

大家看看 Lettuce 这个组件的远景，构建弹性的数据访问，非常契合当前业界弹性计算的价值观。那么 Lettuce 到底是什么呢？我们需要给它一个准确的定义，正如上图官网所言，Lettuce是一个开源的、可扩展的Redis客户端，用于构建无阻塞的Reactive应用程序。它的官方网站地址：https://lettuce.io/ ，源码托管地址：https://github.com/lettuce-io/lettuce-core。

Lettuce是可伸缩的线程安全Java Redis客户端，为Redis Standalone，PubSub，Redis Sentinel和Redis Cluster提供同步，异步和反应性API。如果多个线程避免阻塞和事务性操作(例如BLPOP和MULTI / EXEC)，则可以共享一个连接。出色的netty NIO框架可有效管理多个开放连接。每个redis命令由一个或多个名称与小写redis命令名称相同的方法实现。具有多个可修改结果类型的修饰符的复杂命令包括CamelCased修饰符作为命令名称的一部分，例如zrangebyscore和zrangebyscoreWithScores。

Redis连接被设计为长期存在，如果连接丢失，将重新连接，直到调用close()为止。成功重新连接后，将(重新)发送尚未超时的未决命令。

所有连接都从其RedisClient继承默认超时，并且当非阻塞命令在超时到期之前未能返回结果时，将引发RedisException。超时默认为60秒，可以通过AbstractRedisClient.setDefaultTimeout(java.time.Duration)或针对每个单独的连接进行更改。

上面这些功能看起来非常强大，已经满足了Java 程序操作 Redis 的要求。这么优秀的程序是如何设计出来的？它的核心架构是什么样的呢？核心的功能是怎么实现的呢？庖丁会通过一系列文章来为你解惑。

# 为什么解剖Lettuce 架构？ #

从上面的文字描述中，我们了解到 Lettuce 是一个优秀的Java Redis 客户端，那么它有哪些亮点或者功能能够从众多的 Java Redis 客户端中脱颖而出呢？继续看看 Lettuce 官网的阐述，如下图。

![308ca15faf14b3ef40ddb7305f0ad13b.png][]

来源于 Lettuce 官网：Lettuce 的主要特性

> Lettuce is a **fully non-blocking** Redis client built with netty providing Reactive, Asynchronous and Synchronous Data Access .

注意提取关键词，完全非阻塞，基于 Netty，响应式的，同步和异步数据访问。

> Lettuce provides asynchronous API with RedisFuture (CompletionStage) and Reactive types \[Flux N\] and \[Mono 0|1\].

完全利用了 Java 8 的语言特性，Future，Flux ，Mono 这些词汇背后的语义到底是什么呢？

> **NON BLOCKING I/O**: Low-latency communication, **backpressure-enabled network engine** for NIO TCP, epoll TCP and Unix Domain Sockets. Reactive Streaming is fully supported.

非租塞式 I/O ,低延迟通讯，背压处理？

上面这些问题，你都能回答出来了吗？如果都可以，那么你可以忽略本文了，如果还有些模糊，那就和庖丁一起，一切解剖 Lettuce 的架构。

日常的工作中，我们对于框架的理解主要停留在使用阶段，知其然很少或者很难知其所以然，一方面是因为工作繁忙，另一个主要原因是相关的文档或者资料都比较浅显，很少深入去剖析架构原理，阐述设计思想和哲学，方便大家理解和学习，能够学以致用，举一反三，触类旁通，这也是庖丁解剖 Lettuce 架构的主要原因。

# 为什么要精读 Lettuce 源码？ #

架构是设计思想的一种自然语言的描述，可以通过文字，图表，配合 UML 等设计图去阐述系统结构和主要组成部分，但是如何通过编程语言来实现架构标识的功能，满足业务或者使用方的诉求呢？答案就藏在源码中，通过学习优秀的源码，深入理解语言特性，设计模式以及编程技巧，提升我们的审美能力，只有见过和欣赏过优秀的源码，才有可能写出优秀的代码，这个写作需要大量阅读培养语感，学习书画需要大量的临摹是异曲同工的。

Lettuce 几乎用尽了Java 语言的所有特性，同步，异步，响应式，线程安全，Reactor等都是 Java 语言非常主要的特性，也是日常编码解决问题的主要工具，更是各大厂面试必考的考点。所以庖丁会去精读 Lettuce 的源码，请大家关注后续系列文章，一窥 Lettuce 的庐山真面目。

# 后续系列文章链接 #

后续系列地址文章链接会同步更新到这里，方便检索，最后会汇总起来，形成完整的文章。

# 参考资料 #

*  Lettuce 官网： https://lettuce.io/
 *  Lettuce 源代码： https://github.com/lettuce-io/lettuce-core
 *  文档：https://lettuce.io/core/release/reference/index.html\#getting-started.start-coding
 *  API 文档： https://lettuce.io/core/release/api/

[922070ce7fefbe18592b938e813e93f7.png]: /images/20221024/d78760d48d114da8913eaad9e862e8db.png
[308ca15faf14b3ef40ddb7305f0ad13b.png]: /images/20221024/12c883bc3e084755a338baff209ebfc0.png