Class GenericJacksonJsonRedisSerializer

java.lang.Object

org.springframework.data.redis.serializer.GenericJacksonJsonRedisSerializer

All Implemented Interfaces:

RedisSerializer<Object>

public class GenericJacksonJsonRedisSerializer
extends Object
implements RedisSerializer<Object>

Generic Jackson 3-based RedisSerializer that maps objects to and from JSON.

JSON reading and writing can be customized by configuring a JacksonObjectReader and JacksonObjectWriter.

Since:

4.0

Author:

Christoph Strobl

See Also:

• JacksonObjectReader
• JacksonObjectWriter
• ObjectMapper

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<B extends tools.jackson.databind.cfg.MapperBuilder<? extends tools.jackson.databind.ObjectMapper, ? extends tools.jackson.databind.cfg.MapperBuilder<?,?>>>	GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder wraps around a JsonMapper.Builder providing dedicated methods to configure aspects like NullValue serialization strategy for the resulting ObjectMapper to be used with GenericJacksonJsonRedisSerializer as well as potential Object/-reader and -writer settings.

Constructor Summary

Constructors

Modifier	Constructor	Description
	GenericJacksonJsonRedisSerializer(tools.jackson.databind.ObjectMapper mapper)	Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper.
protected	GenericJacksonJsonRedisSerializer(tools.jackson.databind.ObjectMapper mapper, JacksonObjectReader reader, JacksonObjectWriter writer)	Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper considering potential Object/-reader and -writer.

Method Summary

Modifier and Type	Method	Description
static GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<tools.jackson.databind.json.JsonMapper.Builder>	builder()	Creates a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder to configure and build a GenericJacksonJsonRedisSerializer using JsonMapper.
static <B extends tools.jackson.databind.cfg.MapperBuilder<? extends tools.jackson.databind.ObjectMapper, ? extends tools.jackson.databind.cfg.MapperBuilder<?,?>>> GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<B>	builder(Supplier<B> builderFactory)	Creates a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder to configure and build a GenericJacksonJsonRedisSerializer.
static GenericJacksonJsonRedisSerializer	create(Consumer<GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<tools.jackson.databind.json.JsonMapper.Builder>> configurer)	Prepare a new GenericJacksonJsonRedisSerializer instance.
@Nullable Object	deserialize(byte @Nullable [] source)	Deserialize an object from the given binary data.
<T> @Nullable T	deserialize(byte @Nullable [] source, Class<T> type)	Deserialized the array of bytes containing JSON as an Object of the given, required type.
protected tools.jackson.databind.JavaType	resolveType(byte[] source, Class<?> type)
byte[]	serialize(@Nullable Object value)	Serialize the given object to binary data.

Methods inherited from class Object

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

Methods inherited from interface RedisSerializer

canSerialize, getTargetType

Constructor Details

GenericJacksonJsonRedisSerializer

public GenericJacksonJsonRedisSerializer(tools.jackson.databind.ObjectMapper mapper)

Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper.

Parameters:

mapper - must not be null.

GenericJacksonJsonRedisSerializer

protected GenericJacksonJsonRedisSerializer(tools.jackson.databind.ObjectMapper mapper,
 JacksonObjectReader reader,
 JacksonObjectWriter writer)

Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper considering potential Object/-reader and -writer.

Parameters:

mapper - must not be null.

reader - the JacksonObjectReader function to read objects using ObjectMapper.

writer - the JacksonObjectWriter function to write objects using ObjectMapper.

Method Details

create

public static GenericJacksonJsonRedisSerializer create(Consumer<GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<tools.jackson.databind.json.JsonMapper.Builder>> configurer)

Prepare a new GenericJacksonJsonRedisSerializer instance.

Parameters:

configurer - the configurer for GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder.

Returns:

new instance of GenericJacksonJsonRedisSerializer.

builder

public static GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<tools.jackson.databind.json.JsonMapper.Builder> builder()

Creates a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder to configure and build a GenericJacksonJsonRedisSerializer using JsonMapper.

Returns:

a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder.

builder

public static <B extends tools.jackson.databind.cfg.MapperBuilder<? extends tools.jackson.databind.ObjectMapper, ? extends tools.jackson.databind.cfg.MapperBuilder<?,?>>>
GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<B> builder(Supplier<B> builderFactory)

Creates a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder to configure and build a GenericJacksonJsonRedisSerializer.

Type Parameters:

B - type of the MapperBuilder to use.

Parameters:

builderFactory - factory to create a MapperBuilder for the ObjectMapper.

Returns:

a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder.

serialize

@Contract("_ -> !null")
public byte[] serialize(@Nullable Object value)
                 throws SerializationException

Description copied from interface: RedisSerializer

Serialize the given object to binary data.

Specified by:

serialize in interface RedisSerializer<Object>

Parameters:

value - object to serialize. Can be null.

Returns:

the equivalent binary data. Can be an empty array but never null.

Throws:

SerializationException

deserialize

@Contract("null -> null")
public @Nullable Object deserialize(byte @Nullable [] source)
                             throws SerializationException

Description copied from interface: RedisSerializer

Deserialize an object from the given binary data.

Specified by:

deserialize in interface RedisSerializer<Object>

Parameters:

source - object binary representation. Can be null.

Returns:

the equivalent object instance. Can be null.

Throws:

SerializationException

deserialize

@Contract("null, _ -> null")
public <T> @Nullable T deserialize(byte @Nullable [] source,
 Class<T> type)
                            throws SerializationException

Deserialized the array of bytes containing JSON as an Object of the given, required type.

Parameters:

source - array of bytes containing the JSON to deserialize; can be null.

type - type of Object from which the JSON will be deserialized; must not be null.

Returns:

null for an empty source, or an Object of the given type deserialized from the array of bytes containing JSON.

Throws:

IllegalArgumentException - if the given type is null.

SerializationException - if the array of bytes cannot be deserialized as an instance of the given type

resolveType

protected tools.jackson.databind.JavaType resolveType(byte[] source,
 Class<?> type)
                                               throws IOException

Throws:

IOException