Memcached使用说明(转自网络)

Memcached的安装

Memcached可以在Windows下进行开发调试。下面为Memcached在Win 32下的安装过程。

l      在网上下载memcached-1.2.1-win32.zip。解压放某个盘下面，比如在c:\memcached

l      在终端（cmd）下输入‘c:\memcached\memcached.exe -d install’安装。

l      再输入：‘c:\memcached\memcached.exe -d start’启动。

这样，Memcached就部署到机器上了。

Memcached的配置

在安装好Memcached后，可以对其进行必要的配置，如：监听的端口，监           听的IP地址（通常为本机IP，当本机有多个网卡时，才对不同的IP进行监听设置），内存空间大小等等。

 

l-p

监听的端口

l-l

连接的IP地址, 默认是本机

l-d start

启动memcached服务

l-d restart

重起memcached服务

l-d stop|shutdown

关闭正在运行的memcached服务

l-d install

安装memcached服务

l-d uninstall

卸载memcached服务

l-u

以的身份运行 (仅在以root运行的时候有效)

l-m

最大内存使用，单位MB。默认64MB

l-M

内存耗尽时返回错误，而不是删除项

l-c

最大同时连接数，默认是1024

l-f

块大小增长因子，默认是1.25

l-n

最小分配空间，key+value+flags默认是48

l-h

显示帮助

Memcached的基本设置命令

 

Memcached的使用

[ 错误指令] 
Memcache的协议的错误部分主要是三个错误提示之提示指令：
普通错误信息，比如指令错误之类的
ERROR
客户端错误
CLIENT_ERROR <错误信息>
服务器端错误
SERVER_ERROR <错误信息>

[ 数据保存指令] 
数据保存是基本的功能，就是客户端通过命令把数据返回过来，服务器端接收后进行处理。
指令格式：
<命令> <键> <标记> <有效期> <数据长度>
<命令> - command name 
主要是三个储存数据的三个命令， set, add, replace
set 命令是保存一个叫做key的数据到服务器上
add 命令是添加一个数据到服务器，但是服务器必须这个key是不存在的，能够保证数据不会被覆盖
replace 命令是替换一个已经存在的数据，如果数据不存在，就是类似set功能
<键> - key
就是保存在服务器上唯一的一个表示符，必须是跟其他的key不冲突，否则会覆盖掉原来的数据，这个key是为了能够准确的存取一个数据项目
<标记> - flag
标记是一个16位的无符号整形数据，用来设置服务器端跟客户端一些交互的操作
<有效期> - expiration time
是数据在服务器上的有效期限，如果是0，则数据永远有效，单位是秒，Memcache服务器端会把一个数据的有效期设置为当前Unix时间+设置的有效时间
<数据长度> - bytes
数据的长度，block data 块数据的长度，一般在这个个长度结束以后下一行跟着block data数据内容，发送完数据以后，客户端一般等待服务器端的返回，服务器端的返回：
STORED           数据保存成功
NOT_STORED   数据保存失败，是因为服务器端这个数据key已经存在

[ 数据提取命令] 
从服务器端提取数据主要是使用get指令，格式是：
get <键>*
<键>* - key
key是是一个不为空的字符串组合，发送这个指令以后，等待服务器的返回。如果服务器端没有任何数据，则是返回：
END
证明没有不存在这个key，没有任何数据，如果存在数据，则返回指定格式：
VALUE <键> <标记> <数据长度>
<数据块> 
返回的数据是以VALUE开始的，后面跟着key和flags，以及数据长度，第二行跟着数据块。
<键> -key，是发送过来指令的key内容
<标记> - flags，是调用set指令保存数据时候的flags标记
<数据长度> - bytes，是保存数据时候定位的长度
<数据块> - data block，数据长度下一行就是提取的数据块内容

[ 数据删除指令] 
数据删除指令也是比较简单的，使用get指令，格式是：
delete <键> <超时时间>
<键> - key，希望在服务器上删除数据的key键
<超时时间> - timeout
按照秒为单位，这个是个可选项，如果没有指定这个值，那么服务器上key数据将马上被删除，如果设置了这个值，那么数据将在超时时间后把数据清除，该项缺省值是0，就是马上被删除
删除数据后，服务器端会返回：
DELETED   删除数据成功
NOT_FOUND   这个key没有在服务器上找到.
如果要删除所有服务器上的数据，可以使用flash_all指令，格式：
flush_all
这个指令执行后，服务器上所有缓存的数据都被删除，并且返回：
OK
这个指令一般不要轻易使，除非你却是想把所有数据都干掉，删除完以后可以无法恢复的。

[其他指令] 
如果想了解当前Memcache服务器的状态和版本等信息，可以使用状态查询指令和版本查询指令。
如果想了解当前所有Memcache服务器运行的状态信息，可以使用stats指令，格式
stats
服务器将返回每行按照 STAT 开始的状态信息，包括20行，20项左右的信息，包括守护进程的pid、版本、保存的项目数量、内存占用、最大内存限制等等信息。

如果只是想获取部分项目的信息，可以指定参数，格式：
stats <参数>
这个指令将只返回指定参数的项目状态信息。
如果只是想单独了解当前版本信息，可以使用version指令，格式：
version
将返回以 VERSION 开头的版本信息
如果想结束当前连接，使用quit指令，格式：
quit
将断开当前连接

 

Mecached在Java上的应用

JAR包

Memcached是跨平台的，而且对多种编程语言都提供了有效的支持。在对Java的支持上提供了一个JAR包：java_memcached-release_1.3.2.jar（最新版本为2.0.1）。

连接池

Memcached是借助于socket通讯，因此在客户端对Memcached进行操作时，首先要配置Socket连接池。如：设置连接的服务器信息、初始连接数、最小和最大连接数以及最大处理时间、主线程的睡眠时间、TCP的参数，连接超时等。

连接池的配置使用的是JAR包中提供的com.danga.MemCached.SockIOPool

Memcached的操作

在Java可以使用JAR包中提供的com.danga.MemCached.MemCachedClient (下面简称为：mcc)类实现对Memcached的操作。

在使用mcc前，对其做必要的设置。如：允许传输数据压缩，压缩数据的临界值等。

MemCachedClinet提供了对Memcached的数据储存方法有：

l        Set(String key,Object value[,Date time]）

l        Add(String key,Object value[,Date time]）

l        Replace(String key,Object value[,Date time]）

Key—唯一的识别编码（必须）

Value—储存的对象（必须）

Time—储存时间（可选，当Time为0时，则该数据在Memcached中永远不过期，直至手动删除或服务器重启）

在调用在三个方法后，会返回boolean值，表明是否储存成功。

数据的删除方法：

l        delete(String key)

利用传入的Key值，到Memcached中把该key值对应的键值对删除。该方法会返回boolean值，表明是否删除成功。

数据获取方法：

l        get(String key)

l        getMulti (String[] keys)

利用传入Key值获取相对应的Value。一次获取多个Value可以使用getMulti (String[] keys)。每一个返回值均为Object，需要类型转化。如果传入的Key获取不了数据，则会返回null。

查询key值是否存在：

l        KeyExists(String key)

查询被传入的Key是否能继续使用。放回boolean值。