net.spy.memcached
Class MemcachedConnection

java.lang.Object
  net.spy.memcached.compat.SpyObject
      net.spy.memcached.MemcachedConnection

public final class MemcachedConnection
extends SpyObject

Connection to a cluster of memcached servers.

Constructor Summary

MemcachedConnection(int bufSize, ConnectionFactory f, List<InetSocketAddress> a, Collection<ConnectionObserver> obs, FailureMode fm, OperationFactory opfactory)
Construct a memcached connection.

Method Summary

boolean	addObserver(ConnectionObserver obs) Add a connection observer.
void	addOperation(MemcachedNode node, Operation o)
void	addOperation(String key, Operation o) Add an operation to the given connection.
void	addOperations(Map<MemcachedNode,Operation> ops)
CountDownLatch	broadcastOperation(BroadcastOpFactory of) Broadcast an operation to all nodes.
void	handleIO() MemcachedClient calls this method to handle IO over the connections.
boolean	removeObserver(ConnectionObserver obs) Remove a connection observer.
void	shutdown() Shut down all of the connections.
String	toString()

Methods inherited from class net.spy.memcached.compat.SpyObject

getLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MemcachedConnection

public MemcachedConnection(int bufSize,
                           ConnectionFactory f,
                           List<InetSocketAddress> a,
                           Collection<ConnectionObserver> obs,
                           FailureMode fm,
                           OperationFactory opfactory)
                    throws IOException

Construct a memcached connection.

Parameters:

bufSize - the size of the buffer used for reading from the server

f - the factory that will provide an operation queue

a - the addresses of the servers to connect to

Throws:

IOException - if a connection attempt fails early

Method Detail

handleIO

public void handleIO()
              throws IOException

MemcachedClient calls this method to handle IO over the connections.

Throws:

IOException

addObserver

public boolean addObserver(ConnectionObserver obs)

Add a connection observer.

Returns:

whether the observer was successfully added

removeObserver

public boolean removeObserver(ConnectionObserver obs)

Remove a connection observer.

Returns:

true if the observer existed and now doesn't

addOperation

public void addOperation(String key,
                         Operation o)

Add an operation to the given connection.

Parameters:

key - the key the operation is operating upon

o - the operation

addOperation

public void addOperation(MemcachedNode node,
                         Operation o)

addOperations

public void addOperations(Map<MemcachedNode,Operation> ops)

broadcastOperation

public CountDownLatch broadcastOperation(BroadcastOpFactory of)

Broadcast an operation to all nodes.

shutdown

public void shutdown()
              throws IOException

Shut down all of the connections.

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object