你的位置:首页 > Java教程

[Java教程]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的值