com.lambdaworks.redis

Class StatefulRedisConnectionImpl<K,V>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

com.lambdaworks.redis.RedisChannelHandler<K,V>

com.lambdaworks.redis.StatefulRedisConnectionImpl<K,V>

Type Parameters:

K - Key type.

V - Value type.

All Implemented Interfaces:

StatefulConnection<K,V>, StatefulRedisConnection<K,V>, ChannelHandler, ChannelInboundHandler, Closeable, AutoCloseable

Direct Known Subclasses:

StatefulRedisPubSubConnectionImpl

@ChannelHandler.Sharable
public class StatefulRedisConnectionImpl<K,V>
extends RedisChannelHandler<K,V>
implements StatefulRedisConnection<K,V>

A thread-safe connection to a Redis server. Multiple threads may share one StatefulRedisConnectionImpl A ConnectionWatchdog monitors each connection and reconnects automatically until RedisChannelHandler.close() is called. All pending commands will be (re)sent after successful reconnection.

Author:

Mark Paluch

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field and Description
protected RedisAsyncCommandsImpl<K,V>	async
protected RedisCodec<K,V>	codec
protected MultiOutput<K,V>	multi
protected RedisReactiveCommandsImpl<K,V>	reactive
protected RedisCommands<K,V>	sync

Fields inherited from class com.lambdaworks.redis.RedisChannelHandler

timeout, unit

Constructor Summary

Constructors

Constructor and Description
StatefulRedisConnectionImpl(RedisChannelWriter<K,V> writer, RedisCodec<K,V> codec, long timeout, TimeUnit unit) Initialize a new connection.

Method Summary

Modifier and Type	Method and Description
void	activated() Notification when the connection becomes active (connected).
RedisAsyncCommands<K,V>	async() Returns the RedisAsyncCommands API for the current connection.
<T,C extends RedisCommand<K,V,T>> C	dispatch(C command) Dispatch a command.
boolean	isMulti()
protected RedisAsyncCommandsImpl<K,V>	newRedisAsyncCommandsImpl() Create a new instance of RedisAsyncCommandsImpl.
protected RedisReactiveCommandsImpl<K,V>	newRedisReactiveCommandsImpl() Create a new instance of RedisReactiveCommandsImpl.
protected RedisCommands<K,V>	newRedisSyncCommandsImpl() Create a new instance of RedisCommands.
RedisReactiveCommands<K,V>	reactive() Returns the RedisReactiveCommands API for the current connection.
void	setClientName(String clientName)
RedisCommands<K,V>	sync() Returns the RedisCommands API for the current connection.

Methods inherited from class com.lambdaworks.redis.RedisChannelHandler

addListener, channelRead, channelRead, channelRegistered, close, deactivated, flushCommands, getChannelWriter, getOptions, getTimeout, getTimeoutUnit, isClosed, isOpen, registerCloseables, reset, setAutoFlushCommands, setOptions, setTimeout, syncHandler

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelReadComplete, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, handlerAdded, handlerRemoved, isSharable

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.lambdaworks.redis.api.StatefulConnection

close, flushCommands, getOptions, getTimeout, getTimeoutUnit, isOpen, reset, setAutoFlushCommands, setTimeout

Methods inherited from interface io.netty.channel.ChannelHandler

handlerAdded, handlerRemoved

Field Detail

codec

protected final RedisCodec<K,V> codec

sync

protected final RedisCommands<K,V> sync

async

protected final RedisAsyncCommandsImpl<K,V> async

reactive

protected final RedisReactiveCommandsImpl<K,V> reactive

multi

protected MultiOutput<K,V> multi

Constructor Detail

StatefulRedisConnectionImpl

public StatefulRedisConnectionImpl(RedisChannelWriter<K,V> writer,
                                   RedisCodec<K,V> codec,
                                   long timeout,
                                   TimeUnit unit)

Initialize a new connection.

Parameters:

writer - the channel writer

codec - Codec used to encode/decode keys and values.

timeout - Maximum time to wait for a response.

unit - Unit of time for the timeout.

Method Detail

async

public RedisAsyncCommands<K,V> async()

Description copied from interface: StatefulRedisConnection

Returns the RedisAsyncCommands API for the current connection. Does not create a new connection.

Specified by:

async in interface StatefulRedisConnection<K,V>

Returns:

the asynchronous API for the underlying connection.

newRedisSyncCommandsImpl

protected RedisCommands<K,V> newRedisSyncCommandsImpl()

Create a new instance of RedisCommands. Can be overriden to extend.

Returns:

a new instance

newRedisAsyncCommandsImpl

protected RedisAsyncCommandsImpl<K,V> newRedisAsyncCommandsImpl()

Create a new instance of RedisAsyncCommandsImpl. Can be overriden to extend.

Returns:

a new instance

reactive

public RedisReactiveCommands<K,V> reactive()

Description copied from interface: StatefulRedisConnection

Returns the RedisReactiveCommands API for the current connection. Does not create a new connection.

Specified by:

reactive in interface StatefulRedisConnection<K,V>

Returns:

the reactive API for the underlying connection.

newRedisReactiveCommandsImpl

protected RedisReactiveCommandsImpl<K,V> newRedisReactiveCommandsImpl()

Create a new instance of RedisReactiveCommandsImpl. Can be overriden to extend.

Returns:

a new instance

sync

public RedisCommands<K,V> sync()

Description copied from interface: StatefulRedisConnection

Returns the RedisCommands API for the current connection. Does not create a new connection.

Specified by:

sync in interface StatefulRedisConnection<K,V>

Returns:

the synchronous API for the underlying connection.

isMulti

public boolean isMulti()

Specified by:

isMulti in interface StatefulRedisConnection<K,V>

Returns:

true, if the connection is within a transaction.

activated

public void activated()

Description copied from class: RedisChannelHandler

Notification when the connection becomes active (connected).

Overrides:

activated in class RedisChannelHandler<K,V>

dispatch

public <T,C extends RedisCommand<K,V,T>> C dispatch(C command)

Description copied from interface: StatefulConnection

Dispatch a command. Write a command on the channel. The command may be changed/wrapped during write and the written instance is returned after the call. This command does not wait until the command completes and does not guarantee whether the command is executed successfully.

Specified by:

dispatch in interface StatefulConnection<K,V>

Overrides:

dispatch in class RedisChannelHandler<K,V>

Type Parameters:

T - result type

C - command type

Parameters:

command - the Redis command

Returns:

the written redis command

setClientName

public void setClientName(String clientName)