Redis 通讯协议规范

Redis 通讯协议规范

redis是一个key-value形式的基于内存的数据库

 

当安装完程序后我们知道可以用redis-cli连接redis-server进行通讯，进行各种操作。

那么如今我们用的高级语言 如：C、Java、Python、C#等 如何来发送命令(request)来操作数据、从数据库取到相关数据(replies)呢？

 

如果你也有这些疑问，那么这篇文章适合你继续看 ;)

 

ps：官网已经推荐了多种语言client的实现程序 http://redis.io/clients 有兴趣的可以分析源代码

 

如何发送命令？

Socket ！ 通过TCP协议形式的Socket我们可以连接到redis-server, 然后发送一些特定格式的命令及相关数据就可以了。其中命令都是以 \r\n (CR LF) 结尾的

特殊命令？

上面提到的特殊格式就是所谓的redis通讯协议，保证发送的命令、数据及返回数据格式的规范。这样我们才能够正确的发送命令到redis-server，然后根据协议的格式解析返回的数据(reply data)得到自己想要的形式。

协议规范内容介绍：

标准协议：

该协议已经在redis1.2版本中介绍过了，但是在2.0版本中才作为与redis-server进行通讯的标准方式

 

在这个新的协议中，所有的发送到redis-server的参数都是二进制安全的（保证二进制的安全），其基本形式如下：

*<参数的个数> CR LF

$<参数1字节数> CR LF

<参数1> CR LF

...

$<参数n字节数> CR LF

<参数n> CR LF

例如命令：set mykey myvalue 相对应的形式应该如下，

*3 CR LF  //三个参数

$3 CR LF  //第一个参数set有三个字节

SET CR LF //参数内容set

$5 CR LF  //第二个参数mykey有五个字节

mykey CR LF //参数二内容 mykey

$7 CR LF  //第三个参数有7个字节

myvalue CR LF //参数三内容 myvalue

字符串形式的结果就是 ： "*3\r\n$3\r\nSET\r\n$5\r\nmykey\r\n$7\r\nmyvalue\r\n"

实际上返回的数据也符合这个协议格式。如：$6\r\nmydata\r\n 是一个从redis-server返回的数据， 被称为块响应数据,通常是一个字符串（还有其他几个类型，稍后介绍）。另外redis也可以返回一个数据的列表， 可以返回多个 块数据（就被称作多块数据）。它返回的结果中总是以 "*参数个数\r\n"开头的 ，参数个数表示了共有几个块数据（可以理解为返回多个字符串）

 

响应的类型：

判断一个响应的类型都是由返回数据的第一个字节决定的，有如下几种类型：

 

"+" 代表一个状态信息 如 +ok 

"-" 代表发送了错误  （如：操作运算操作了错误的类型）

":" 返回的是一个整数  格式如：":11\r\n。

 一些命令返回一些没有任何意义的整数，如LastSave返回一个时间戳的整数值， INCR返回一个加1后的数值；一些命令如exists将返回0或者1代表是否true or false；其他一些命令如SADD, SREM 在确实执行了操作时返回1 ，否则返回0

 

"$" 返回一个块数据

 被用来返回一个二进制安全的字符串，如Get mykey 返回： "$6\r\nsongzh\r\n"；

 如果请求的值不存在那么将返回一个$-1。当实现客户端程序时， 你真正的应该提示用户值不存在，返回null

"*" 返回多个块数据（用来返回多个值， 总是第一个字节为"*"， 后面写着包含多少个相应值，如：

C:LRANGE mylist 0 3

S:*4

S:$3

S:foo

S:$3

S:bar

S:$5

$:world

如果指定的值不存在，那么返回*0