2024.1.9 基于 Jedis 通过 Java 客户端连接 Redis 服务器

目录

引言

RESP 协议

Redis 通信过程

实现步骤

步骤一

步骤二

步骤三

步骤四

---

引言

• 在 Redis 命令行客户端中手敲命令并不是我们日常开发中的主要形式
• 而更多的时候是使用 Redis 的 API 来实现定制化的 Redis 客户端程序，进而操作 Redis 服务器
• 即使用程序来操作 Redis，使用代码来执行 Redis 命令

注意：

• Redis 所提供的命令行客户端 抑或是 第三方的图形化客户端
• 这二者本质上均属于 通用的客户端程序
• 相比之下，我们在工作中更希望使用到的是 专用的、定制化 的客户端程序

---

RESP 协议

• RESP（Redis Serialization Protocol） 协议，用于在 Redis 客户端和服务器之间进行通信

注意：

• 正因为 Redis 官方开放了 RESP 协议，所以我们才能够基于该协议，来编写出一个自定义的 Redis 客户端

RESP 协议优点：

• 简单且容易实现
• 可快速解析
• 肉眼可读

RESP 协议特点：

• RESP 协议的实现通常基于 TCP，但并不意味着RESP 协议与 TCP 强耦合在一起，即也可选择其他传输层协议
• 请求和响应之间的通信模型是一问一答的形式，即客户端给服务器发送一个请求，服务器返回一个响应

---

Redis 通信过程

• 客户端向服务器发送 Redis 命令（Bulk String 数组形式发送）
• 不同的命令，服务器返回不同的结果

1. 有的命令，可能返回个 OK
2. 有的命令，可能返回个 整数
3. 有的命令，可能返回个 数组

数据类型	首比特位	实例理解
Simple String	+	"+OK\r\n"
Errors	-	"-Error message\r\n"
Integers	:	":1000\r\n"
Bulk Strings	$	"$5\r\nhello\r\n"
Arrays	*	"*2\r\n$5\r\nhello\r\n$5\r\nworld\r\n"

• 即服务器在返回时，会将上述 实例字符串，写入到 tcp socket 中

注意：

• Simple Sting 只能用来传输文本
• Bulk Stirng 可以传输二进制数据

总结：

• 因此 redis 服务器要做的工作就是

1. 按照上述格式，构造出字符串，往 socket 中写入
2. 从 socekt 中读取字符串，按照上述格式解析

---

• 当然我们无需自己写代码，即按照按照上述的协议来 解析 和 构造字符串
• 因为我们可以使用现成的库，这些库已经帮我们实现了这套协议的解析 和 构造
• 因此我们便可以比较简单方便的来完成和 Redis 服务器通信的操作了！

实现步骤

• 此处我们使用 jedis 库，因为 jedis 库所提供的 api 和 Redis 命令高度一致

---

步骤一

• 在 maven 项目的 pom.xml 文件中添加依赖

<!-- https://mvnrepository.com/artifact/redis.clients/jedis -->
        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>4.4.2</version>
        </dependency>

---

步骤二

•  配置 ssh 端口转发，把云服务器的 Redis 端口，映射到本地主机

---

此处我们解释并理解步骤二，着急配置的可直接省略

---

• 使用 Java 开发进行的代码，通常高度依赖 windows（IDEA）
• 所以当我们想直接在自己主机上 操作 Redis 时，便需要通过 外网ip

• 但是直接使用 外网ip 也无法访问到云服务器中的 Redis 服务器
• 因为 Redis 服务器所占用的 6379 端口，默认被云服务器的防火墙给保护起来了
• 而防火墙一旦将 6379 端口保护起来，不仅黑客访问不了，就连自己也无法访问 Redis 服务器

问题：

• 直接在云服务器后台，把 6379 端口防火墙放开不就行了？

回答：

• 千万不要这么做！
• Redis 服务器的端口一旦放开到公网上，就特别容易被入侵！

两难境地：

1. 不能开放 Redis 服务器的端口
2. 我们自己又想能够通过外网对 Redis 服务器进行访问

解决方案一：

• 直接让 java 程序在 linux 上运行
• 这就需要我们将代码打成可执行的 jar 包，然后再将 jar 包拷贝到 linux 服务器上，最后再执行 jar 包
• 如果按照上述操作一步一步完成，还是十分繁琐的
• 虽然也可以通过一些第三方插件来简化上述步骤，但总体来说还是比较繁琐的！

解决方案二：

• 配置 ssh 端口转发，把云服务器的 Redis 端口，映射到本地主机
• ssh 的功能十分强大，其中很重要的特性就是能够支持端口转发
• 相当于通过 22 端口，来传递其他端口的数据
• 本身我们需要通过 windwos 主机来访问云服务器 6379 端口
• 但是我们可以直接构造一个特殊的 ssh 数据报将要访问的 redis 请求放到 ssh 数据报中

---

步骤三

• 当 ssh 连接上了之后，端口转发才会生效，即如歌将 ssh 连接断开，端口转发自然失效
• 所以我们完成上述步骤后，便可以使用 netstat 命令观察本地 8888 端口是否被监听成功
• 打开 cmd ，输入下方命令

netstat -ano | findstr 8888

• 出现红框所示，表示配置成功！

注意：

• 当配置了 端口转发之后，一定要断开之前的连接，重新连接才能生效！

---

步骤四

• 此处将创建一个 RedisDemo 类，来测试操作云服务器的 Redis 

import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;

public class RedisDemo {
    public static void main(String[] args) {
//        连接到 redis 服务器上
        JedisPool jedisPool = new JedisPool("tcp://127.0.0.1:8888");

//        从 redis 连接池中取一个出来
//        连接使用完之后要记得释放(close)
//        此处的释放不一定是真的关闭 tcp 连接，而是放回到池子里
        try (Jedis jedis = jedisPool.getResource()){
//            redis 的各种命令，就都对应到 jedis 对象的各种方法
            String pong = jedis.ping();
            System.out.println(pong);
        }
    }
}

运行结果:

---

注意点一：

• 当前咱们的这个程序能跑通，除了配置 ssh 端口映射之外，还有一个要点
• 即最开始安装 Redis 服务器时，配置好绑定的 ip ，以及关闭保护模式

---

想具体在 Centos7 上安装 Redis 5 可点击下方链接

关于云服务器 CentOS7 安装 Redis5

---

注意点二：

• 上述 url 的写法仅局限于开发阶段，后续如果我们的程序需要部署到云服务器
• 此时便需按照云服务的实际情况来更换此处的 ip 和 端口了