RESP 是 Redis 序列化协议Redis Serialization Protocol 的简写。它是一种直观的文本协议，优势在于实现异常简单，解析性能极好。

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

  1. 单行字符串 以 + 符号开头；
  2. 多行字符串 以 $ 符号开头，后跟字符串长度；
  3. 整数值 以 : 符号开头，后跟整数的字符串形式；
  4. 错误消息 以 - 符号开头；
  5. 数组 以 * 号开头，后跟数组的长度；

1. 各类型格式

1.1 单行字符串

+hello world\r\n

1.2 多行字符串

第一行是长度，剩下的是内容，表示字符串 hello world 如下：

$11\r\nhello world\r\n

打印如下：

$11
hello world

1.3 整数

冒号开头 表示整数 1024 如下：

:1024\r\n

打印如下：

:1024

1.4 错误

减号开头后跟错误名称和详细错误解释 表示「参数类型错误」如下：

-WRONGTYPE Operation against a key holding the wrong kind of value\r\n

1.5 数组

第一行是长度，后面依次是每个内容，表示数组 [1,2,3] 如下：

*3\r\n:1\r\n:2\r\n:3\r\n

打印如下：

*3
:1
:2
:3

数组里面可以嵌套其它类型，甚至可以嵌套另外一个数组，如此就可以形成复杂的数据结构。

1.6 NULL

用多行字符串表示，不过长度要写成 -1。

$-1\r\n

1.7 空串

用多行字符串表示，长度填 0。

$0\r\n\r\n

注意这里有两个 \r\n，为什么是两个，因为两个 \r\n之间隔的是空串。

2. 客户端向服务器发送指令

客户端向服务器发送的指令只有一种格式，多行字符串数组。比如一个简单的 set 指令 set author codehole会被序列化成下面的字符串。

*3\r\n$3\r\nset\r\n$6\r\nauthor\r\n$8\r\ncodehole\r\n

直观打印结果：

*3
$3
set
$6
author
$8
codehole

3. 服务器向客户端返回响应

服务器向客户端回复的响应要支持多种数据结构，所以消息响应在结构上要复杂不少。不过再复杂的响应消息也是以上 5 中基本类型的组合。

3.1 单行字符串响应

127.0.0.1:6379> set author codehole
OK

这里的 OK 就是单行响应，没有使用引号括起来。

+OK

3.2 错误响应

127.0.0.1:6379> incr author
(error) ERR value is not an integer or out of range

试图对一个字符串进行自增，服务器抛出一个通用的错误。

-ERR value is not an integer or out of range

3.3 整数响应

127.0.0.1:6379> incr books
(integer) 1

这里的1就是整数响应。

:1

3.4 多行字符串响应

127.0.0.1:6379> get author
"codehole"

这里使用双引号括起来的字符串就是多行字符串响应。

$8
codehole

3.5 数组响应

127.0.0.1:6379> hset info name laoqian
(integer) 1
127.0.0.1:6379> hset info age 30
(integer) 1
127.0.0.1:6379> hset info gender male
(integer) 1
127.0.0.1:6379> hgetall info
1) "name"
2) "laoqian"
3) "age"
4) "30"
5) "gender"
6) "male"

这里的 hgetall 命令返回的就是一个数值，客户端负责将数组组装成字典再返回。

*6
$4
name
$6
laoqian
$3
age
$2
30
$6
gender
$4
male

3.6 嵌套

127.0.0.1:6379> scan 0
1) "0"
2) 1) "info"
   2) "books"
   3) "author"

scan 命令用来扫描服务器包含的所有 key 列表，它是以游标的形式获取，一次只获取一部分。
scan 命令返回的是一个嵌套数组。数组的第一个值表示游标的值，如果这个值为零，说明已经遍历完毕。如果不为零，使用这个值作为 scan 命令的参数进行下一次遍历。数组的第二个值又是一个数组，这个数组就是 key 列表。

*2
$1
0
*3
$4
info
$5
books
$6
author

虽然 Redis 协议里有大量冗余的回车换行符，但是这并不影响它成为互联网技术领域非常受欢迎的一个文本协议。有很多开源项目使用 RESP 作为它的通讯协议。因为在技术领域，性能并不总是代表一切，有时还要考虑简单性、易理解性和易实现性，这些都需要进行适当权衡。

4. 使用 telnet 连接 Redis

我们来看的 redis-cli 命令结果

127.0.0.1:6379> keys *
1) "a"
2) "b"
3) "num"
127.0.0.1:6379> 
127.0.0.1:6379> get a
"world"
127.0.0.1:6379> 

127.0.0.1:6379> set multi_line "how \r\n are \r\n you"
OK
127.0.0.1:6379> get multi_line
"how \r\n are \r\n you"
127.0.0.1:6379> 

127.0.0.1:6379> set null ""
OK
127.0.0.1:6379> get null
""
127.0.0.1:6379>

使用 Telnet登录查看对应命令结果

wohu@ubuntu:~$ telnet 127.0.0.1 6379
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
keys *
*3
$1
a
$1
b
$3
num


get a
$5
world

get multi_line
$17
how 
 are 
 you

get null
$0