com.couchbase.client.java.codec

Class JacksonJsonSerializer

java.lang.Object

com.couchbase.client.java.codec.JacksonJsonSerializer

All Implemented Interfaces:

JsonSerializer

public class JacksonJsonSerializer
extends Object
implements JsonSerializer

A serializer backed by a user-provided Jackson ObjectMapper.

In order to use this class you must add Jackson to your class path.

Make sure to register JsonValueModule with your ObjectMapper so it can handle Couchbase JsonObject instances.

Likewise, if you're using the Encrypted annotation for Couchbase Field-Level Encryption, make sure to register EncryptionModule.

Example usage without Couchbase Field-Level Encryption:

 ObjectMapper mapper = new ObjectMapper();
 mapper.registerModule(new JsonValueModule());

 ClusterEnvironment env = ClusterEnvironment.builder()
     .jsonSerializer(new JacksonJsonSerializer(mapper))
     .build();
 

Example usage with Couchbase Field-Level Encryption:

 CryptoManager cryptoManager = ...

 ObjectMapper mapper = new ObjectMapper();
 mapper.registerModule(new JsonValueModule());
 mapper.registerModule(new EncryptionModule(cryptoManager));

 ClusterEnvironment env = ClusterEnvironment.builder()
     .cryptoManager(cryptoManager)
     .jsonSerializer(new JacksonJsonSerializer(mapper))
     .build();
 

See Also:

JsonValueModule, EncryptionModule

Method Summary

Modifier and Type	Method and Description
static JacksonJsonSerializer	create() Returns a new instance backed by a default ObjectMapper without encryption support.
static JacksonJsonSerializer	create(CryptoManager cryptoManager) Returns a new instance backed by a default ObjectMapper with optional encryption support.
static JacksonJsonSerializer	create(com.fasterxml.jackson.databind.ObjectMapper mapper) Returns a new instance backed by a the given ObjectMapper.
<T> T	deserialize(Class<T> target, byte[] input) Deserializes raw input into the target class.
<T> T	deserialize(TypeRef<T> target, byte[] input) Deserializes raw input into the target type.
byte[]	serialize(Object input) Serializes the given input into its encoded byte array form.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static JacksonJsonSerializer create(com.fasterxml.jackson.databind.ObjectMapper mapper)

Returns a new instance backed by a the given ObjectMapper.

create

public static JacksonJsonSerializer create()

Returns a new instance backed by a default ObjectMapper without encryption support.

create

public static JacksonJsonSerializer create(CryptoManager cryptoManager)

Returns a new instance backed by a default ObjectMapper with optional encryption support.

Parameters:

cryptoManager - (nullable) The manager to use for activating the Encrypted annotation, or null to disable encryption support.

serialize

public byte[] serialize(Object input)

Description copied from interface: JsonSerializer

Serializes the given input into its encoded byte array form.

Specified by:

serialize in interface JsonSerializer

Parameters:

input - the object as input.

Returns:

the serialized output.

deserialize

public <T> T deserialize(Class<T> target,
                         byte[] input)

Description copied from interface: JsonSerializer

Deserializes raw input into the target class.

Specified by:

deserialize in interface JsonSerializer

Type Parameters:

T - the generic type to deserialize into.

Parameters:

target - the target class.

input - the raw input.

Returns:

the deserialized output.

deserialize

public <T> T deserialize(TypeRef<T> target,
                         byte[] input)

Description copied from interface: JsonSerializer

Deserializes raw input into the target type.

Specified by:

deserialize in interface JsonSerializer

Type Parameters:

T - the type to deserialize into.

Parameters:

target - the target type.

input - the raw input.

Returns:

the deserialized output.