Redis 通讯协议规范

peibaishi

　　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

$ CR LF

CR LF

...



$ CR LF

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