自己实现memcached客户端库

kient88

What's memcached ? 　　memcached是一个以key-value的形式缓存数据的缓存系统。通过将数据缓存到内存中，从而提高数据的获取速度。
　　memcached以key-value的形式来保存数据，你可以为你每一段数据关联一个key，然后以后可以通过这个key获取
　　这段数据。
　　　　memcached是一个库还是什么？memcached其实是一个单独的网络服务器程序。它的网络底层基于libevent，你可以
　　将其运行在网络中的一台服务器上，通过网络，在遵循memcached的协议的基础上与memcached服务器进行通信。
　　What do we want to wrap ?
　　我们需要做什么？我们只需要遵循memcached的协议(参见该文档)，封装网络层的通信，让上层可以通过调用诸如
　　add/get之类的接口即可实现往memcached服务器缓存数据，以及取数据。上层程序员根本不知道这些数据在网络
　　上存在过。
　　这个东西，也就是memcached官方所谓的client apis。你可以使用现成的客户端库，但是你也可以将这种重造轮子
　　　　的工作当作一次网络编程的练习。it's up to you.:D
　　Where to start ?
　　很遗憾，对于windows用户而言，memcached官方没有给出一个可以执行或者可以直接F7即可得到可执行文件的下载
　　(如果你是vc用户)。幸运的是，已经有人做了这个转换工作。
　　你可以从http://jehiah.cz/projects/memcached-win32/这里下载到memcached的windows版本，包括可执行程序和
　　源代码。
　　我们直接可以运行memcached.exe来安装/开启memcached服务器，具体步骤在以上页面有所提及：
安装：memcached.exe-dinstall，这会在windows服务里添加一个memcached服务
行：memcached.exe-dstart，你也可以通过windows的服务管理运行。

　　然后，你可以在任务管理器里看到一个'memcached'的进程，很占内存，因为这是memcached。
　　So, here we go ...
　　通过以上步骤运行的memcached，默认在11211端口监听(是个TCP连接，可以通过netstat查看)。接下来，我们就可
　　以connect到该端口上，然后send/recv数据了。发送/接收数据只要遵循memcached的协议格式，一切都很简单。
　　使用最简单的阻塞socket连接memcached服务器：
　　
　　　 SOCKET s = socket( AF_INET, SOCK_STREAM, 0 );
　　　　struct sockaddr_in addr;
　　　　memset( &addr, 0, sizeof( addr ) );
　　　　addr.sin_family = AF_INET;
　　　　addr.sin_port = htons( 11211 );
　　　　addr.sin_addr.s_addr = inet_addr( "127.0.0.1" );
　　　　　　ret = connect( s, (struct sockaddr*) &addr, sizeof( addr ) );
　　　　if( ret == 0 )
　　　　{
　　　　　　printf( "connect okn" );
　　　　}
　　About the protocol
　　简单地提一下memcached的协议。
　　可以说，memcached的协议是基于行的协议，因为无论是客户端请求还是服务器端应答，都是以"rn"作为结束符。
memcached的协议将数据(send/recv操作的数据)分为两种类型：命令和用户数据。
　　命令用于服务器和客户端进行交互；而用户数据，很显然，就是用户想要缓存的数据。
　　　　关于用户数据，你只需要将其编码成字节流(说白了，只要send函数允许即可)，并附带数据结束标志"rn"发送即可。
　　关于命令，memcached分为如下几种命令：存储数据、删除数据、取出数据、其他一些获取信息的命令。其实你换个角度
　　想想，memcached主要就是将数据存储到内存里，所以命令也多不了哪去，基本就停留在add/get/del上。
　　关于key，memcached用key来标识数据，每一个key都是一个不超过255个字符的字符串。
　　到这里，你可以发现memcached对于数据的存储方式(暴露给上层)多少有点像std::map，如果你愿意，你可以将客户端
　　API封装成map形式。= =#
　　具体实现
　　接下来可以看看具体的实现了。
　　首先看看存储数据命令，存储数据命令有：add/set/replace/append/prepend/cas。存储命令的格式为：
　　<command name> <key> <flags> <exptime> <bytes> [noreply]rn
　　具体字段的含义参看protocol.txt文件，这里我对set举例，如下代码，阻塞发送即可：
　　　　　　charcmd[256];
　　　　chardata[]="testdata";
　　　　sprintf(cmd,"setTestKey00%drn",strlen(data));
　　　　ret=send(s,cmd,strlen(cmd),0);

　　　　注意：noreply选项对于有些memcached版本并不被支持，例如我们使用的1.2.2版本。注意官方的changelog即可。
　　当你发送了存储命令后，memcached会等待客户端发送数据块。所以我们继续发送数据块：
　　　　　　ret=send(s,data,strlen(data),0);
　　　　ret=send(s,"rn",2,0);//数据结束符
　　然后，正常的话，memcached服务器会返回应答信息给客户端。
　　　　　　charreply[256];
　　　　ret=recv(s,reply,sizeof(reply)-1,0);
　　　　reply[ret]=0;
　　　　printf("serverreply:%sn",reply);
　　如果存储成功，服务器会返回STORED字符串。memcached所有应答信息都是以字符串的形式给出的。所以可以直接printf出来。
　　关于其他的操作，我就不在这里列举例子了。我提供了我封装的memcached客户端库的完整代码下载，使用的是阻塞socket，
　　对应着memcached的协议看，很容易看懂的。
　　It's a story about a programmer...
　　
　　最近发觉自己有点极端，要么写纯C的代码，要么写满是template的泛型代码。