Memcached Java Client API详解
针对Memcached官方网站提供的java_memcached-release_2.0.1版本进行阅读分析,Memcached Java客户端lib库主要提供的调用类是SockIOPool和MemCachedClient?,关键类及方法整理说明如下。
SockIOPool
这个类用来创建管理客户端和服务器通讯连接池,客户端主要的工作包括数据通讯、服务器定位、hash码生成等都是由这个类完成的。
- public static SockIOPool getInstance()
- 获得连接池的单态方法。这个方法有一个重载方法getInstance( String poolName ),每个poolName只构造一个SockIOPool实例。缺省构造的poolName是default。
- 如果在客户端配置多个memcached服务,一定要显式声明poolName。
- public void setServers( String[] servers )
- 设置连接池可用的cache服务器列表,server的构成形式是IP:PORT(如:127.0.0.1:11211)
- public void setWeights( Integer[] weights )
- 设置连接池可用cache服务器的权重,和server数组的位置一一对应
- 其实现方法是通过根据每个权重在连接池的bucket中放置同样数目的server(如下代码所示),因此所有权重的最大公约数应该是1,不然会引起bucket资源的浪费。
for ( int i = 0; i < servers.length; i+/+ ) { if ( this.weights /!= null && this.weights.length > i ) { for ( int k = 0; k < this.weights[i].intValue(); k+/+ ) { this.buckets.add( servers[i] ); if ( log.isDebugEnabled() ) log.debug( "++++ added " + servers[i] + " to server bucket" ); } }
- public void setInitConn( int initConn )
- 设置开始时每个cache服务器的可用连接数
- public void setMinConn( int minConn )
- 设置每个服务器最少可用连接数
- public void setMaxConn( int maxConn )
- 设置每个服务器最大可用连接数
- public void setMaxIdle( long maxIdle )
- 设置可用连接池的最长等待时间
- public void setMaintSleep( long maintSleep )
- 设置连接池维护线程的睡眠时间
- 设置为0,维护线程不启动
- 维护线程主要通过log输出socket的运行状况,监测连接数目及空闲等待时间等参数以控制连接创建和关闭。
- public void setNagle( boolean nagle )
- 设置是否使用Nagle算法,因为我们的通讯数据量通常都比较大(相对TCP控制数据)而且要求响应及时,因此该值需要设置为false(默认是true)
- ublic void setSocketTO( int socketTO )
- 设置socket的读取等待超时值
- public void setSocketConnectTO( int socketConnectTO )
- 设置socket的连接等待超时值
- public void setAliveCheck( boolean aliveCheck )
- 设置连接心跳监测开关。
- 设为true则每次通信都要进行连接是否有效的监测,造成通信次数倍增,加大网络负载,因此该参数应该在对HA要求比较高的场合设为TRUE,默认状态是false。
- public void setFailback( boolean failback )
- 设置连接失败恢复开关
- 设置为TRUE,当宕机的服务器启动或中断的网络连接后,这个socket连接还可继续使用,否则将不再使用,默认状态是true,建议保持默认。
- public void setFailover( boolean failover )
- 设置容错开关
- 设置为TRUE,当当前socket不可用时,程序会自动查找可用连接并返回,否则返回NULL,默认状态是true,建议保持默认。
- public void setHashingAlg( int alg )
- 设置hash算法
- alg=0 使用String.hashCode()获得hash code,该方法依赖JDK,可能和其他客户端不兼容,建议不使用
- alg=1 使用original 兼容hash算法,兼容其他客户端
- alg=2 使用CRC32兼容hash算法,兼容其他客户端,性能优于original算法
- alg=3 使用MD5 hash算法
- 采用前三种hash算法的时候,查找cache服务器使用余数方法。采用最后一种hash算法查找cache服务时使用consistent方法。
- 设置hash算法
- public void initialize()
- 设置完pool参数后最后调用该方法,启动pool。
MemCachedClient?
- public void setCompressEnable( boolean compressEnable )
- 设定是否压缩放入cache中的数据
- 默认值是ture
- 如果设定该值为true,需要设定CompressThreshold?
- public void setCompressThreshold( long compressThreshold )
- 设定需要压缩的cache数据的阈值
- 默认值是30k
- public void setPrimitiveAsString( boolean primitiveAsString )
- 设置cache数据的原始类型是String
- 默认值是false
- 只有在确定cache的数据类型是string的情况下才设为true,这样可以加快处理速度。
- public void setDefaultEncoding( String defaultEncoding )
- 当primitiveAsString为true时使用的编码转化格式
- 默认值是utf-8
- 如果确认主要写入数据是中文等非ASCII编码字符,建议采用GBK等更短的编码格式
- cache数据写入操作方法
- set方法
- 将数据保存到cache服务器,如果保存成功则返回true
- 如果cache服务器存在同样的key,则替换之
- set有5个重载方法,key和value是必须的参数,还有过期时间,hash码,value是否字符串三个可选参数
- add方法
- 将数据添加到cache服务器,如果保存成功则返回true
- 如果cache服务器存在同样key,则返回false
- add有4个重载方法,key和value是必须的参数,还有过期时间,hash码两个可选参数
- replace方法
- 将数据替换cache服务器中相同的key,如果保存成功则返回true
- 如果cache服务器不存在同样key,则返回false
- replace有4个重载方法,key和value是必须的参数,还有过期时间,hash码两个可选参数
- 建议分析key的规律,如果呈现某种规律有序,则自己构造hash码,提高存储效率
- set方法
- cache数据读取操作方法
- 使用get方法从cache服务器获取一个数据
- 如果写入时是压缩的或序列化的,则get的返回会自动解压缩及反序列化
- get方法有3个重载方法,key是必须的参数,hash码和value是否字符串是可选参数
- 使用getMulti方法从cache服务器获取一组数据
- get方法的数组实现,输入参数keys是一个key数组
- 返回是一个map
- 使用get方法从cache服务器获取一个数据
- 通过cache使用计数器
- 使用storeCounter方法初始化一个计数器
- 使用incr方法对计数器增量操作
- 使用decr对计数器减量操作
Memcached Client API 优化(草)
实现memcached的遍历操作
有些应用情况下,需要遍历memcached服务器中所有被cache的数据,目前memcached client API不支持遍历操作,需要进行扩展。
实现get时刷新数据过期时间(应用于session,可能需要修改服务器端程序)
当memcached被用作session服务器的时候,需要支持session的access方法,根据最近访问时间刷新过期时间,目前memcached也不支持该操作,需要进行扩展。
相关推荐
Memcached Java Client API详解.doc
标题中的"memcached java client jar包"指的是用于Java应用程序与Memcached服务器通信的Java库的JAR文件。 在Java应用中使用Memcached客户端,首先需要将`memcached.jar`添加到项目的类路径中。这个JAR文件包含了...
本篇文章将详细介绍两个常用的Java Memcached客户端:xmemcached和memcache-client-forjava。 **1. xmemcached** xmemcached是由Ketoo开发的一个高性能、高可用性的Java Memcached客户端。它提供了丰富的API,支持...
"memcached for java client 例子" 指的是一个使用Java语言编写的客户端库,用于与memcached缓存系统进行交互。Memcached是一种高性能、分布式内存对象缓存系统,常用于减轻数据库负载,提升Web应用的响应速度。 **...
- Memcached-Java-Client是Java开发者与Memcached进行交互的主要工具,它提供了简单易用的API接口,允许开发者方便地在Java应用中存取缓存数据。 - 版本2.6.1是该客户端的一个稳定版本,包含了一系列优化和改进,...
对于 Java 开发者,`MemCachedClient` 是一个常用的 Memcached 客户端库。这里我们关注的是 `java_memcached-release_2.6.6.jar` 文件,这是 Spymemcached 库的一个版本,它提供了与 Memcached 服务器通信的接口。 ...
在实际使用中,通常会开发 Java 客户端库来封装 Memcached 的操作,提供更方便的 API。封装过程可能包括: 1. **连接池管理**:为了提高性能,客户端可以使用连接池管理多个到 Memcached 服务器的连接,避免频繁...
这些库提供了方便的API,使Java开发者能够轻松地将Memcached集成到他们的应用程序中。 **Spymemcached示例** Spymemcached是Java社区广泛使用的Memcached客户端,它的使用非常简单。以下是一个简单的Java实例,...
1. **Memcached Java Client API** - `SockIOPool`: 这个类负责管理连接池,它提供了设置服务器地址、权重、连接数等方法。例如,`setServers(String[] servers)`用于设置服务器列表,而`setWeights(Integer[] ...
本文主要介绍了如何在Java项目中集成和使用Memcached这一开源工具,涉及到源码级别的操作,如创建`MemcachedClient`,设置、获取和删除缓存项。这些都是实际开发中非常实用的技术点,可以帮助开发者有效地优化应用...
gwhalin的Memcached Java客户端是一个高效且易于使用的Java API,它提供了丰富的功能,包括连接池管理、自动重连、命令执行等。这个客户端库不仅支持基本的get、set、delete操作,还支持事务处理、过期时间设置等...
这两个库提供了Java客户端,方便我们进行API调用。这里以spymemcached为例,你可以通过Maven或Gradle将依赖添加到项目中: ```xml <groupId>net.spy</groupId> <artifactId>spymemcached <version>2.12.3 ``` ...
标题 "spring调用memcached client for java" 涉及的是如何在Java应用程序中,特别是Spring框架下,集成和使用Memcached作为缓存系统。Memcached是一个高性能的分布式内存对象缓存系统,常用于减轻数据库负载,提升...
在Java应用中与Memcached进行交互,我们需要依赖特定的Java客户端库,这个压缩包可能包含了这些必要的库文件。 Java连接Memcached通常需要以下步骤: 1. **引入依赖**: 首先,你需要在项目中添加Java Memcached...
`memcache.zip` 中包含的是 `memcached-java-client-2.6.3.jar`,这是一个支持 Java 平台的 Memcached 客户端库。使用步骤如下: 1. 将 `memcached-java-client-2.6.3.jar` 添加到项目的类路径中。 2. 引入必要的库...
Java与Memcached结合使用可以构建高性能的分布式缓存系统,以提高Web应用程序的响应速度和数据处理能力。这里提供的文件包含在Windows环境下运行Memcached以及Java应用中集成Memcached所需的必要组件。 首先,我们...
Memcached Java客户端库允许Java开发者通过简单的API来存储和检索数据,这些数据被临时存储在内存中,以便快速访问。这个源码包可能是由Memcached的创始人或其团队维护的,确保了高质量和兼容性。 源码中的关键组成...
Java Memcached 客户端是Java开发者用于与Memcached分布式内存缓存系统交互的一个库。在版本2.6.3中,它提供了高效且可靠的连接管理,以及对Memcached服务器的全面支持。这个压缩包“java_memcached-release_2.6.3....
`memcached-1.2.1-win32.zip` 提供了Memcached服务端,而`java_memcached-release_1.6.zip` 提供了Java客户端,使得开发者能够轻松地在Java环境中集成和使用Memcached。学习和掌握这些资源,将有助于构建更加快速、...