Class BinaryMemcacheObjectAggregator

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.MessageToMessageDecoder<MemcacheObject>

io.netty.handler.codec.MessageAggregator<MemcacheObject, BinaryMemcacheMessage, MemcacheContent, FullMemcacheMessage>

io.netty.handler.codec.memcache.AbstractMemcacheObjectAggregator<BinaryMemcacheMessage>

io.netty.handler.codec.memcache.binary.BinaryMemcacheObjectAggregator

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler

@UnstableApi
public class BinaryMemcacheObjectAggregator
extends AbstractMemcacheObjectAggregator<BinaryMemcacheMessage>

An object aggregator for the memcache binary protocol. It aggregates BinaryMemcacheMessages and MemcacheContent into FullBinaryMemcacheRequests or FullBinaryMemcacheResponses.

Nested Class Summary

Nested classes/interfaces inherited from interface ChannelHandler

ChannelHandler.Sharable

Modifier and Type	Interface	Description
static @interface	ChannelHandler.Sharable	Indicates that the same instance of the annotated ChannelHandler can be added to one or more ChannelPipelines multiple times without a race condition.

Constructor Summary

Constructors

Constructor	Description
BinaryMemcacheObjectAggregator(int maxContentLength)

Method Summary

Modifier and Type	Method	Description
protected FullMemcacheMessage	beginAggregation(BinaryMemcacheMessage start, ByteBuf content)	Creates a new aggregated message from the specified start message and the specified content.
protected boolean	isStartMessage(MemcacheObject msg)	Returns true if and only if the specified message is a start message.

Methods inherited from class AbstractMemcacheObjectAggregator

closeAfterContinueResponse, ignoreContentAfterContinueResponse, isAggregated, isContentLengthInvalid, isContentMessage, isLastContentMessage, newContinueResponse

Modifier and Type	Method	Description
protected boolean	closeAfterContinueResponse(Object msg)	Determine if the channel should be closed after the result of MessageAggregator.newContinueResponse(Object, int, ChannelPipeline) is written.
protected boolean	ignoreContentAfterContinueResponse(Object msg)	Determine if all objects for the current request/response should be ignored or not.
protected boolean	isAggregated(MemcacheObject msg)	Returns true if and only if the specified message is already aggregated.
protected boolean	isContentLengthInvalid(BinaryMemcacheMessage start, int maxContentLength)	Determine if the message start's content length is known, and if it greater than maxContentLength.
protected boolean	isContentMessage(MemcacheObject msg)	Returns true if and only if the specified message is a content message.
protected boolean	isLastContentMessage(MemcacheContent msg)	Returns true if and only if the specified message is the last content message.
protected Object	newContinueResponse(BinaryMemcacheMessage start, int maxContentLength, ChannelPipeline pipeline)	Returns the 'continue response' for the specified start message if necessary.

Methods inherited from class MessageAggregator

acceptInboundMessage, aggregate, channelInactive, channelReadComplete, ctx, decode, finishAggregation, handleOversizedMessage, handlerAdded, handlerRemoved, isHandlingOversizedMessage, maxContentLength, maxCumulationBufferComponents, releaseCurrentMessage, setMaxCumulationBufferComponents

Modifier and Type	Method	Description
boolean	acceptInboundMessage(Object msg)	Returns true if the given message should be handled.
protected void	aggregate(FullMemcacheMessage aggregated, MemcacheContent content)	Transfers the information provided by the specified content message to the specified aggregated message.
void	channelInactive(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelInactive() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	channelReadComplete(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelReadComplete() to forward to the next ChannelInboundHandler in the ChannelPipeline.
protected final ChannelHandlerContext	ctx()
protected void	decode(ChannelHandlerContext ctx, MemcacheObject msg, List<Object> out)	Decode from one message to an other.
protected void	finishAggregation(FullMemcacheMessage aggregated)	Invoked when the specified aggregated message is about to be passed to the next handler in the pipeline.
protected void	handleOversizedMessage(ChannelHandlerContext ctx, BinaryMemcacheMessage oversized)	Invoked when an incoming request exceeds the maximum content length.
void	handlerAdded(ChannelHandlerContext ctx)	Do nothing by default, sub-classes may override this method.
void	handlerRemoved(ChannelHandlerContext ctx)	Do nothing by default, sub-classes may override this method.
final boolean	isHandlingOversizedMessage()	Deprecated. This method will be removed in future releases.
final int	maxContentLength()	Returns the maximum allowed length of the aggregated message in bytes.
final int	maxCumulationBufferComponents()	Returns the maximum number of components in the cumulation buffer.
protected final void	releaseCurrentMessage()
final void	setMaxCumulationBufferComponents(int maxCumulationBufferComponents)	Sets the maximum number of components in the cumulation buffer.

Methods inherited from class MessageToMessageDecoder

channelRead

Modifier and Type	Method	Description
void	channelRead(ChannelHandlerContext ctx, Object msg)	Calls ChannelHandlerContext.fireChannelRead(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline.

Methods inherited from class ChannelInboundHandlerAdapter

channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered

Modifier and Type	Method	Description
void	channelActive(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelActive() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	channelRegistered(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelRegistered() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	channelUnregistered(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelUnregistered() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	channelWritabilityChanged(ChannelHandlerContext ctx)	Calls ChannelHandlerContext.fireChannelWritabilityChanged() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	exceptionCaught(ChannelHandlerContext ctx, Throwable cause)	Calls ChannelHandlerContext.fireExceptionCaught(Throwable) to forward to the next ChannelHandler in the ChannelPipeline.
void	userEventTriggered(ChannelHandlerContext ctx, Object evt)	Calls ChannelHandlerContext.fireUserEventTriggered(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline.

Methods inherited from class ChannelHandlerAdapter

ensureNotSharable, isSharable

Modifier and Type	Method	Description
protected void	ensureNotSharable()	Throws IllegalStateException if ChannelHandlerAdapter.isSharable() returns true
boolean	isSharable()	Return true if the implementation is ChannelHandler.Sharable and so can be added to different ChannelPipelines.

Methods inherited from class Object

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

Constructor Details

BinaryMemcacheObjectAggregator

public BinaryMemcacheObjectAggregator(int maxContentLength)

Method Details

isStartMessage

protected boolean isStartMessage(MemcacheObject msg)
                          throws Exception

Description copied from class: MessageAggregator

Returns true if and only if the specified message is a start message. Typically, this method is implemented as a single return statement with instanceof:

return msg instanceof MyStartMessage;

Specified by:

isStartMessage in class MessageAggregator<MemcacheObject, BinaryMemcacheMessage, MemcacheContent, FullMemcacheMessage>

Throws:

Exception

beginAggregation

protected FullMemcacheMessage beginAggregation(BinaryMemcacheMessage start,
 ByteBuf content)
                                        throws Exception

Description copied from class: MessageAggregator

Creates a new aggregated message from the specified start message and the specified content. If the start message implements ByteBufHolder, its content is appended to the specified content. This aggregator will continue to append the received content to the specified content.

Specified by:

beginAggregation in class MessageAggregator<MemcacheObject, BinaryMemcacheMessage, MemcacheContent, FullMemcacheMessage>

Throws:

Exception