com.spotify.folsom.reconnect

Class ReconnectingClient

java.lang.Object

com.spotify.folsom.AbstractRawMemcacheClient

com.spotify.folsom.reconnect.ReconnectingClient

All Implemented Interfaces:

ObservableClient, RawMemcacheClient

public class ReconnectingClient
extends AbstractRawMemcacheClient

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReconnectingClient.StandardReconnectionListener This class should be regarded as internal API.

Field Summary

Fields

Modifier and Type	Field and Description
private HostAndPort	address
private BackoffFunction	backoffFunction
private RawMemcacheClient	client
private java.lang.Throwable	connectionFailure
private Connector	connector
private static org.slf4j.Logger	log
private int	reconnectCount
private ReconnectionListener	reconnectionListener
private static java.util.concurrent.ScheduledExecutorService	SCHEDULED_EXECUTOR_SERVICE
private java.util.concurrent.ScheduledExecutorService	scheduledExecutorService
private boolean	stayConnected

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ReconnectingClient(BackoffFunction backoffFunction, java.util.concurrent.ScheduledExecutorService scheduledExecutorService, Connector connector, Authenticator authenticator, HostAndPort address, ReconnectionListener reconnectionListener)
(package private)	ReconnectingClient(BackoffFunction backoffFunction, java.util.concurrent.ScheduledExecutorService scheduledExecutorService, Connector connector, HostAndPort address, ReconnectionListener reconnectionListener)
	ReconnectingClient(BackoffFunction backoffFunction, java.util.concurrent.ScheduledExecutorService scheduledExecutorService, HostAndPort address, int outstandingRequestLimit, int eventLoopThreadFlushMaxBatchSize, boolean binary, Authenticator authenticator, java.util.concurrent.Executor executor, long connectionTimeoutMillis, java.nio.charset.Charset charset, Metrics metrics, int maxSetLength, io.netty.channel.EventLoopGroup eventLoopGroup, java.lang.Class<? extends io.netty.channel.Channel> channelClass)
	ReconnectingClient(BackoffFunction backoffFunction, java.util.concurrent.ScheduledExecutorService scheduledExecutorService, HostAndPort address, ReconnectionListener reconnectionListener, int outstandingRequestLimit, int eventLoopThreadFlushMaxBatchSize, boolean binary, Authenticator authenticator, java.util.concurrent.Executor executor, long connectionTimeoutMillis, java.nio.charset.Charset charset, Metrics metrics, int maxSetLength, io.netty.channel.EventLoopGroup eventLoopGroup, java.lang.Class<? extends io.netty.channel.Channel> channelClass)

Method Summary

Modifier and Type	Method and Description
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.
private void	onFailure(java.lang.Throwable cause)
private void	retry()
<T> java.util.concurrent.CompletionStage<T>	send(Request<T> request)
void	shutdown() Shut down the client.
static java.util.concurrent.ScheduledExecutorService	singletonExecutor()
java.util.stream.Stream<AddressAndClient>	streamNodes() Intended for internal usage.
java.lang.String	toString()

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, 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

SCHEDULED_EXECUTOR_SERVICE

private static final java.util.concurrent.ScheduledExecutorService SCHEDULED_EXECUTOR_SERVICE

log

private static final org.slf4j.Logger log

backoffFunction

private final BackoffFunction backoffFunction

scheduledExecutorService

private final java.util.concurrent.ScheduledExecutorService scheduledExecutorService

connector

private final Connector connector

address

private final HostAndPort address

reconnectionListener

private final ReconnectionListener reconnectionListener

client

private volatile RawMemcacheClient client

reconnectCount

private volatile int reconnectCount

stayConnected

private volatile boolean stayConnected

connectionFailure

private volatile java.lang.Throwable connectionFailure

Constructor Detail

ReconnectingClient

public ReconnectingClient(BackoffFunction backoffFunction,
                          java.util.concurrent.ScheduledExecutorService scheduledExecutorService,
                          HostAndPort address,
                          ReconnectionListener reconnectionListener,
                          int outstandingRequestLimit,
                          int eventLoopThreadFlushMaxBatchSize,
                          boolean binary,
                          Authenticator authenticator,
                          java.util.concurrent.Executor executor,
                          long connectionTimeoutMillis,
                          java.nio.charset.Charset charset,
                          Metrics metrics,
                          int maxSetLength,
                          io.netty.channel.EventLoopGroup eventLoopGroup,
                          java.lang.Class<? extends io.netty.channel.Channel> channelClass)

ReconnectingClient

public ReconnectingClient(BackoffFunction backoffFunction,
                          java.util.concurrent.ScheduledExecutorService scheduledExecutorService,
                          HostAndPort address,
                          int outstandingRequestLimit,
                          int eventLoopThreadFlushMaxBatchSize,
                          boolean binary,
                          Authenticator authenticator,
                          java.util.concurrent.Executor executor,
                          long connectionTimeoutMillis,
                          java.nio.charset.Charset charset,
                          Metrics metrics,
                          int maxSetLength,
                          io.netty.channel.EventLoopGroup eventLoopGroup,
                          java.lang.Class<? extends io.netty.channel.Channel> channelClass)

ReconnectingClient

private ReconnectingClient(BackoffFunction backoffFunction,
                           java.util.concurrent.ScheduledExecutorService scheduledExecutorService,
                           Connector connector,
                           Authenticator authenticator,
                           HostAndPort address,
                           ReconnectionListener reconnectionListener)

ReconnectingClient

ReconnectingClient(BackoffFunction backoffFunction,
                   java.util.concurrent.ScheduledExecutorService scheduledExecutorService,
                   Connector connector,
                   HostAndPort address,
                   ReconnectionListener reconnectionListener)

Method Detail

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.

retry

private void retry()

onFailure

private void onFailure(java.lang.Throwable cause)

singletonExecutor

public static java.util.concurrent.ScheduledExecutorService singletonExecutor()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object