com.couchbase.client.core.endpoint

Class AbstractGenericHandler<RESPONSE,ENCODED,REQUEST extends CouchbaseRequest>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

io.netty.handler.codec.MessageToMessageCodec<RESPONSE,REQUEST>

com.couchbase.client.core.endpoint.AbstractGenericHandler<RESPONSE,ENCODED,REQUEST>

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler

Direct Known Subclasses:

ConfigHandler, KeyValueHandler, QueryHandler, ViewHandler

public abstract class AbstractGenericHandler<RESPONSE,ENCODED,REQUEST extends CouchbaseRequest>
extends MessageToMessageCodec<RESPONSE,REQUEST>

Generic handler which acts as the common base type for all implementing handlers.

Since:

1.0

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 static Charset	CHARSET The default charset to use for all requests and responses.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractGenericHandler(AbstractEndpoint endpoint, com.lmax.disruptor.EventSink<ResponseEvent> responseBuffer) Creates a new AbstractGenericHandler with the default queue.
protected	AbstractGenericHandler(AbstractEndpoint endpoint, com.lmax.disruptor.EventSink<ResponseEvent> responseBuffer, Queue<REQUEST> queue) Creates a new AbstractGenericHandler with a custom queue.

Method Summary

Modifier and Type	Method and Description
void	channelActive(ChannelHandlerContext ctx)
void	channelInactive(ChannelHandlerContext ctx)
void	channelWritabilityChanged(ChannelHandlerContext ctx)
protected REQUEST	currentRequest() Returns the current request if set.
protected void	decode(ChannelHandlerContext ctx, RESPONSE msg, List<Object> out)
protected abstract CouchbaseResponse	decodeResponse(ChannelHandlerContext ctx, RESPONSE msg) Decodes the incoming response and transforms it into a CouchbaseResponse.
protected void	encode(ChannelHandlerContext ctx, REQUEST msg, List<Object> out)
protected abstract ENCODED	encodeRequest(ChannelHandlerContext ctx, REQUEST msg) Encode the outgoing request and return it in encoded format.
protected CoreEnvironment	env() Returns environment.
void	exceptionCaught(ChannelHandlerContext ctx, Throwable cause)
protected void	finishedDecoding() Notify that decoding is finished.
void	handlerRemoved(ChannelHandlerContext ctx)
protected static String	logIdent(ChannelHandlerContext ctx, Endpoint endpoint) Simple log helper to give logs a common prefix.
protected void	publishResponse(CouchbaseResponse response, Subject<CouchbaseResponse,CouchbaseResponse> observable) Publishes a response with the attached observable.

Methods inherited from class io.netty.handler.codec.MessageToMessageCodec

acceptInboundMessage, acceptOutboundMessage, channelRead, write

Methods inherited from class io.netty.channel.ChannelDuplexHandler

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

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelReadComplete, channelRegistered, channelUnregistered, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

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

Field Detail

CHARSET

protected static final Charset CHARSET

The default charset to use for all requests and responses.

Constructor Detail

AbstractGenericHandler

protected AbstractGenericHandler(AbstractEndpoint endpoint,
                                 com.lmax.disruptor.EventSink<ResponseEvent> responseBuffer)

Creates a new AbstractGenericHandler with the default queue.

Parameters:

endpoint - the endpoint reference.

responseBuffer - the response buffer.

AbstractGenericHandler

protected AbstractGenericHandler(AbstractEndpoint endpoint,
                                 com.lmax.disruptor.EventSink<ResponseEvent> responseBuffer,
                                 Queue<REQUEST> queue)

Creates a new AbstractGenericHandler with a custom queue.

Parameters:

endpoint - the endpoint reference.

responseBuffer - the response buffer.

queue - the queue.

Method Detail

encodeRequest

protected abstract ENCODED encodeRequest(ChannelHandlerContext ctx,
                                         REQUEST msg)
                                  throws Exception

Encode the outgoing request and return it in encoded format.

This method needs to be implemented by the child handler and is responsible for the actual conversion.

Parameters:

ctx - the context passed in.

msg - the outgoing message.

Returns:

the encoded request.

Throws:

Exception - as a generic error.

decodeResponse

protected abstract CouchbaseResponse decodeResponse(ChannelHandlerContext ctx,
                                                    RESPONSE msg)
                                             throws Exception

Decodes the incoming response and transforms it into a CouchbaseResponse.

Note that the actual notification is handled by this generic handler, the implementing class only is concerned about the conversion itself.

Parameters:

ctx - the context passed in.

msg - the incoming message.

Returns:

a response or null if nothing should be returned.

Throws:

Exception - as a generic error.

encode

protected void encode(ChannelHandlerContext ctx,
                      REQUEST msg,
                      List<Object> out)
               throws Exception

Specified by:

encode in class MessageToMessageCodec<RESPONSE,REQUEST extends CouchbaseRequest>

Throws:

Exception

decode

protected void decode(ChannelHandlerContext ctx,
                      RESPONSE msg,
                      List<Object> out)
               throws Exception

Specified by:

decode in class MessageToMessageCodec<RESPONSE,REQUEST extends CouchbaseRequest>

Throws:

Exception

publishResponse

protected void publishResponse(CouchbaseResponse response,
                               Subject<CouchbaseResponse,CouchbaseResponse> observable)

Publishes a response with the attached observable.

Parameters:

response - the response to publish.

observable - pushing into the event sink.

finishedDecoding

protected void finishedDecoding()

Notify that decoding is finished. This needs to be called by the child handlers in order to signal that operations are done.

channelInactive

public void channelInactive(ChannelHandlerContext ctx)
                     throws Exception

Specified by:

channelInactive in interface ChannelInboundHandler

Overrides:

channelInactive in class ChannelInboundHandlerAdapter

Throws:

Exception

channelActive

public void channelActive(ChannelHandlerContext ctx)
                   throws Exception

Specified by:

channelActive in interface ChannelInboundHandler

Overrides:

channelActive in class ChannelInboundHandlerAdapter

Throws:

Exception

channelWritabilityChanged

public void channelWritabilityChanged(ChannelHandlerContext ctx)
                               throws Exception

Specified by:

channelWritabilityChanged in interface ChannelInboundHandler

Overrides:

channelWritabilityChanged in class ChannelInboundHandlerAdapter

Throws:

Exception

exceptionCaught

public void exceptionCaught(ChannelHandlerContext ctx,
                            Throwable cause)
                     throws Exception

Specified by:

exceptionCaught in interface ChannelHandler

Specified by:

exceptionCaught in interface ChannelInboundHandler

Overrides:

exceptionCaught in class ChannelInboundHandlerAdapter

Throws:

Exception

handlerRemoved

public void handlerRemoved(ChannelHandlerContext ctx)
                    throws Exception

Specified by:

handlerRemoved in interface ChannelHandler

Overrides:

handlerRemoved in class ChannelHandlerAdapter

Throws:

Exception

currentRequest

protected REQUEST currentRequest()

Returns the current request if set.

Returns:

the current request.

env

protected CoreEnvironment env()

Returns environment.

Returns:

the environment

logIdent

protected static String logIdent(ChannelHandlerContext ctx,
                                 Endpoint endpoint)

Simple log helper to give logs a common prefix.

Parameters:

ctx - the context.

endpoint - the endpoint.

Returns:

a prefix string for logs.