com.couchbase.client.java.transcoder

Class AbstractTranscoder<D extends Document<T>,T>

java.lang.Object

com.couchbase.client.java.transcoder.AbstractTranscoder<D,T>

All Implemented Interfaces:

Transcoder<D,T>

Direct Known Subclasses:

BinaryTranscoder, JsonArrayTranscoder, JsonBooleanTranscoder, JsonDoubleTranscoder, JsonLongTranscoder, JsonStringTranscoder, JsonTranscoder, LegacyTranscoder, RawJsonTranscoder, SerializableTranscoder, StringTranscoder

public abstract class AbstractTranscoder<D extends Document<T>,T>
extends java.lang.Object
implements Transcoder<D,T>

Base Transcoder which should be extended for compatibility.

Since:

2.0

Constructor Summary

Constructors

Constructor and Description
AbstractTranscoder()

Method Summary

Methods

Modifier and Type	Method and Description
D	decode(java.lang.String id, com.couchbase.client.deps.io.netty.buffer.ByteBuf content, long cas, int expiry, int flags, com.couchbase.client.core.message.ResponseStatus status)
protected abstract D	doDecode(java.lang.String id, com.couchbase.client.deps.io.netty.buffer.ByteBuf content, long cas, int expiry, int flags, com.couchbase.client.core.message.ResponseStatus status) Perform the decoding of the received response.
protected abstract com.couchbase.client.core.lang.Tuple2<com.couchbase.client.deps.io.netty.buffer.ByteBuf,java.lang.Integer>	doEncode(D document) Perform the encoding of the request document.
com.couchbase.client.core.lang.Tuple2<com.couchbase.client.deps.io.netty.buffer.ByteBuf,java.lang.Integer>	encode(D document)
protected boolean	shouldAutoReleaseOnDecode() Flag method to auto release decoded buffers.
protected boolean	shouldAutoReleaseOnError() Flag method to auto release buffers on decoding error.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.couchbase.client.java.transcoder.Transcoder

documentType, newDocument

Constructor Detail

AbstractTranscoder

public AbstractTranscoder()

Method Detail

decode

public D decode(java.lang.String id,
       com.couchbase.client.deps.io.netty.buffer.ByteBuf content,
       long cas,
       int expiry,
       int flags,
       com.couchbase.client.core.message.ResponseStatus status)

Specified by:

decode in interface Transcoder<D extends Document<T>,T>

encode

public com.couchbase.client.core.lang.Tuple2<com.couchbase.client.deps.io.netty.buffer.ByteBuf,java.lang.Integer> encode(D document)

Specified by:

encode in interface Transcoder<D extends Document<T>,T>

doDecode

protected abstract D doDecode(java.lang.String id,
         com.couchbase.client.deps.io.netty.buffer.ByteBuf content,
         long cas,
         int expiry,
         int flags,
         com.couchbase.client.core.message.ResponseStatus status)
                                           throws java.lang.Exception

Perform the decoding of the received response.

Parameters:

id - the id of the document.

content - the encoded content of the document.

cas - the cas value of the document.

expiry - the expiration time of the document.

flags - the flags set on the document.

status - the response status.

Returns:

the decoded document.

Throws:

java.lang.Exception - if something goes wrong during the decode process.

doEncode

protected abstract com.couchbase.client.core.lang.Tuple2<com.couchbase.client.deps.io.netty.buffer.ByteBuf,java.lang.Integer> doEncode(D document)
                                                                                                                                throws java.lang.Exception

Perform the encoding of the request document.

Parameters:

document - the document to encode.

Returns:

A tuple consisting of the encoded content and the flags to set.

Throws:

java.lang.Exception - if something goes wrong during the encode process.

shouldAutoReleaseOnDecode

protected boolean shouldAutoReleaseOnDecode()

Flag method to auto release decoded buffers. Override to change default behaviour (true).

Returns:

true if the ByteBuf passed to decode method is to be released automatically on success (default behaviour)

shouldAutoReleaseOnError

protected boolean shouldAutoReleaseOnError()

Flag method to auto release buffers on decoding error. Override to change default behaviour (true).

Returns:

true if the ByteBuf passed to decode method is to be released automatically in case of error (default behaviour)