com.couchbase.client

Class CouchbaseConnection

java.lang.Object

java.lang.Thread

net.spy.memcached.compat.SpyThread

net.spy.memcached.MemcachedConnection

com.couchbase.client.CouchbaseConnection

All Implemented Interfaces:

Reconfigurable, java.lang.Runnable

Direct Known Subclasses:

CouchbaseConfigConnection

public class CouchbaseConnection
extends net.spy.memcached.MemcachedConnection
implements Reconfigurable

Maintains connections to each node in a cluster of Couchbase Nodes.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	ALLOWED_IDLE_TIME The amount in seconds after which a op broadcast is forced to detect dead connections.
protected CouchbaseConnectionFactory	cf
protected long	lastWrite
protected boolean	reconfiguring

Fields inherited from class net.spy.memcached.MemcachedConnection

addedQueue, failureMode, locator, metrics, metricType, nodesToShutdown, running, selector, shutDown

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
CouchbaseConnection(int bufSize, CouchbaseConnectionFactory f, java.util.List<java.net.InetSocketAddress> a, java.util.Collection<net.spy.memcached.ConnectionObserver> obs, net.spy.memcached.FailureMode fm, net.spy.memcached.OperationFactory opfactory)

Method Summary

Modifier and Type	Method and Description
void	addOperation(java.lang.String key, net.spy.memcached.ops.Operation o) Add an operation to the given connection.
void	addOperations(java.util.Map<net.spy.memcached.MemcachedNode,net.spy.memcached.ops.Operation> ops)
protected void	handleRetryInformation(byte[] retryMessage)
protected void	handleWokenUpSelector() Make sure that if the selector is woken up manually for an extended period of time that the sockets are still alive.
protected void	queueReconnect(net.spy.memcached.MemcachedNode node) Only queue for reconnect if the given node is still part of the cluster.
void	reconfigure(Bucket bucket) Call on a configuration update.
java.lang.String	replaceConfigWildcards(java.lang.String original) Helper method to parse config wildcards into their actual representations.
void	run() Infinitely loop processing IO.
protected void	updateLastWrite() Helper method to centralize updating the last write timestamp.

Methods inherited from class net.spy.memcached.MemcachedConnection

addObserver, addOperation, broadcastOperation, broadcastOperation, checkState, connectionsStatus, createConnections, enqueueOperation, getLocator, handleIO, insertOperation, isShutDown, opSucceeded, opTimedOut, redistributeOperation, redistributeOperations, registerMetrics, removeObserver, retryOperation, shutdown, toString

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

getLogger

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, yield

Methods inherited from class java.lang.Object

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

Field Detail

ALLOWED_IDLE_TIME

protected static final int ALLOWED_IDLE_TIME

The amount in seconds after which a op broadcast is forced to detect dead connections.

See Also:

Constant Field Values

reconfiguring

protected volatile boolean reconfiguring

cf

protected final CouchbaseConnectionFactory cf

lastWrite

protected volatile long lastWrite

Constructor Detail

CouchbaseConnection

public CouchbaseConnection(int bufSize,
                           CouchbaseConnectionFactory f,
                           java.util.List<java.net.InetSocketAddress> a,
                           java.util.Collection<net.spy.memcached.ConnectionObserver> obs,
                           net.spy.memcached.FailureMode fm,
                           net.spy.memcached.OperationFactory opfactory)
                    throws java.io.IOException

Throws:

java.io.IOException

Method Detail

reconfigure

public void reconfigure(Bucket bucket)

Description copied from interface: Reconfigurable

Call on a configuration update.

Specified by:

reconfigure in interface Reconfigurable

Parameters:

bucket - updated vbucket configuration

addOperation

public void addOperation(java.lang.String key,
                         net.spy.memcached.ops.Operation o)

Add an operation to the given connection.

Overrides:

addOperation in class net.spy.memcached.MemcachedConnection

Parameters:

key - the key the operation is operating upon

o - the operation

addOperations

public void addOperations(java.util.Map<net.spy.memcached.MemcachedNode,net.spy.memcached.ops.Operation> ops)

Overrides:

addOperations in class net.spy.memcached.MemcachedConnection

run

public void run()

Infinitely loop processing IO.

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class net.spy.memcached.MemcachedConnection

handleRetryInformation

protected void handleRetryInformation(byte[] retryMessage)

Overrides:

handleRetryInformation in class net.spy.memcached.MemcachedConnection

queueReconnect

protected void queueReconnect(net.spy.memcached.MemcachedNode node)

Only queue for reconnect if the given node is still part of the cluster. Since a node is queued to reconnect, it indicates a close socket and therefore an outdated configuration. With some providers, it is important to force a config reload which is also issued immediately.

Overrides:

queueReconnect in class net.spy.memcached.MemcachedConnection

Parameters:

node - the node to check.

replaceConfigWildcards

public java.lang.String replaceConfigWildcards(java.lang.String original)

Helper method to parse config wildcards into their actual representations. Currently, this method parses the $HOST wildcard and finds the first node in the locator to replace it with.

Parameters:

original - the raw new config string.

Returns:

the potentially changed config string.

updateLastWrite

protected void updateLastWrite()

Helper method to centralize updating the last write timestamp.

handleWokenUpSelector

protected void handleWokenUpSelector()

Make sure that if the selector is woken up manually for an extended period of time that the sockets are still alive.

This is done by broadcasting a operation so that disconnected sockets are discovered even when no load is applied.

Overrides:

handleWokenUpSelector in class net.spy.memcached.MemcachedConnection