Package net.spy.memcached

Memcached client and transformation utils

See: Description

Interface Summary

Interface	Description
BroadcastOpFactory	Factory for creating Operations to be broadcast.
CASMutation<T>	Defines a mutation mechanism for a high-level CAS client interface.
ConnectionFactory	Factory for creating instances of MemcachedConnection.
ConnectionObserver	Users of this interface will be notified when changes to the state of connections take place.
HashAlgorithm	Intents to provide hash for locating a server for a key.
MemcachedClientIF	This interface is provided as a helper for testing clients of the MemcachedClient.
MemcachedNode	Interface defining a connection to a memcached server.
NodeLocator	Interface for locating a node by hash value.
OperationFactory	Factory that builds operations for protocol handlers.

Class Summary

Class	Description
AddrUtil	Convenience utilities for simplifying common address parsing.
ArrayModNodeLocator	NodeLocator implementation for dealing with simple array lookups using a modulus of the hash code and node list length.
BaseCacheMap<V>	Base class for a Map interface to memcached.
BinaryConnectionFactory	Default connection factory for binary wire protocol connections.
CachedData	Cached data with its attributes.
CacheMap	A Map interface to memcached.
CASMutator<T>	Object that provides mutation via CAS over a given memcache client.
CASValue<T>	A value with a CAS identifier.
ConnectionFactoryBuilder	Builder for more easily configuring a ConnectionFactory.
DefaultConnectionFactory	Default implementation of ConnectionFactory.
HashAlgorithmRegistry	Registry of known hashing algorithms for locating a server for a key.
KetamaConnectionFactory	ConnectionFactory instance that sets up a ketama compatible connection.
KetamaNodeLocator	This is an implementation of the Ketama consistent hash strategy from last.fm.
KeyUtil	Utilities for processing key values.
MemcachedClient	Client to a memcached server.
MemcachedConnection	Connection to a cluster of memcached servers.
TapClient	A tap client for memcached.
TapConnectionProvider	A TapConnectionProvider.

Enum Summary

Enum	Description
CASResponse	Response codes for a CAS operation.
ConnectionFactoryBuilder.Locator	Type of node locator to use.
ConnectionFactoryBuilder.Protocol	Type of protocol to use for connections.
DefaultHashAlgorithm	Known hashing algorithms for locating a server for a key.
FailureMode	Failure modes for node failures.
ObserveResponse	Response codes for a Observe operation.
PersistTo	PersistTo codes for a Observe operation.
ReplicateTo	ReplicateTo codes for a Observe operation.

Exception Summary

Exception	Description
OperationTimeoutException	Thrown by MemcachedClient when any internal operations timeout.

Package net.spy.memcached Description

Memcached client and transformation utils

Usage should be pretty straightforward. Get a MemcachedClient object and start setting and getting stuff in memcached.

All operations are asynchronous internally, but most at least provide synchronous convenience interfaces. Some only provide synchronous interfaces (getVersion, getStats) and some only provide asynchronous interfaces (delete, flush). That'll probably all get cleared up if it bothers anyone.

You may also find the online examples helpful.