Redis 通信协议 RESP

1、简介

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

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

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

2、RESP 描述

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

  • 单行字符串，第一个字节为 +
  • 错误消息，第一个字节为 -
  • 整型数字，第一个字节为 :，后跟整数的字符串
  • 多行字符串，第一个字节为 $，后跟字符串的长度
  • 数组，第一个字节为 *，后跟跟着数组的长度

单行字符串 chenssy

+chenssy

错误消息

-ERR unknown command ‘sets’….

整型字符串 29

:29

多行字符串 chenssy

$7 chenssy

数组[chenssy,29]

*2 $7 chenssy $2 29

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

请求命令

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

  1. *<number of arguments> CR LF
  2. $<number of bytes of argument 1> CR LF
  3. <argument data> CR LF
  4. ...
  5. $<number of bytes of argument N> CR LF
  6. <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 为例，如下：

  1. *3
  2. $3
  3. SET
  4. $8
  5. userName
  6. $7
  7. chenssy

解释：

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

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

  1. *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 协议是非常简单直观的一种协议，而且数据结构类型也只有五种。