com.lambdaworks.redis.pubsub

Class PubSubCommandHandler<K,V>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

com.lambdaworks.redis.protocol.CommandHandler<K,V>

com.lambdaworks.redis.pubsub.PubSubCommandHandler<K,V>

Type Parameters:

K - Key type.

V - Value type.

All Implemented Interfaces:

RedisChannelWriter<K,V>, ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler, Closeable, AutoCloseable

public class PubSubCommandHandler<K,V>
extends CommandHandler<K,V>

A netty ChannelHandler responsible for writing Redis Pub/Sub commands and reading the response stream from the server. PubSubCommandHandler accounts for Pub/Sub message notification calling back ChannelHandlerContext.fireChannelRead(Object). Redis responses can be interleaved in the sense that a response contains a Pub/Sub message first, then a command response. Possible interleave is introspected via ResponseHeaderReplayOutput and decoding hooks.

Author:

Will Glozer, Mark Paluch

Nested Class Summary

Nested classes/interfaces inherited from class com.lambdaworks.redis.protocol.CommandHandler

CommandHandler.LifecycleState

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

ChannelHandler.Sharable

Field Summary

Fields inherited from class com.lambdaworks.redis.protocol.CommandHandler

buffer, channel, clientOptions, clientResources, commandBuffer, commandHandlerId, disconnectedBuffer, rsm, stack, stateLock, writers

Constructor Summary

Constructors

Constructor and Description
PubSubCommandHandler(ClientOptions clientOptions, ClientResources clientResources, RedisCodec<K,V> codec) Initialize a new instance.

Method Summary

Modifier and Type	Method and Description
protected void	afterComplete(ChannelHandlerContext ctx, RedisCommand<K,V,?> command) Hook method called after command completion.
protected boolean	canComplete(RedisCommand<?,?,?> command) Decoding hook: Can the command be completed.
protected boolean	canDecode(ByteBuf buffer) Decoding hook: Can the buffer be decoded to a command.
void	channelInactive(ChannelHandlerContext ctx)
protected void	complete(RedisCommand<?,?,?> command) Decoding hook: Complete a command.
protected void	decode(ChannelHandlerContext ctx, ByteBuf buffer)
protected CommandOutput<K,V,?>	getCommandOutput(RedisCommand<K,V,?> command) Decoding hook: Retrieve CommandOutput for RedisCommand decoding.

Methods inherited from class com.lambdaworks.redis.protocol.CommandHandler

channelActive, channelRead, channelRegistered, channelUnregistered, close, decrementWriters, drainCommands, drainCommands, exceptionCaught, flushCommands, getStack, getState, incrementWriters, initialState, isClosed, lockWritersExclusive, logPrefix, prepareReset, reset, setAutoFlushCommands, setRedisChannelHandler, setState, unlockWritersExclusive, userEventTriggered, write, write, writeToDisconnectedBuffer

Methods inherited from class io.netty.channel.ChannelDuplexHandler

bind, close, connect, deregister, disconnect, flush, read

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelReadComplete, channelWritabilityChanged

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 io.netty.channel.ChannelHandler

handlerAdded, handlerRemoved

Constructor Detail

PubSubCommandHandler

public PubSubCommandHandler(ClientOptions clientOptions,
                            ClientResources clientResources,
                            RedisCodec<K,V> codec)

Initialize a new instance.

Parameters:

clientOptions - client options for the connection

clientResources - client resources for this connection

codec - Codec.

Method Detail

channelInactive

public void channelInactive(ChannelHandlerContext ctx)
                     throws Exception

Specified by:

channelInactive in interface ChannelInboundHandler

Overrides:

channelInactive in class CommandHandler<K,V>

Throws:

Exception

See Also:

ChannelInboundHandlerAdapter.channelInactive(io.netty.channel.ChannelHandlerContext)

decode

protected void decode(ChannelHandlerContext ctx,
                      ByteBuf buffer)

Overrides:

decode in class CommandHandler<K,V>

canDecode

protected boolean canDecode(ByteBuf buffer)

Description copied from class: CommandHandler

Decoding hook: Can the buffer be decoded to a command.

Overrides:

canDecode in class CommandHandler<K,V>

Returns:

canComplete

protected boolean canComplete(RedisCommand<?,?,?> command)

Description copied from class: CommandHandler

Decoding hook: Can the command be completed.

Overrides:

canComplete in class CommandHandler<K,V>

Returns:

complete

protected void complete(RedisCommand<?,?,?> command)

Description copied from class: CommandHandler

Decoding hook: Complete a command.

Overrides:

complete in class CommandHandler<K,V>

See Also:

RedisCommand.complete()

getCommandOutput

protected CommandOutput<K,V,?> getCommandOutput(RedisCommand<K,V,?> command)

Description copied from class: CommandHandler

Decoding hook: Retrieve CommandOutput for RedisCommand decoding.

Overrides:

getCommandOutput in class CommandHandler<K,V>

Returns:

See Also:

RedisCommand.getOutput()

afterComplete

protected void afterComplete(ChannelHandlerContext ctx,
                             RedisCommand<K,V,?> command)

Description copied from class: CommandHandler

Hook method called after command completion.

Overrides:

afterComplete in class CommandHandler<K,V>