com.spotify.folsom.ketama

Class ResolvingKetamaClient

java.lang.Object

com.spotify.folsom.AbstractRawMemcacheClient

com.spotify.folsom.ketama.ResolvingKetamaClient

All Implemented Interfaces:

ObservableClient, RawMemcacheClient

public class ResolvingKetamaClient
extends AbstractRawMemcacheClient

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ResolvingKetamaClient.Connector
private class	ResolvingKetamaClient.MyConnectionChangeListener

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<HostAndPort,RawMemcacheClient>	clients
private ResolvingKetamaClient.Connector	connector
private RawMemcacheClient	currentClient
private java.util.concurrent.ScheduledExecutorService	executor
private ResolvingKetamaClient.MyConnectionChangeListener	listener
private static org.slf4j.Logger	log
static int	MAX_RESOLVE_WAIT_TIME
static int	MIN_RESOLVE_WAIT_TIME
private RawMemcacheClient	pendingClient
private java.util.concurrent.ScheduledFuture<?>	refreshJob
private Resolver	resolver
private boolean	shutdown
private long	shutdownDelay
private java.util.Collection<RawMemcacheClient>	shutdownQueue
private java.util.concurrent.TimeUnit	shutdownUnit
private java.lang.Object	sync
private long	ttl

Constructor Summary

Constructors

Constructor and Description
ResolvingKetamaClient(Resolver resolver, java.util.concurrent.ScheduledExecutorService executor, long period, java.util.concurrent.TimeUnit periodUnit, ResolvingKetamaClient.Connector connector, long shutdownDelay, java.util.concurrent.TimeUnit shutdownUnit)

Method Summary

Modifier and Type	Method and Description
private long	clamp(int min, int max, long value)
java.lang.Throwable	getConnectionFailure() Returns the unrecoverable connection failure, if any.
boolean	isConnected() Is the client connected to a server?
int	numActiveConnections() How many active socket connections do we have (i.e.
int	numPendingRequests()
int	numTotalConnections() How many actual socket connections do we have, including currently disconnected clients.
void	resolve()
<T> java.util.concurrent.CompletionStage<T>	send(Request<T> request)
private void	setPendingClient(com.google.common.collect.ImmutableList.Builder<RawMemcacheClient> removedClients)
void	shutdown() Shut down the client.
void	start()
java.util.stream.Stream<AddressAndClient>	streamNodes() Intended for internal usage.

Methods inherited from class com.spotify.folsom.AbstractRawMemcacheClient

notifyConnectionChange, numListeners, registerForConnectionChanges, unregisterForConnectionChanges

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.spotify.folsom.RawMemcacheClient

getAllNodes

Methods inherited from interface com.spotify.folsom.ObservableClient

awaitConnected, awaitDisconnected, awaitFullyConnected, awaitFullyDisconnected, awaitFuture, connectFuture, disconnectFuture, fullyConnectedFuture, fullyDisconnectFuture

Field Detail

log

private static final org.slf4j.Logger log

MIN_RESOLVE_WAIT_TIME

public static final int MIN_RESOLVE_WAIT_TIME

See Also:

Constant Field Values

MAX_RESOLVE_WAIT_TIME

public static final int MAX_RESOLVE_WAIT_TIME

See Also:

Constant Field Values

executor

private final java.util.concurrent.ScheduledExecutorService executor

resolver

private final Resolver resolver

ttl

private final long ttl

connector

private final ResolvingKetamaClient.Connector connector

shutdownDelay

private final long shutdownDelay

shutdownUnit

private final java.util.concurrent.TimeUnit shutdownUnit

listener

private final ResolvingKetamaClient.MyConnectionChangeListener listener

refreshJob

private java.util.concurrent.ScheduledFuture<?> refreshJob

sync

private final java.lang.Object sync

clients

private final java.util.Map<HostAndPort,RawMemcacheClient> clients

shutdownQueue

private final java.util.Collection<RawMemcacheClient> shutdownQueue

currentClient

private volatile RawMemcacheClient currentClient

pendingClient

private volatile RawMemcacheClient pendingClient

shutdown

private boolean shutdown

Constructor Detail

ResolvingKetamaClient

public ResolvingKetamaClient(Resolver resolver,
                             java.util.concurrent.ScheduledExecutorService executor,
                             long period,
                             java.util.concurrent.TimeUnit periodUnit,
                             ResolvingKetamaClient.Connector connector,
                             long shutdownDelay,
                             java.util.concurrent.TimeUnit shutdownUnit)

Method Detail

start

public void start()

resolve

public void resolve()

clamp

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

send

public <T> java.util.concurrent.CompletionStage<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

getConnectionFailure

public java.lang.Throwable getConnectionFailure()

Description copied from interface: ObservableClient

Returns the unrecoverable connection failure, if any.

Returns:

null, if there's no connection failure

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

numPendingRequests

public int numPendingRequests()

streamNodes

public java.util.stream.Stream<AddressAndClient> streamNodes()

Description copied from interface: RawMemcacheClient

Intended for internal usage. Consumers should use RawMemcacheClient.getAllNodes() instead.

setPendingClient

private void setPendingClient(com.google.common.collect.ImmutableList.Builder<RawMemcacheClient> removedClients)