Amazon ElastiCache Cluster Client for Java - enhanced library to connect to ElastiCache clusters.
Java Other
Pull request Compare This branch is 9 commits ahead of dustin:master.
Latest commit 3cbeffb May 4, 2016 @QuChen88 QuChen88 Merge pull request #4 from masneyb/master
 Support for non-daemon threads in the ConfigurationPoller


Amazon ElastiCache Cluster Client

Amazon ElastiCache Cluster Client is an enhanced Java library to connect to ElastiCache clusters. This client library has been built upon Spymemcached and is released under the Amazon Software License.


Amazon ElastiCache Cluster Client can be compiled using Apache Ant by running the following command:


This will generate binary, source, and javadoc jars in the build directory of the project.


The latest version of Amazon ElastiCache Cluster Client supports unit tests and integration tests.

Unit tests do not require any running memcached servers, and can be run using Apache Ant by the following command:

ant test

Integration tests are always run against local memcached servers. Start integration tests by the following command:

ant it

It has a set of command line arguments that can be used to configure your client mode and your local testing server. The arguments are listed below.


This argument is used to specify the mode of the client that you want to run. Supported options are Static and Dynamic. Dynamic mode enables Auto Discovery feature. Static mode runs without Auto Discovery and has the same functionality as a classic spymemcached client. By default it is set to Dynamic.


This argument is used to specify the location of your testing server binary. By default it is set to /usr/bin/memcached.


This argument is used to specify the version of your testing server. Currently supported memcached versions by Elasticache are 1.4.5, 1.4.14, 1.4.24. By default it is set to 1.4.24.


This argument is used for CI testing where certain tests might be temporarily failing.

More Information for Amazon ElastiCache Cluster Client

Github link: This repository is a fork of the spymemcached Java client for connecting to memcached (specifically the repo).

Additional changes have been made to support Amazon ElastiCache Auto Discovery. To read more about Auto Discovery, please go here:

For more information about Spymemcached see the link below:

Spymemcached Project Home contains a wiki, issue tracker, and downloads section.