和memcached服务器的交互

和memcached服务器的交互

comments 类型

1. storage commands: set add replace

2. retrieval commands: get

3. other commands: incr delete

error strings

1. "ERROR/r/n"

客户端发送了一个不存在的command

2. "CLIENT_ERROR <error>/r/n"

客户端的错误：客户端发送的数据或者格式方面有问题。 <error>表示具体错误的原因。

3. "SERVER_ERROR <error>/r/n"

服务器端的错误：服务器一系列的错误阻止了命令的执行。<error>表示具体错误的原因。当

发生此错误时。服务器发送完了"SERVER_ERROR <error>/r/n"之后将会关闭connection。(这

是唯一的关闭connection的情况)

descriptions of individual commands

1. storage commands

首先客户端向服务器按照如下格式发送命令行:

<command name> <key> <flags> <exptime> <bytes>/r/n

a) <command name> 可以是"set", "add", "replace"。

"set"表示按照相应的<key>存储该数据。

"add"表示按照相应的<key>添加该数据,但是如果该<key>已经存在则会操作失败。

"replace"表示按照相应的<key>替换数据,但是如果该<key>不存在则操作失败

b) <key> 客户端需要保存数据的key。

c) <flags> 是一个16位的无符号的整数(以十进制的方式表示)。该标志将和需要存储的数据

一起存储,并在客户端get数据时返回。客户可以将此标志用做特殊用途，此标志对服务器来

说是不透明的。

d) <exptime> 过期的时间。如果该数值为0表示存储的数据永远不过时(但是,该数据有可能

被其他项所替换掉。因为服务器采用了LRU(最近最久没有使用)的算法替换)。如果非0(unix

时间或者距离此时的秒数),当过期后,服务器可以保证用户得不到该数据(以服务器时间为标

准)。

e) <bytes> 需要存储的字节数(不包含最后的"/r/n"),当用户希望存储空数据时,<bytes>可

以为0

f) 最后客户端需要加上"/r/n"作为"命令头"的结束标志。

<data block>/r/n

紧接着"命令头"结束之后就要发送数据块(即希望存储的数据内容),最后加上"/r/n"作为此次

通讯的结束。

reply

当以上数据发送结束之后,服务器将返回一个应答。可能有如下的情况:

a) "STORED/r/n"

表示存储成功

b) "NOT_STORED/r/n"

表示存储失败,但是该失败不是由于错误。通常这是由于"add"或者"replace"命令本身的要求

所引起的,或者该项在删除队列之中(见delete命令)。

2 retrieval command

获取数据的格式:

get <key>*/r/n

a) <key>* 表示一个或者多个key(以空格分开)

b) "/r/n" 命令头的结束

reply

服务器端将返回0个或者多个的数据项。每个数据项都是由一个文本行和一个数据块组成。当

所有的数据项都接收完毕将收到"END/r/n"

每一项的数据结构：

VALUE <key> <flags> <bytes>/r/n

<data block>/r/n

a) <key> 希望得到存储数据的key

b) <falg> 发送set命令时设置的标志项

c) <bytes> 发送数据块的长度(不包含"/r/n")

d) "/r/n" 文本行的结束标志

e) <data block> 希望接收的数据项。

f) "/r/n" 接收一个数据项的结束标志。

如果有些key出现在get命令行中但是没有返回相应的数据，这意味着服务器中不存在这些项

，这些项过时了，或者被删除了。

3. delete

delete 命令格式:

delete <key> <time>/r/n

a) <key> 需要被删除数据的key

b) <time> 客户端希望服务器将该数据删除的时间(unix时间或者从现在开始的秒数)

c) "/r/n" 命令头的结束

reply

a) "DELETED/r/n" 删除成功

b) "NOT_FOUND/r/n" 需要删除的key不存在

ps："flush_all" command 可以所有项都无效。

4. increment/decrement

command "incr" "decr" 是用来改变数据项数值的命令。设置数据项的数据被认为是一个10

进制的无符号的整数。如果当前设置的值不能够被转换则认为是0.如果该数据项的key不存在

,则执行命令失败!

命令格式:

incr <key> <value>/r/n

or

decr <key> <value>/r/n

a) <key> 数据项的key

b) <value> 用户希望增加/减少的数据的数值.该数值是一个32位十进制的无符号整形变量。

c) "/r/n" 命令行结束标志

reply

a) "NOT_FOUND/r/n" 没有找到需要操作的项。

b) "<value>/r/n" <value>数据项有效期的最新剩余时间。

注意: 

a) 如果一个数据项的有效期被设置为0,这时使用decr命令是无法减少数据。

b) 如果要执行 incr key -1 的操作不会有什么问题,结果和你希望的一样。但是,执行decr 

-1时的结果一定会让你觉得很意外,因为它的结果无论key的数据是什么结果的都是0.原因是:

在这两个命令的执行过程中都是吧-1当做一个无符号的整形处理的。

c) 执行decr命令时数据的长度不会随之而减小,而是在返回数据的后面填补空格。但是执行

incr命令越界后会自动的增加数据的位数。

5. 其他命令

"stats": 用来查询服务器提供的内部数据。

stats <args>/r/n

查询特定的数据

reply

STAT <name> <value>/r/n

...

END/r/n

"quit"

"quit/r/n": 退出程序