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:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundHandler, io.netty.channel.ChannelOutboundHandler

Direct Known Subclasses:

ConfigHandler, KeyValueHandler, QueryHandler, ViewHandler

public abstract class AbstractGenericHandler<RESPONSE,ENCODED,REQUEST extends CouchbaseRequest>
extends io.netty.handler.codec.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

io.netty.channel.ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.nio.charset.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, java.util.Queue<REQUEST> queue) Creates a new AbstractGenericHandler with a custom queue.

Method Summary

Methods

Modifier and Type	Method and Description
void	channelActive(io.netty.channel.ChannelHandlerContext ctx)
void	channelInactive(io.netty.channel.ChannelHandlerContext ctx)
void	channelWritabilityChanged(io.netty.channel.ChannelHandlerContext ctx)
protected REQUEST	currentRequest() Returns the current request if set.
protected void	decode(io.netty.channel.ChannelHandlerContext ctx, RESPONSE msg, java.util.List<java.lang.Object> out)
protected abstract CouchbaseResponse	decodeResponse(io.netty.channel.ChannelHandlerContext ctx, RESPONSE msg) Decodes the incoming response and transforms it into a CouchbaseResponse.
protected void	encode(io.netty.channel.ChannelHandlerContext ctx, REQUEST msg, java.util.List<java.lang.Object> out)
protected abstract ENCODED	encodeRequest(io.netty.channel.ChannelHandlerContext ctx, REQUEST msg) Encode the outgoing request and return it in encoded format.
protected CoreEnvironment	env() Returns environment.
void	exceptionCaught(io.netty.channel.ChannelHandlerContext ctx, java.lang.Throwable cause)
protected void	finishedDecoding() Notify that decoding is finished.
void	handlerRemoved(io.netty.channel.ChannelHandlerContext ctx)
protected static java.lang.String	logIdent(io.netty.channel.ChannelHandlerContext ctx, Endpoint endpoint) Simple log helper to give logs a common prefix.
protected void	publishResponse(CouchbaseResponse response, rx.subjects.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 java.nio.charset.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,
                      java.util.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(io.netty.channel.ChannelHandlerContext ctx,
                    REQUEST msg)
                                  throws java.lang.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:

java.lang.Exception - as a generic error.

decodeResponse

protected abstract CouchbaseResponse decodeResponse(io.netty.channel.ChannelHandlerContext ctx,
                               RESPONSE msg)
                                             throws java.lang.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:

java.lang.Exception - as a generic error.

encode

protected void encode(io.netty.channel.ChannelHandlerContext ctx,
          REQUEST msg,
          java.util.List<java.lang.Object> out)
               throws java.lang.Exception

Specified by:

encode in class io.netty.handler.codec.MessageToMessageCodec<RESPONSE,REQUEST extends CouchbaseRequest>

Throws:

java.lang.Exception

decode

protected void decode(io.netty.channel.ChannelHandlerContext ctx,
          RESPONSE msg,
          java.util.List<java.lang.Object> out)
               throws java.lang.Exception

Specified by:

decode in class io.netty.handler.codec.MessageToMessageCodec<RESPONSE,REQUEST extends CouchbaseRequest>

Throws:

java.lang.Exception

publishResponse

protected void publishResponse(CouchbaseResponse response,
                   rx.subjects.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(io.netty.channel.ChannelHandlerContext ctx)
                     throws java.lang.Exception

Specified by:

channelInactive in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelInactive in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

channelActive

public void channelActive(io.netty.channel.ChannelHandlerContext ctx)
                   throws java.lang.Exception

Specified by:

channelActive in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelActive in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

channelWritabilityChanged

public void channelWritabilityChanged(io.netty.channel.ChannelHandlerContext ctx)
                               throws java.lang.Exception

Specified by:

channelWritabilityChanged in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelWritabilityChanged in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

exceptionCaught

public void exceptionCaught(io.netty.channel.ChannelHandlerContext ctx,
                   java.lang.Throwable cause)
                     throws java.lang.Exception

Specified by:

exceptionCaught in interface io.netty.channel.ChannelHandler

Specified by:

exceptionCaught in interface io.netty.channel.ChannelInboundHandler

Overrides:

exceptionCaught in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

handlerRemoved

public void handlerRemoved(io.netty.channel.ChannelHandlerContext ctx)
                    throws java.lang.Exception

Specified by:

handlerRemoved in interface io.netty.channel.ChannelHandler

Overrides:

handlerRemoved in class io.netty.channel.ChannelHandlerAdapter

Throws:

java.lang.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 java.lang.String logIdent(io.netty.channel.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.