com.spotify.folsom.client.ascii

Class DefaultAsciiMemcacheClient<V>

java.lang.Object

com.spotify.folsom.client.ascii.DefaultAsciiMemcacheClient<V>

Type Parameters:

V - The value type for all operations

All Implemented Interfaces:

AsciiMemcacheClient<V>, MemcacheClient<V>, ObservableClient

public class DefaultAsciiMemcacheClient<V>
extends Object
implements AsciiMemcacheClient<V>

The default implementation of AsciiMemcacheClient

Field Summary

Fields

Modifier and Type	Field and Description
private Charset	charset
private Metrics	metrics
private RawMemcacheClient	rawMemcacheClient
private TransformerUtil<V>	transformerUtil
private Transcoder<V>	valueTranscoder

Constructor Summary

Constructors

Constructor and Description
DefaultAsciiMemcacheClient(RawMemcacheClient rawMemcacheClient, Metrics metrics, Transcoder<V> valueTranscoder, Charset charset)

Method Summary

Modifier and Type	Method and Description
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	add(String key, V value, int ttl) Add a key in memcache with the provided value, with the specified TTL.
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	append(String key, V value)
com.google.common.util.concurrent.ListenableFuture<List<GetResult<V>>>	casGet(List<String> keys) Get the value for the provided keys
com.google.common.util.concurrent.ListenableFuture<GetResult<V>>	casGet(String key) Get the value for the provided key, including the CAS value
com.google.common.util.concurrent.ListenableFuture<Long>	decr(String key, long by) Decrement a counter for the provided key
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	delete(String key) Delete the provided key
com.google.common.util.concurrent.ListenableFuture<List<V>>	get(List<String> keys) Get the value for the provided keys
com.google.common.util.concurrent.ListenableFuture<V>	get(String key) Get the value for the provided key
private com.google.common.util.concurrent.ListenableFuture<GetResult<V>>	get(String key, boolean withCas)
RawMemcacheClient	getRawMemcacheClient() Note: This is typically only useful for testing and debugging
com.google.common.util.concurrent.ListenableFuture<Long>	incr(String key, long by) Increment a counter for the provided key
boolean	isConnected() Is the client connected to a server?
private com.google.common.util.concurrent.ListenableFuture<List<GetResult<V>>>	multiget(List<String> keys, boolean withCas)
int	numActiveConnections() How many active socket connections do we have (i.e.
int	numTotalConnections() How many actual socket connections do we have, including currently disconnected clients.
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	prepend(String key, V value)
void	registerForConnectionChanges(ConnectionChangeListener listener) Register for connection change events.
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	replace(String key, V value, int ttl) Replace a key in memcache with the provided value, with the specified TTL.
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	set(String key, V value, int ttl) Set a key in memcache to the provided value, with the specified TTL
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	set(String key, V value, int ttl, long cas) Compare and set a key in memcache to the provided value, with the specified TTL
void	shutdown() Shut down the client.
String	toString()
com.google.common.util.concurrent.ListenableFuture<MemcacheStatus>	touch(String key, int ttl) Sets the expiration for the provided key
void	unregisterForConnectionChanges(ConnectionChangeListener listener) Unregister the provided listener so that it no longer receives connection change callbacks.

Methods inherited from class java.lang.Object

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

Field Detail

rawMemcacheClient

private final RawMemcacheClient rawMemcacheClient

metrics

private final Metrics metrics

valueTranscoder

private final Transcoder<V> valueTranscoder

transformerUtil

private final TransformerUtil<V> transformerUtil

charset

private final Charset charset

Constructor Detail

DefaultAsciiMemcacheClient

public DefaultAsciiMemcacheClient(RawMemcacheClient rawMemcacheClient,
                                  Metrics metrics,
                                  Transcoder<V> valueTranscoder,
                                  Charset charset)

Method Detail

set

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> set(String key,
                                                                              V value,
                                                                              int ttl)

Description copied from interface: MemcacheClient

Set a key in memcache to the provided value, with the specified TTL

Specified by:

set in interface MemcacheClient<V>

Parameters:

key - The key, must not be null

value - The value, must not be null

ttl - The TTL in seconds

Returns:

A future representing completion of the request

set

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> set(String key,
                                                                              V value,
                                                                              int ttl,
                                                                              long cas)

Description copied from interface: MemcacheClient

Compare and set a key in memcache to the provided value, with the specified TTL

Specified by:

set in interface MemcacheClient<V>

Parameters:

key - The key, must not be null

value - The value, must not be null

ttl - The TTL in seconds

cas - The CAS value, must match the value on the server for the set to go through

Returns:

A future representing completion of the request.

delete

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> delete(String key)

Description copied from interface: MemcacheClient

Delete the provided key

Specified by:

delete in interface MemcacheClient<V>

Parameters:

key - Key, must not be null

Returns:

A future representing completion of the request

add

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> add(String key,
                                                                              V value,
                                                                              int ttl)

Description copied from interface: MemcacheClient

Add a key in memcache with the provided value, with the specified TTL. Key must not exist in memcache

Specified by:

add in interface MemcacheClient<V>

Parameters:

key - The key, must not be null

value - The value, must not be null

ttl - The TTL in seconds

Returns:

A future representing completion of the request

replace

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> replace(String key,
                                                                                  V value,
                                                                                  int ttl)

Description copied from interface: MemcacheClient

Replace a key in memcache with the provided value, with the specified TTL. Key must exist in memcache

Specified by:

replace in interface MemcacheClient<V>

Parameters:

key - The key, must not be null

value - The value, must not be null

ttl - The TTL in seconds

Returns:

A future representing completion of the request

append

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> append(String key,
                                                                                 V value)

Specified by:

append in interface MemcacheClient<V>

prepend

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> prepend(String key,
                                                                                  V value)

Specified by:

prepend in interface MemcacheClient<V>

incr

public com.google.common.util.concurrent.ListenableFuture<Long> incr(String key,
                                                                     long by)

Description copied from interface: AsciiMemcacheClient

Increment a counter for the provided key

Specified by:

incr in interface AsciiMemcacheClient<V>

Parameters:

key - The key, must not be null

by - The value to increment the counter by

Returns:

A future representing completion of the request, with the new value of the counter

decr

public com.google.common.util.concurrent.ListenableFuture<Long> decr(String key,
                                                                     long by)

Description copied from interface: AsciiMemcacheClient

Decrement a counter for the provided key

Specified by:

decr in interface AsciiMemcacheClient<V>

Parameters:

key - The key, must not be null

by - The value to decrement the counter by

Returns:

A future representing completion of the request, with the new value of the counter

get

public com.google.common.util.concurrent.ListenableFuture<V> get(String key)

Description copied from interface: MemcacheClient

Get the value for the provided key

Specified by:

get in interface MemcacheClient<V>

Parameters:

key - The key, must not be null

Returns:

A future representing completion of the request, with the value, or null if the key does not exist

casGet

public com.google.common.util.concurrent.ListenableFuture<GetResult<V>> casGet(String key)

Description copied from interface: MemcacheClient

Get the value for the provided key, including the CAS value

Specified by:

casGet in interface MemcacheClient<V>

Parameters:

key - First key, must not be null

Returns:

A future representing completion of the request, with the value, including the CAS value, or null if the value does not exists.

get

private com.google.common.util.concurrent.ListenableFuture<GetResult<V>> get(String key,
                                                                             boolean withCas)

get

public com.google.common.util.concurrent.ListenableFuture<List<V>> get(List<String> keys)

Description copied from interface: MemcacheClient

Get the value for the provided keys

Specified by:

get in interface MemcacheClient<V>

Parameters:

keys - Keys, must not be null, nor must any key in the list

Returns:

A future representing completion of the request, with the values. Any non existing values will be null. Order will be maintained from the input keys

casGet

public com.google.common.util.concurrent.ListenableFuture<List<GetResult<V>>> casGet(List<String> keys)

Description copied from interface: MemcacheClient

Get the value for the provided keys

Specified by:

casGet in interface MemcacheClient<V>

Parameters:

keys - Keys, must not be null, nor must any key in the list

Returns:

A future representing completion of the request, with the values, including the CAS value. Any non existing values will be null. Order will be maintained from the input keys

touch

public com.google.common.util.concurrent.ListenableFuture<MemcacheStatus> touch(String key,
                                                                                int ttl)

Description copied from interface: MemcacheClient

Sets the expiration for the provided key

Specified by:

touch in interface MemcacheClient<V>

Parameters:

key - First key, must not be null

ttl - The TTL in seconds

Returns:

A future representing completion of the request

multiget

private com.google.common.util.concurrent.ListenableFuture<List<GetResult<V>>> multiget(List<String> keys,
                                                                                        boolean withCas)

shutdown

public void shutdown()

Description copied from interface: MemcacheClient

Shut down the client.

Specified by:

shutdown in interface MemcacheClient<V>

registerForConnectionChanges

public void registerForConnectionChanges(ConnectionChangeListener listener)

Description copied from interface: ObservableClient

Register for connection change events. This should trigger at least once for every connection change. You should immediately get an initial callback, so that if you are creating a ListenableFuture looking for a connection state that has already been reached it will return immediately.

Specified by:

registerForConnectionChanges in interface ObservableClient

Parameters:

listener - the listener to notify of connection changes

unregisterForConnectionChanges

public void unregisterForConnectionChanges(ConnectionChangeListener listener)

Description copied from interface: ObservableClient

Unregister the provided listener so that it no longer receives connection change callbacks.

Specified by:

unregisterForConnectionChanges in interface ObservableClient

Parameters:

listener - the listener to unregister.

isConnected

public boolean isConnected()

Description copied from interface: ObservableClient

Is the client connected to a server?

Specified by:

isConnected in interface ObservableClient

Returns:

true if the client is connected

numTotalConnections

public int numTotalConnections()

Description copied from interface: MemcacheClient

How many actual socket connections do we have, including currently disconnected clients.

Specified by:

numTotalConnections in interface MemcacheClient<V>

Returns:

the number of total connections

numActiveConnections

public int numActiveConnections()

Description copied from interface: MemcacheClient

How many active socket connections do we have (i.e. not disconnected)

Specified by:

numActiveConnections in interface MemcacheClient<V>

Returns:

the number of active connections

toString

public String toString()

Overrides:

toString in class Object

getRawMemcacheClient

public RawMemcacheClient getRawMemcacheClient()

Description copied from interface: MemcacheClient

Note: This is typically only useful for testing and debugging

Specified by:

getRawMemcacheClient in interface MemcacheClient<V>

Returns:

the underlying raw memcache client.