<dependency>
 <groupId>com.googlecode.xmemcached</groupId>
 <artifactId>xmemcached</artifactId>
 <version>{version}</version>
</dependency>

 Type command "mvn -Dtest -DfailIfNoTests=false assembly:assembly" to build the project.Maven will download the dependencies automacly and build project.

 The test.properties file under the src/test/resources folder is used for setting memcached test server.
 Please set test.memcached.servers property,Then run the AllTests class with jvm option "-ea".

 Yes,since 1.2.0-RC1,Xmemcached is compatible with jdk5.

 //New a XMemcachedClient instance
 XMemcachedClientBuilder builder = new XMemcachedClientBuilder(AddrUtil.getAddresses("localhost:11211"));
 XMemcachedClient client=builder.build();
 //If you want to use binary protocol
 XMemcachedClientBuilder builder = new XMemcachedClientBuilder(AddrUtil.getAddresses("localhost:11211"));
 builder.setCommandFactory(new BinaryCommandFactory());
 XMemcachedClient client=builder.build();
 //If you want to use xmemcached talking with kestrel
 XMemcachedClientBuilder builder = new XMemcachedClientBuilder(AddrUtil.getAddresses("localhost:11211"));
 builder.setCommandFactory(new KestrelCommandFactory());
 XMemcachedClient client=builder.build();
 //If you want to store primitive type as String
 client.setPrimitiveAsString(true);
 //Add or remove memcached server dynamically
 client.addServer("localhost:12001 localhost:12002");
 client.removeServer("localhost:12001 localhost:12002");
 //get operation
 String name =client.get("test");
 //set add replace append prepend gets
 client.add("hello", 0, "dennis");
 client.replace("hello", 0, "dennis");
 client.append("hello", 0, " good");
 client.prepend("hello", 0, "hello ");
 GetsResponse response=client.gets("hello");
 long cas=response.getCas();
 Obejct value=response.getValue();
 //incr decr
 client.set("a",0,"1");
 client.incr("a",4);
 client.decr("a",4);
 //cas
 client.cas("a", 0, new CASOperation() {
 @Override
 public int getMaxTries() {
 return 1; //max try times
 }
 @Override
 public Object getNewValue(long currentCAS, Object currentValue) {
 System.out.println("current value " + currentValue);
 return 3; //return new value to update
 }
 });
 //flush_all
 client.flushAll();
 //stats
 Map<InetSocketAddress,Map<String,String>> result=client.getStats();
 // get server versions
 Map<InetSocketAddress,String> version=memcached.getVersions();
 //bulk get
 List<String> keys = new ArrayList<String>();
 keys.add("hello");
 keys.add("test");
 Map<String, Object> map = client.get(keys);

 java -Dxmemcached.jmx.enable=true [YourApp]

 service:jmx:rmi:///jndi/rmi://[host]:7077/xmemcachedServer

 <bean name="memcachedClient"
 class="net.rubyeye.xmemcached.utils.XMemcachedClientFactoryBean">
 <property name="servers">
 <value>localhost:12000 localhost:12001</value>
 </property>
 </bean>

 //set weight to 2
 client.addServer("localhost",12000,2);
 //or through XMemcachedClientBuilder,pass a weight array to XMemcachedClientBuilder constructor
 MemcachedClientBuilder builder = new XMemcachedClientBuilder(AddrUtil.getAddresses("localhost:12000 localhost:12001"),new int[]{1,3});
 builder.setSessionLocator(new KetamaMemcachedSessionLocator());
 MemcachedClient memcachedClient=builder.build();

Contributors