com.couchbase.client.java.transcoder.subdoc

Class JacksonFragmentTranscoder

java.lang.Object

com.couchbase.client.java.transcoder.subdoc.AbstractFragmentTranscoder

com.couchbase.client.java.transcoder.subdoc.JacksonFragmentTranscoder

All Implemented Interfaces:

FragmentTranscoder

@InterfaceStability.Uncommitted
 @InterfaceAudience.Private
public class JacksonFragmentTranscoder
extends AbstractFragmentTranscoder

A Jackson-based implementation of a FragmentTranscoder, based on AbstractFragmentTranscoder.

Care should be taken to not use Jackson specific annotations if you want to be able to easily swap this for another SubdocumentTranscoder implementation at a later time.

Since:

2.2

Author:

Simon Baslé

Constructor Summary

Constructors

Constructor and Description
JacksonFragmentTranscoder(com.couchbase.client.deps.com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Summary

Modifier and Type	Method and Description
<T> T	decodeWithMessage(com.couchbase.client.deps.io.netty.buffer.ByteBuf encoded, Class<? extends T> clazz, String transcodingErrorMessage) Decode content in a ByteBuf without releasing it.
protected com.couchbase.client.deps.io.netty.buffer.ByteBuf	doEncodeMulti(MultiValue<?> multiValue, String transcodingErrorMessage) Encode a special mutation value that denotes multiple values being processed in bulk, to a ByteBuf suitable for use in the sub-document protocol.
protected <T> com.couchbase.client.deps.io.netty.buffer.ByteBuf	doEncodeSingle(T value, String transcodingErrorMessage) Encode a single mutation value to a ByteBuf suitable for use in the sub-document protocol.

Methods inherited from class com.couchbase.client.java.transcoder.subdoc.AbstractFragmentTranscoder

decode, encode, encodeWithMessage

Methods inherited from class java.lang.Object

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

Constructor Detail

JacksonFragmentTranscoder

public JacksonFragmentTranscoder(com.couchbase.client.deps.com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Detail

decodeWithMessage

public <T> T decodeWithMessage(com.couchbase.client.deps.io.netty.buffer.ByteBuf encoded,
                               Class<? extends T> clazz,
                               String transcodingErrorMessage)
                        throws TranscodingException

Description copied from interface: FragmentTranscoder

Decode content in a ByteBuf without releasing it. Suitable for populating a DocumentFragment’s content.

Parameters:

encoded - the encoded fragment value (will not be released).

clazz - the target class for decoded value. Using Object.class implies a generic decode, where dictionaries are represented by JsonObject and arrays by JsonArray.

transcodingErrorMessage - the error message to be used in the thrown TranscodingException if the decoding couldn’t happen.

Returns:

a decoded fragment.

Throws:

TranscodingException - if the decoding couldn’t happen.

doEncodeSingle

protected <T> com.couchbase.client.deps.io.netty.buffer.ByteBuf doEncodeSingle(T value,
                                                                               String transcodingErrorMessage)
                                                                        throws TranscodingException

Description copied from class: AbstractFragmentTranscoder

Encode a single mutation value to a ByteBuf suitable for use in the sub-document protocol.

Specified by:

doEncodeSingle in class AbstractFragmentTranscoder

Parameters:

value - the value to encode.

transcodingErrorMessage - the error message to be used in the thrown TranscodingException if the encoding couldn’t happen.

Returns:

a ByteBuf representation of the fragment value.

Throws:

TranscodingException - if the encoding couldn’t happen.

doEncodeMulti

protected com.couchbase.client.deps.io.netty.buffer.ByteBuf doEncodeMulti(MultiValue<?> multiValue,
                                                                          String transcodingErrorMessage)
                                                                   throws TranscodingException

Description copied from class: AbstractFragmentTranscoder

Encode a special mutation value that denotes multiple values being processed in bulk, to a ByteBuf suitable for use in the sub-document protocol.

Specified by:

doEncodeMulti in class AbstractFragmentTranscoder

Parameters:

multiValue - the multivalue to encode.

transcodingErrorMessage - the error message to be used in the thrown TranscodingException if the encoding couldn’t happen.

Returns:

a ByteBuf representation of the fragment multivalue.

Throws:

TranscodingException - if the encoding couldn’t happen.