com.spotify.folsom.ketama

Class SrvKetamaClient

java.lang.Object

com.spotify.folsom.AbstractRawMemcacheClient

com.spotify.folsom.ketama.SrvKetamaClient

All Implemented Interfaces:

ObservableClient, RawMemcacheClient

public class SrvKetamaClient
extends AbstractRawMemcacheClient

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SrvKetamaClient.Connector
private static class	SrvKetamaClient.HostAndPortComparator
private class	SrvKetamaClient.MyConnectionChangeListener
private class	SrvKetamaClient.ShutdownJob

Field Summary

Fields

Modifier and Type	Field and Description
private List<com.google.common.net.HostAndPort>	addresses
private SrvKetamaClient.Connector	connector
private RawMemcacheClient	currentClient
private ScheduledExecutorService	executor
private SrvKetamaClient.MyConnectionChangeListener	listener
private static org.slf4j.Logger	log
static int	MAX_DNS_WAIT_TIME
static int	MIN_DNS_WAIT_TIME
private RawMemcacheClient	pendingClient
private long	period
private TimeUnit	periodUnit
private ScheduledFuture<?>	refreshJob
private Runnable	refreshRunnable
private boolean	shutdown
private long	shutdownDelay
private TimeUnit	shutdownUnit
private String	srvRecord
private com.spotify.dns.DnsSrvResolver	srvResolver
private Object	sync

Constructor Summary

Constructors

Constructor and Description
SrvKetamaClient(String srvRecord, com.spotify.dns.DnsSrvResolver srvResolver, ScheduledExecutorService executor, long period, TimeUnit periodUnit, SrvKetamaClient.Connector connector, long shutdownDelay, TimeUnit shutdownUnit)

Method Summary

Modifier and Type	Method and Description
private long	clamp(int min, int max, long value)
private List<AddressAndClient>	getAddressesAndClients(List<com.google.common.net.HostAndPort> newAddresses)
boolean	isConnected() Is the client connected to a server?
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.
<T> com.google.common.util.concurrent.ListenableFuture<T>	send(Request<T> request)
private void	setPendingClient(List<AddressAndClient> addressAndClients)
void	shutdown() Shut down the client.
void	start()
void	updateDNS()

Methods inherited from class com.spotify.folsom.AbstractRawMemcacheClient

notifyConnectionChange, registerForConnectionChanges, unregisterForConnectionChanges

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final org.slf4j.Logger log

MIN_DNS_WAIT_TIME

public static final int MIN_DNS_WAIT_TIME

See Also:

Constant Field Values

MAX_DNS_WAIT_TIME

public static final int MAX_DNS_WAIT_TIME

See Also:

Constant Field Values

executor

private final ScheduledExecutorService executor

srvRecord

private final String srvRecord

srvResolver

private final com.spotify.dns.DnsSrvResolver srvResolver

period

private final long period

periodUnit

private final TimeUnit periodUnit

connector

private final SrvKetamaClient.Connector connector

shutdownDelay

private final long shutdownDelay

shutdownUnit

private final TimeUnit shutdownUnit

listener

private final SrvKetamaClient.MyConnectionChangeListener listener

refreshRunnable

private final Runnable refreshRunnable

refreshJob

private ScheduledFuture<?> refreshJob

sync

private final Object sync

addresses

private volatile List<com.google.common.net.HostAndPort> addresses

currentClient

private volatile RawMemcacheClient currentClient

pendingClient

private volatile RawMemcacheClient pendingClient

shutdown

private boolean shutdown

Constructor Detail

SrvKetamaClient

public SrvKetamaClient(String srvRecord,
                       com.spotify.dns.DnsSrvResolver srvResolver,
                       ScheduledExecutorService executor,
                       long period,
                       TimeUnit periodUnit,
                       SrvKetamaClient.Connector connector,
                       long shutdownDelay,
                       TimeUnit shutdownUnit)

Method Detail

start

public void start()

updateDNS

public void updateDNS()

clamp

private long clamp(int min,
                   int max,
                   long value)

getAddressesAndClients

private List<AddressAndClient> getAddressesAndClients(List<com.google.common.net.HostAndPort> newAddresses)

send

public <T> com.google.common.util.concurrent.ListenableFuture<T> send(Request<T> request)

shutdown

public void shutdown()

Description copied from interface: RawMemcacheClient

Shut down the client. Use ObservableClient.registerForConnectionChanges(ConnectionChangeListener) to to get notified when it has (possibly) finished shutting down

isConnected

public boolean isConnected()

Description copied from interface: ObservableClient

Is the client connected to a server?

Returns:

true if the client is connected

numTotalConnections

public int numTotalConnections()

Description copied from interface: RawMemcacheClient

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

Returns:

the number of total connections

numActiveConnections

public int numActiveConnections()

Description copied from interface: RawMemcacheClient

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

Returns:

the number of active connections

setPendingClient

private void setPendingClient(List<AddressAndClient> addressAndClients)