memcache通信协议(转载)

英文水平很烂,做梦都想着能把英语学习,可以使用一口流利的英文和洋鬼子交流,顺便忽悠下自己的同胞。没有地方学习英语,看还可以,网上有很多关于计算机 的英文文献,写还行,说就完全不可能了。在以后的工作中慢慢的锻炼自己的英语水平吧,先翻译一下一些计算机的英文文献,锻炼下^_^,能读则读不能读则一 笑置之。


协议
关键字 Keys
命令Commands
超时时间 Expiration times
错误信息 Error strings
存储命令 Storage commands
读取命令 Retrieval command
删除 Deletion
增加/减少 Increment/Decrement
统计 Statistics
多用途统计 General-purpose statistics
其他命令 Other commands
UDP协议 UDP protocol


协议
       memcached的客户端通过TCP连接与服务器通信(UDP协议的接口也可以使用,详细说明请参考”UDP 协议”部分)。一个给定的运行中的memcached服务器在某个(可配置的)端口上监听连接;客户端连接该端口,发送命令给服务器,读取反馈,最后关闭 连接。


       没有必要发送一个专门的命令去结束会话。客户端可以在不需要该连接的时候就关闭它。注意:我们鼓励客户端缓存它们与服务器的连接,而不是每次要存储或读 取数据的时候再次重新建立与服务器的连接。memcache同时打开很多连接不会对性能造成到大的影响,这是因为memcache在设计之处,就被设计成 即使打开了很多连接(数百或者需要时上千个连接)也可以高效的运行。缓存连接可以节省与服务器建立TCP连接的时间开销(于此相比,在服务器段为建立一个 新的连接所做准备的开销可以忽略不计)。


       memcache通信协议有两种类型的数据:文本行和非结构化数据。文本行用来发送从客户端到服务器的命令以及从服务器回送的反馈信息。非结构化的数据 用在客户端希望存储或者读取数据时。服务器会以字符流的形式严格准确的返回相应数据在存储时存储的数据。服务器不关注字节序,它也不知道字节序的存在。 memcahce对非结构化数据中的字符没有任何限制,可以是任意的字符,读取数据时,客户端可以在前次返回的文本行中确切的知道接下来的数据块的长度。


       文本行通常以“"r"n”结束。非结构化数据通常也是以“"r"n”结束,尽管"r、"n或者其他任何8位字符可以出现在数据块中。所以当客户端从服务 器读取数据时,必须使用前面提供的数据块的长度,来确定数据流的结束,二不是依据跟随在字符流尾部的“"r"n”来确定数据流的结束,尽管实际上数据流格 式如此。


关键字 Keys
memcached使用关键字来区分存储不同的数据。关键字是一个字符串,可以唯一标识一条数据。当前关键字的长度限制是250个字符(当然目前客户端似乎没有需求用这么长的关键字);关键字一定不能包含控制字符和空格。


命令Commands
memcahe有3种类型的命令:


l         存储命令—(3个命令:set、add和replace)要求服务器安装关键字存储数据。客户端发送一个命令行,然后一个数据块;命令执行后客户端等待一行反馈,用来表示命令执行成功与否。


l         读取命令-- (只有1个命令:get)要求服务器根据一组关键字读取数据(在一个请求总可以包含一个或多个关键字)。客户端发送一个包含请求关键字的命令行;命令传递 到服务器后,服务器就查找每一个关键字下的数据,然户将数据以“一个关键字数据,一个反馈信息行跟着一个数据块”的格式回送数据,直到服务器发送 “END”的反馈行。


l         其他命令,如flush_all,version等。这些命令不使用非结构化的数据。对于这些命令,客户端发送一个文本的命令行,根据命令的特性等待一行数据或者在最后一行以“END“结尾的几行反馈信息。


所有的命令行总是以命令的名字开始,紧接着是以空格分割的参数。命令名称都是小写,并且是大小写敏感的。


超时时间 Expiration times
       一些发送到服务器的命令包含超时时间(该超时时间对应于:数据项保存时间;客户端操作限时)。在这些例子中,被发送的真实时间要么是UNIX时间戳(自 1970年1月1日零时起的秒数数值),或者从当前时间开始算起的秒数。对于后一种情况,秒数的数值不能超过60*60*24*30(30天的秒数);如 果秒数的数值大于了这个数值,服务器会认为该数值是UNIX时间戳,而不是自当前时间开始的秒数偏移值。


错误信息 Error strings
       每个命令都有可能被反馈以一个错误消息。这些错误消息有以下三个类型:


l         “ERROR"r"n” 


意味着客户端发送了一个在协议中不存在的命令。


l         "CLIENT_ERROR "r"n"


表示客户端输入的命令行上存在某种错误,输入不符合协议规定。是一个人工可读(human-readable)的错误注释。


l         "SERVER_ERROR "r"n"


表示服务器在执行命令时发生了某些错误,致使服务器无法执行下去。也是一个人工可读(human-readable)的错误注 释。在一些情况下,错误导致服务器不能再为客户端服务(这样的情况很少发生),服务器就会在发生错误消息后主动关闭连接。这也是服务器主动关闭到客户端连 接的唯一情况。


       后续秒数各种命令的时候,我们不再赘述错误消息的情况,当我们要清楚错误是存在的,不可忽略。


存储命令 Storage commands
       首先,客户端发生如下这样的命令:


"r"n


"r"n


其中:


是 set、add或者replace。set表示存储该数据;add表示如果服务器没有保存该关键字的情况下,存储该数据;replace表示在服务器已经拥有该关键字的情况下,替换原有内容。


是客户端要求服务器存储数据的关键字。


是一个16位的无符号整数,服务器将它和数据一起存储并且当该数据被检索时一起返回。客户端可能使用该数值作为一个位图来存储特殊数据信息;这个字段对服务器不是透明的。


是超时时间。如果值为0表示该数据项永远不超时(但有时候该数据项可能被删除以为其他数据腾出空间);如果值不为0,可能是绝对的UNIX时间,也可能是自现在开始的偏移值,它保证客户段在这个超时时间到达后,客户端将取不到该数据项。


是随后数据的字节数,不包括终结符”"r"n”。有可能是0,它后面将是一个空的数据块。


是真正要存储数据流。


       发送命令行和数据后,客户端等待反馈,可以是如下几种情况:


l         "STORED"r"n"              表示存储数据成功。


l         "NOT_STORED"r"n"    表示发送的数据没有存储,但这不因为错误,而是发生在add或者replace命令不能满足条件时,或者数据项正处于要删除的队列中。


l         错误消息


读取命令 Retrieval command:
       读取命令如下所示:


get *"r"n


*表示一个或多个使用空格分割的关键字字符串。


       发送命令后,客户端等待返回一个或多个数据项,每个数据项的格式是一个文本行,后跟着一个数据块。当所有的数据项发送完毕后,服务器发送字符串”END"r"n”表示服务器反馈数据的结束。


       返回数据项的格式如下:


VALUE "r"n


"r"n


是发生数据项的关键字。


       是存储该数据项时,客户端命令中的标志字段。


       是紧跟文本行后数据块的长度,不包括终结符”"r"n”。


是数据项的数据部分。


       如果请求命令行中的有些关键字对应的数据项没有被返回,这意味着服务器没有该关键字标示下的数据项(有可能是从来没有被存储过,或者存储过但被删除掉以腾出内存空间,或者数据项超时了,再或者它被某个客户端删除了)。


删除 Deletion
删除命令允许直接删除数据项,命令格式如下:


delete

 

原文地址:http://blog.csdn.net/educast/article/details/19751909

你可能感兴趣的:(memcache通信协议(转载))