Redis通信协议-RESP

Redis 通信协议 RESP

1、简介

Redis 的通信协议是 Redis Serialization Protocol，翻译为 Redis 序列化协议，简称 RESP。它具有如下特征：

• 在 TCP 层
• 是二进制安全的
• 基于请求 - 响应模式
• 简单、易懂（人都可以看懂）

RESP 所描述的是 Redis 客户端 - 服务端的交互方式。

2、RESP 描述

Redis 协议将传输的结构数据分为 5 种类型，单元结束时统一加上回车换行符号 \r\n。

• 单行字符串，第一个字节为 <font style="color:#4A4A4A;">+</font>
• 错误消息，第一个字节为 <font style="color:#4A4A4A;">-</font>
• 整型数字，第一个字节为 <font style="color:#4A4A4A;">:</font>，后跟整数的字符串
• 多行字符串，第一个字节为 <font style="color:#4A4A4A;">$</font>，后跟字符串的长度
• 数组，第一个字节为 <font style="color:#4A4A4A;">*</font>，后跟跟着数组的长度

单行字符串 chenssy

+chenssy

错误消息

-ERR unknown command ‘sets’….

整型字符串 29

:29

多行字符串 chenssy

$7 chenssy

数组[chenssy,29]

*2 $7 chenssy $2 29

为了更加直观的阅读，将 **\r\n** 替换为换行

请求命令

Redis 对每一条请求命令都做了统一规范，格式如下：

*<number of arguments> CR LF
$<number of bytes of argument 1> CR LF
<argument data> CR LF
...
$<number of bytes of argument N> CR LF
<argument data> CR LF

翻译如下：

• number of arguments ：参数的数量
• CR LF：\r\n
• number of bytes of argument 1：参数 1 的字节数
• number of bytes of argument N：参数 N 的字节数

以命令 setuserName chenssy 为例，如下：

*3
$3
SET
$8
userName
$7
chenssy

解释：

*3 数组，表明有三个参数 SET、userName、chenssy
$3 多行字符串，第一个参数 SET ，有 3 个字符
$8 多行字符串，第二个参数 userName，有 8 个字符
$7 多行字符串，第三个参数 chenssy，有 7 个字符

上面只是格式化显示的结果，真正传输的结果如下：

*3\r\n$3\r\nSET\r\n$8\r\nuserName\r\n$7\r\nchenssy\r\n

回复命令

Redis 服务端响应要支持多种数据格式，所以回复命令一般都会显得复杂些，但是无论如何它都逃脱不了上面 5 中类型及其组合。

单行字符串

set name chenssy +OK

当行字符串响应一般都用于状态类的请求，比如 set、del、hset 等等诸如此类的

错误消息

sets birthday 02-30 -ERR unknown command ‘sets’….

因为没有 sets 这个命令，所以回复错误信息

整数型

incrby age 29 :58

多行字符串

get name $7 chenssy

返回的 value chenssy 有 7 个字符，所以类型为 $7

数组类型

mget name age *2 $7 chenssy $2 58

通过 mget 获取 name 和 age 的值，因为结果要返回两个结果集，所以 *2 表示返回的结果类型为数组且有两个元素， $7、 $2 就不过多解释了。

lrange listkey 0 -1 *4 $8 chenssy3 $8 chenssy2 $8 chenssy1 $7 chenssy

lrange 命令是获取列表（list）中的数据的，返回结果依然是以数组方式组合起来的，和 mget 命令返回的结果集一致。

RESP 协议是非常简单直观的一种协议，而且数据结构类型也只有五种。