memcached服务器的搭建及简单入门

由于项目中可能会有到缓存框架技术，今天就特意学习了下memcached框架。

1：memcached服务器的下载，以memcached-win32-1.4.4-54-g136cb6e.zip版本的服务器为例，具体下载地址可以在网上查找，具体不多说了。

2：下载完后，解压后在dos环境下，进入到解压到的文件目录中去，运行 memcached.exe -d install 命令 或者直接双击memcached.exe。运行完后，启动memcached服务器 命令 memcached.exe -d start，可以通过telnet 127.0.0.1 11211登录到memcached服务器上，如果登录成功证明安装memcached服务器成功。

3：memcached的客户端主要有三种

(1)memcache 官网提供的 java_memcached-release_2.6.3 客户端

(2)Spymemcached 客户端

(3)xmemcached 客户端

我以xmemcached 客户端为例，memcached的客户端有许多，可以在网上搜索下。

4：添加如下jar包 如下图

由于xmemcached依赖slf4j，需要添加slf4j包。

5：编写简单的测试代码

如下:

package org.gjt.test;
import java.io.IOException;
import java.util.concurrent.TimeoutException;
import net.rubyeye.xmemcached.MemcachedClient;
import net.rubyeye.xmemcached.MemcachedClientBuilder;
import net.rubyeye.xmemcached.XMemcachedClientBuilder;
import net.rubyeye.xmemcached.exception.MemcachedException;
import net.rubyeye.xmemcached.utils.AddrUtil;
/*
 * 本例只是简单入门代码，主要向memcached服务器添加、获取、删除一个key-value数据，
 */
public class MemcachedTest {
    public static void main(String[] args) throws TimeoutException, InterruptedException, MemcachedException {
        MemcachedClientBuilder mClientBuilder =new XMemcachedClientBuilder(
                AddrUtil.getAddresses("127.0.0.1:11211"));
        try {
            MemcachedClient memcachedClient =mClientBuilder.build();
               memcachedClient.set("hello", 0, "Hello,xmemcached");  
               String value= memcachedClient.get("hello");  
               System.out.println("hello=" + value);  
               memcachedClient.delete("hello");  
               value= memcachedClient.get("hello");  
               System.out.println("hello=" + value);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}

其实可以在dos下查看memcached服务器的参数信息 比如 127.0.0.1 11211 登录到memcached服务器，可以通过使用五种基本 memcached 命令执行最简单的操作。这些命令和操作包括：
    set
    add
    replace
    get
    delete
前三个命令是用于操作存储在 memcached 中的键值对的标准修改命令。它们都非常简单易用，且都使用如下 所示的语法
command <key> <flags> <expiration time> <bytes>
<value>
表 1 定义了 memcached 修改命令的参数和用法。
　　表 1. memcached 修改命令参数
　　参数     用法
　　key     key 用于查找缓存值
　　flags     可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息
　　expiration time     在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
　　bytes     在缓存中存储的字节点
　　value     存储的值（始终位于第二行）
现在，我们来看看这些命令的实际使用。
 （1）set
set 命令用于向缓存添加新的键值对。如果键已经存在，则之前的值将被替换。
注意以下交互，它使用了 set 命令：
set userId 0 0 5
12345
STORED
如果使用 set 命令正确设定了键值对，服务器将使用单词 STORED 进行响应。本示例向缓存中添加了一个键值对，其键为userId，其值为12345。并将过期时间设置为 0，这将向 memcached 通知您希望将此值存储在缓存中直到删除它为止。
（2） add
仅当缓存中不存在键时，add 命令才会向缓存中添加一个键值对。如果缓存中已经存在键，则之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
下面是使用 add 命令的标准交互：
set userId 0 0 5
12345
STORED
add userId 0 0 5
55555
NOT_STORED
add companyId 0 0 3
564
STORED
（3）replace
仅当键已经存在时，replace 命令才会替换缓存中的键。如果缓存中不存在键，那么您将从 memcached 服务器接受到一条 NOT_STORED 响应。
下面是使用 replace 命令的标准交互：
replace accountId 0 0 5
67890
NOT_STORED
set accountId 0 0 5
67890
STORED
replace accountId 0 0 5
55555
STORED
最后两个基本命令是 get 和 delete。这些命令相当容易理解，并且使用了类似的语法，如下所示：
command <key>
接下来看这些命令的应用。
（4） get
get 命令用于检索与之前添加的键值对相关的值。您将使用 get 执行大多数检索操作。

下面是使用 get 命令的典型交互：

set userId 0 0 5
12345
STORED

get userId
VALUE userId 0 5
12345
END

get bob
END


如您所见，get 命令相当简单。您使用一个键来调用 get，如果这个键存在于缓存中，则返回相应的值。如果不存在，则不返回任何内容。

（5）delete
最后一个基本命令是 delete。delete 命令用于删除 memcached 中的任何现有值。您将使用一个键调用delete，如果该键存在于缓存中，则删除该值。如果不存在，则返回一条NOT_FOUND 消息。

下面是使用 delete 命令的客户机服务器交互：

set userId 0 0 5
98765
STORED

delete bob
NOT_FOUND

delete userId
DELETED

get userId
END


可以在 memcached 中使用的两个高级命令是 gets 和 cas。gets 和cas 命令需要结合使用。您将使用这两个命令来确保不会将现有的名称/值对设置为新值（如果该值已经更新过）。我们来分别看看这些命令。

（6） gets
gets 命令的功能类似于基本的 get 命令。两个命令之间的差异在于，gets 返回的信息稍微多一些：64 位的整型值非常像名称/值对的 “版本” 标识符。

下面是使用 gets 命令的客户机服务器交互：

set userId 0 0 5
12345
STORED

get userId
VALUE userId 0 5
12345
END

gets userId
VALUE userId 0 5 4
12345
END


考虑 get 和 gets 命令之间的差异。gets 命令将返回一个额外的值 — 在本例中是整型值 4，用于标识名称/值对。如果对此名称/值对执行另一个set 命令，则gets 返回的额外值将会发生更改，以表明名称/值对已经被更新。清单 6 显示了一个例子：

清单 6. set 更新版本指示符

                
set userId 0 0 5
33333
STORED

gets userId
VALUE userId 0 5 5
33333
END


您看到 gets 返回的值了吗？它已经更新为 5。您每次修改名称/值对时，该值都会发生更改。

（7） cas
cas（check 和 set）是一个非常便捷的 memcached 命令，用于设置名称/值对的值（如果该名称/值对在您上次执行 gets 后没有更新过）。它使用与 set 命令相类似的语法，但包括一个额外的值：gets 返回的额外值。

注意以下使用 cas 命令的交互：

set userId 0 0 5
55555
STORED

gets userId
VALUE userId 0 5 6
55555
END

cas userId 0 0 5 6
33333
STORED


如您所见，我使用额外的整型值 6 来调用 gets 命令，并且操作运行非常顺序。现在，我们来看看清单 7 中的一系列命令：

清单 7. 使用旧版本指示符的 cas 命令

                
set userId 0 0 5
55555
STORED

gets userId
VALUE userId 0 5 8
55555
END

cas userId 0 0 5 6
33333
EXISTS


注意，我并未使用 gets 最近返回的整型值，并且 cas 命令返回 EXISTS 值以示失败。从本质上说，同时使用gets 和cas 命令可以防止您使用自上次读取后经过更新的名称/值对。

缓存管理命令

最后两个 memcached 命令用于监控和清理 memcached 实例。它们是 stats 和 flush_all 命令。

（8） stats
stats 命令的功能正如其名：转储所连接的 memcached 实例的当前统计数据。在下例中，执行 stats 命令显示了关于当前 memcached 实例的信息：
STAT pid 22459                             进程ID

STAT uptime 1027046                        服务器运行秒数

STAT time 1273043062                       服务器当前unix时间戳

STAT version 1.4.4                         服务器版本

STAT pointer_size 64                       操作系统字大小(这台服务器是64位的)

STAT rusage_user 0.040000                  进程累计用户时间

STAT rusage_system 0.260000                进程累计系统时间

STAT curr_connections 10                   当前打开连接数

STAT total_connections 82                  曾打开的连接总数

STAT connection_structures 13              服务器分配的连接结构数

STAT cmd_get 54                            执行get命令总数

STAT cmd_set 34                            执行set命令总数

STAT cmd_flush 3                           指向flush_all命令总数

STAT get_hits 9                            get命中次数

STAT get_misses 45                         get未命中次数

STAT delete_misses 5                       delete未命中次数

STAT delete_hits 1                         delete命中次数

STAT incr_misses 0                         incr未命中次数

STAT incr_hits 0                           incr命中次数

STAT decr_misses 0                         decr未命中次数

STAT decr_hits 0                           decr命中次数

STAT cas_misses 0    cas未命中次数

STAT cas_hits 0                            cas命中次数

STAT cas_badval 0                          使用擦拭次数

STAT auth_cmds 0

STAT auth_errors 0

STAT bytes_read 15785                      读取字节总数

STAT bytes_written 15222                   写入字节总数

STAT limit_maxbytes 1048576                分配的内存数（字节）

STAT accepting_conns 1                     目前接受的链接数

STAT listen_disabled_num 0                

STAT threads 4                             线程数

STAT conn_yields 0

STAT bytes 0                               存储item字节数

STAT curr_items 0                          item个数

STAT total_items 34                        item总数

STAT evictions 0                           为获取空间删除item的总数

此处的大多数输出都非常容易理解。稍后在讨论缓存性能时，我还将详细解释这些值的含义。至于目前，我们先来看看输出，然后再使用新的键来运行一些 set 命令，并再次运行stats 命令，注意发生了哪些变化。

（9） flush_all
flush_all 是最后一个要介绍的命令。这个最简单的命令仅用于清理缓存中的所有名称/值对。如果您需要将缓存重置到干净的状态，则 flush_all 能提供很大的用处。下面是一个使用 flush_all 的例子：

set userId 0 0 5
55555
STORED

get userId
VALUE userId 0 5
55555
END

flush_all
OK

get userId
END
以上就是简单的使用memcached 入门，memcached的命令介绍是来源于网络。希望对于新手来说有帮助，也欢迎大家的拍砖。