Skip to content

A simple, asynchronous, single-threaded memcached client written in java.

License

Notifications You must be signed in to change notification settings

HubSpot/java-memcached-client

 
 

Repository files navigation

Building

Spymemcached can be compiled using Apache Ant by running the following command:

ant

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

To run the Spymemcached tests against Membase Server run the following command:

ant test -Dserver.type=membase

To test Spymemcached against Membase running on a different host use the following command:

ant test -Dserver.type=membase \
    -Dserver.address_v4=ip_address_of_membase

Testing

The latest version of spymemcached has a set of command line arguments that can be used to configure the location of your testing server. The arguments are listed below.

-Dserver.address_v4=ipv4_address_of_testing_server

This argument is used to specify the ipv4 address of your testing server. By default it is set to localhost.

-Dserver.address_v6=ipv6_address_of_testing_server

This argument is used to set the ipv6 address of your testing server. By default it is set to ::1. If an ipv6 address is specified then an ipv4 address must be specified otherwise there may be test failures.

-Dserver.port_number=port_number_of_memcached

This argument is used when memcahched is started on a port other than 11211

-Dtest.type=ci

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

HubSpot Modifications

Circuit Breaker

There is now a configuration option to add a Failsafe circuit breaker in front of each node. If enabled, the circuit breaker is updated at the end of each operation (failure if it timed out, success otherwise). If 5 out of the last 10 operations have timed out for a specific node, the circuit breaker will open and requests to that node will immediately fail. After one second, a single request is allowed to that node. If it fails, the circuit stays open and the process is repeated one second later. If it succeeds, the circuit is closed and behavior returns to normal.

More Information

For more information about Spymemcached see the links below:

Project Page The

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

Github

The gitub page contains the latest Spymemcached source.

Couchbase.org

At couchbase.org you can find a download's section for the latest release as well as an extensive tutorial to help new users learn how to use Spymemcached.

About

A simple, asynchronous, single-threaded memcached client written in java.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 98.8%
  • Other 1.2%