一、 XMemcached 简单介绍
XMemcached 是一个新 java memcached client 。
或许你还不知道 memcached 是什么？能够先看看这里。简单来说， Memcached 是一个高性能的分布式内存对象的 key-value 缓存系统，用于动态 Web 应用以减轻数据库负载，如今也有非常多人将它作为内存式数据库在使用， memcached 通过它的自己定义协议与客户端交互，而XMemcached 就是它的一个 java client实现。
二、 使用指南
2.1 简单样例
对于用户来说，最基本的功能是存取数据，如果我们有一个 memcached 节点 IP 地址或者域名是 host 。port是 11211 ，一个简单的存取数据的样例例如以下：
MemcachedClientBuilder builder = new XMemcachedClientBuilder(
AddrUtil.getAddresses (“localhost:11211”));
MemcachedClient memcachedClient = builder.build();
try{
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(MemcachedException e) {
System. err.println( "MemcachedClient operation fail");
e.printStackTrace();
} catch(TimeoutException e) {
System. err.println( "MemcachedClient operation timeout");
e.printStackTrace();
} catch(InterruptedException e) {
// ignore
}
try{
memcachedClient.shutdown();
} catch(IOException e) {
System. err.println( "Shutdown MemcachedClient fail");
e.printStackTrace();
}
由于 XMemcachedClient 的创建有比較多的可选项，因此提供了一个 XMemcachedClientBuilder 用于构建 MemcachedClient 。 MemcachedClient 是主要接口。操作 memcached 的主要方法都在这个接口里， XMemcachedClient 是它的一个实现。
传入的 memcached 节点列表要求是类似 ”host1:port1 host2:port2 …” 这种字符串，通过 AddrUtil.getAddresses 方法获取实际的 IP 地址列表。存储数据是通过 set 方法。它有三个參数，第一个是存储的 key 名称。第二个是 expire 时间（单位秒） ，超过这个时间 ,memcached 将这个数据替换出去， 0 表示永久存储（默认是一个月） 。第三个參数就是实际存储的数据，能够是随意的 java 可序列化类型 。 获取存储的数据是通过 get 方法，传入 key 名称就可以。假设要删除存储的数据，这是通过 delete 方法，它也是接受 key 名称作为參数。 XMemcached 因为是基于 nio 。因此通讯过程本身是异步的。 client 发送一个请求给 memcached ，你是无法确定 memcached 什么时候返回这个应答，client此时仅仅有等待，因此还有个等待超时的概念在这里。client在发送请求后。開始等待应答，假设超过一定时间就觉得操作失败，这个等待时间默认是一秒，上面样例展现的 3 个方法调用的都是默认的超时时间，这三个方法相同有同意传入超时时间的重载方法。比如
Value=client.get(“hello”,3000);
就是等待 3 秒超时。假设 3 秒超时就跑出 TimeutException ，用户须要自己处理这个异常。由于等待是通过调用 CountDownLatch.await(timeout) 方法，因此用户还须要处理中断异常 InterruptException 。最后的 MemcachedException 表示 Xmemcached 内部发生的异常，如解码编码错误、网络断开等等异常情况。
2.2 CAS 操作
Memcached 是通过 cas 协议还实现原子更新。所谓原子更新就是 compare and set ，原理类似乐观锁。每次请求存储某个数据同一时候要附带一个 cas 值， memcached 比对这个 cas 值与当前存储数据的 cas 值是否相等。假设相等就让新的数据覆盖老的数据，假设不相等就觉得更新失败。这在并发环境下特别实用。
XMemcached 提供了对 CAS 协议的支持（不管是文本协议还是二进制协议）， CAS 协议事实上是分为两个步骤：获取 CAS 值和尝试更新，因此一个典型的使用场景例如以下：
GetsResponse<Integer> result = client.gets("a" );
long cas = result.getCas();
if (!client.cas("a" , 0, 2, cas)) {
System. err.println( "cas error");
}
首先通过 gets 方法获取一个 GetsResponse ，此对象包装了存储的数据和 cas 值，然后通过 cas 方法尝试原子更新。假设失败打印”cas error” 。显然，这种方式非常繁琐。而且假设你想尝试多少次原子更新就须要一个循环来包装这一段代码。因此XMemcached 提供了一个CASOpertion 接口包装了这部分操作。同意你尝试N 次去原子更新某个 key 存储的数据。无需显式地调用 gets 获取 cas值 , 上面的代码简化为：
client.cas( "a" , 0, newCASOperation<Integer>() {
public int getMaxTries() {
return1;
}
publicInteger getNewValue( longcurrentCAS, Integer currentValue) {
return 2;
}
});
CASOpertion 接口仅仅有两个方法。一个是设置最大尝试次数的 getMaxTries 方法，这里是尝试一次。假设尝试超过这个次数将抛出一个 TimeoutException 。假设你想无限尝试。能够将返回值设定为 Integer.MAX_VALUE 。还有一个方法是依据当前获得的 GetsResponse 来决定更新数据的 getNewValue 方法，假设更新成功。这种方法返回的值将存储成功，这种方法的两个參数是最新一次 gets 返回的 GetsResponse 结果。
2.3 更全面的样例
一些更全面的样例，展现了 MemcachedClient 接口的主要方法：
MemcachedClientBuilder builder = new XMemcachedClientBuilder(
AddrUtil.getAddresses (“localhost:12000”));
MemcachedClient client = builder.build();
client.flushAll();
if (!client.set("hello" , 0, "world")) {
System. err.println( "set error");
}
if(client.add( "hello" , 0, "dennis")) {
System. err.println( "Add error,key is existed");
}
if(!client.replace( "hello" , 0, "dennis")) {
System. err.println( "replace error");
}
client.append( "hello" , " good");
client.prepend( "hello" , "hello ");
String name = client.get("hello" , newStringTranscoder());
System. out.println(name);
client.deleteWithNoReply(“hello”);
首先存储了 hello 相应的 world 字符串。然后调用 add 和 replace 方法去尝试加入和替换，由于数据已经存在。因此 add 会失败，相同 replace 在数据存在的情况才会成功，也就是将 hello 相应的数据更新为 dennis ，然后通过append 和 prepend 方法在 dennis前后加上了字符串 hello 和 good ，因此通过 get 返回的结果是 hello dennis good 。而删除数据则是通过deleteWithNoReply 方法。这种方法删除数据而且告诉memcached 不用返回应答 ，因此这种方法不会等待应答直接返回，特别适合于批量处理。相同地， set 、 add 、 replace 等方法也有对应的withNoReply 重载版本号。详细请看 API 文档。
以下这个样例展现了 incr/decr 操作的使用，两个操作类似 java 中的原子类如 AtomicIntger ，用于原子递增或者递减变量数值：
assert (1==this .memcachedClient .incr("a" , 5, 1));
assert (6==this .memcachedClient .incr("a" , 5));
assert (10==this .memcachedClient .incr("a" , 4));
assert (9==this .memcachedClient .decr("a" , 1));
assert (7==this .memcachedClient .deccr("a" , 2));
incr 和 decr 都有三个參数的方法。第一个參数指定递增的 key 名称，第二个參数指定递增的幅度大小，第三个參数指定当 key 不存在的情况下的初始值。两个參数的重载方法省略了第三个參数。默认指定为 0 。
Memcached 提供了统计协议用于查看统计信息：
Map<InetSocketAddress,Map<String,String>> result=client.getStats();
getStats 方法返回一个map ，当中存储了全部已经连接而且有效的memcached 节点返回的统计信息，你也能够统计详细的项目，如统计items 项目：
Map<InetSocketAddress,Map<String,String>> result=client.getStatsByItem(“items”);
仅仅要向 getStatsByItem 传入须要统计的项目名称就可以。
MemcachedClientBuilder builder = new XmemcachedClientBuilder
(AddrUtil.getAddresses("10.180.44.224:11211 zhouxq:11211"),new int[]{1,3});
XMemcached 同意通过设置节点的权重来调节memcached 的负载，设置的权重越高，该memcached 节点存储的数据将越多。所承受的负载越大。
xmemcached 的权重是通过复制连接的多个引用来实现的，比方权重为 3 ，那么就复制 3 个同一个连接的引用放在集合中让 MemcachedSessionLocator 查找。
改变节点权重，能够通过 setServerWeight 方法：
public void setServerWeight(String server, int weight);
weight 与 servers 相应的节点的权重
weight 能够有也可无
weight 值大则权重大，否则小
传入一个 int 数组，里面的元素就是节点相应的权重值，比方这里设置 "10.180.44.224:1121" 节点的权重为 1 。而 "zhouxq:11211" 的权重为 3 。
类似的 XMemcachedClient() 和 XMemcachedClientBuilder 同样
设置连接池大小
builder.setConnectionPoolSize(5);