MemcachedClient 使用说明

上一篇介绍了Memcached基本使用方法《Memcached使用手册》，下面介绍java如何操作memcached。使用的是java_memcached-release_2.6.6。

一、使用方法

新建项目，添加相关jar包：

直接上代码了，注释写的很详细，不用多说了啊。

package www.xufei.com;

import com.danga.MemCached.MemCachedClient;
import com.danga.MemCached.SockIOPool;

public class MemcachedDemo {

	public static void main(String[] args) {
		//memcached服务器
		String[] servers = {"127.0.0.1:11211","192.168.1.3:11211"};
		/**
		 * 设置连接池可用cache服务器的权重，和server数组的位置一一对应
		 */
		Integer[] weights = {1,2};
		/**
		 * 这个类用来创建管理客户端和服务器通讯连接池，客户端主要的工作包括数据通讯、服务器定位、hash码生成等都是由这个类完成的。
		 * 获得连接池的单态方法。这个方法有一个重载方法getInstance( String poolName )，每个poolName只构造一个SockIOPool实例。
		 * 缺省构造的poolName是default。
		 */
		SockIOPool pool = SockIOPool.getInstance();
		//设置memcached服务器
		pool.setServers(servers);
		//设置memcached服务器权重
		pool.setWeights(weights);
		//设置容错开关设置为TRUE，当当前socket不可用时，程序会自动查找可用连接并返回，否则返回NULL，默认状态是true，建议保持默认
		pool.setFailover( true );
		//设置开始时每个cache服务器的可用连接数
		pool.setInitConn( 10 );
		//设置每个服务器最少可用连接数
		pool.setMinConn( 5 );
		//设置每个服务器最大可用连接数
		pool.setMaxConn( 250 );
		/**
		 * 设置连接池维护线程的睡眠时间
		 * 设置为0，维护线程不启动
		 * 维护线程主要通过log输出socket的运行状况，监测连接数目及空闲等待时间等参数以控制连接创建和关闭。
		 */
		pool.setMaintSleep( 30 );
		/**
		 * 设置是否使用Nagle算法，因为我们的通讯数据量通常都比较大（相对TCP控制数据）而且要求响应及时，因此该值需要设置为false（默认是true）
		 */
		pool.setNagle( false );
		/**
		 * 设置socket的读取等待超时值
		 */
		pool.setSocketTO( 3000 );
		/**
		 * 设置连接心跳监测开关。
		 * 设为true则每次通信都要进行连接是否有效的监测，造成通信次数倍增，加大网络负载，因此该参数应该在对HA要求比较高的场合设为TRUE，默认状态是false。
		 */
		pool.setAliveCheck( true );
		/**
		 * 设置完pool参数后最后调用该方法，启动pool。
		 */
		pool.initialize();

		/**
		 * 创建一个memcached客户端，所有对memcached中数据操作的方法都在这个类里面
		 */
		MemCachedClient memCachedClient = new MemCachedClient();
		/**
		 * 存储一个username，值为刘德华，存储成功返回true
		 */
		boolean success = memCachedClient.set("username", "刘德华");
		System.out.println(success);

		/**
		 * 从缓存中获取一个key为username的数据
		 */
		Object o = memCachedClient.get("username");
		System.out.println(o);

		/**
		 * 定义一个p对象，Persion类必须实现Serializable接口
		 */
		Persion p = new Persion();
		p.setId("1");
		p.setName("周杰伦");

		/**
		 * 缓存一个p对象
		 */
		memCachedClient.set("p1", p);

		/**
		 * 获取缓存的p对象
		 */
		Persion p1 = (Persion) memCachedClient.get("p1");
		System.out.println(p1.getName());

		/**
		 * 调用add方法添加一个key为p1的对象，值123是不能添加进缓存的，因为p1已经添加过一次了
		 */
		memCachedClient.add("p1", 123);//错误！无法更新p1的值

		System.out.println(memCachedClient.get("p1"));//还是person对象

		/**
		 * 使用set方法可以更新p1
		 */
		memCachedClient.set("p1", 123);
		System.out.println(memCachedClient.get("p1"));//输出123

		/**
		 * 使用replace方法可以更新p1
		 */
		memCachedClient.replace("p1", 456);
		System.out.println(memCachedClient.get("p1"));//输出456

		/**
		 * 使用replace方法可以更新p2,缓存中不含有key为p2的数据，无法更新，不会添加
		 */
		memCachedClient.replace("p2", 456);
		System.out.println(memCachedClient.get("p2"));//输出null

		/**
		 * 删除key为p1的缓存数据
		 */
		memCachedClient.delete("p1");
		System.out.println(memCachedClient.get("p1"));//输出null
	}
}

　　

二、常用方法说明

1、SockIOPool 是socket 连接池类

setServers(String[] servers) ：设置服务器信息数组；

setWeights(String[] weights) ：设置服务器权重数组；

setInitConn(int count) ：设置初始连接数；

setMinConn(int minConn) ：设置最小连接数；

setMaxConn(int maxConn) ：设置最大连接数；

setMaxIdle(long arg0) ：设置最大处理时间；

setMaintSleep(long arg0) ：主线程的睡眠时间；

initialize() ：初始化连接池。

2、MemCachedClient 类及其常用方法

add(String key, Object value) ：添加一个键值对到缓存中；

add(String key, Object value,Date expires) ：添加一个键值对到缓存中，并设置其超时时间；

set(String key, Object value) ：在缓存中设置一个键的值；

set(String key, Object value, Date expires) ：在缓存中设置一个键的值，并设置其超时时间；

get(String key) ：获得某个键的值。

incr(String key) ：为某个键上的值执行+1 操作；

decr(String key) ：为某个键上的值执行-1 操作；

replace(String key, String value) ：将某个键的值替换成新的值；

replace(String key, String value, Date expires) ：将某个键的值替换成新的值，并设置其超时时间。

delete(String key)：删除缓存中一个key的值