Class GenericJacksonJsonRedisSerializer

java.lang.Object

org.springframework.data.redis.serializer.GenericJacksonJsonRedisSerializer

All Implemented Interfaces:

RedisJsonSerializer, RedisSerializer<Object>

public class GenericJacksonJsonRedisSerializer
extends Object
implements RedisJsonSerializer

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, Moritz Halbritter

See Also:

• JacksonObjectReader
• JacksonObjectWriter
• ObjectMapper

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder<B extends MapperBuilder<? extends ObjectMapper, ? extends 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(ObjectMapper mapper)	Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper.
protected	GenericJacksonJsonRedisSerializer(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<JsonMapper.Builder>	builder()	Creates a new GenericJacksonJsonRedisSerializer.GenericJacksonJsonRedisSerializerBuilder to configure and build a GenericJacksonJsonRedisSerializer using JsonMapper.
static <B extends MapperBuilder<? extends ObjectMapper, ? extends 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<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.
@Nullable Object	deserialize(byte @Nullable [] source, ResolvableType type)	Deserialize the given source into an instance of the type described by ResolvableType.
protected 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 RedisJsonSerializer

deserialize

Methods inherited from interface RedisSerializer

canSerialize, getTargetType

Constructor Details

GenericJacksonJsonRedisSerializer

public GenericJacksonJsonRedisSerializer(ObjectMapper mapper)

Create a GenericJacksonJsonRedisSerializer with a custom-configured ObjectMapper.

Parameters:

mapper - must not be null.

GenericJacksonJsonRedisSerializer

protected GenericJacksonJsonRedisSerializer(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<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<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 MapperBuilder<? extends ObjectMapper, ? extends 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.

Specified by:

deserialize in interface RedisSerializer<Object>

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

deserialize

public @Nullable Object deserialize(byte @Nullable [] source,
 ResolvableType type)
                             throws SerializationException

Description copied from interface: RedisJsonSerializer

Deserialize the given source into an instance of the type described by ResolvableType. Use this variant for generic types such as List<Person> that cannot be expressed as a Class.

Specified by:

deserialize in interface RedisJsonSerializer

Parameters:

source - the JSON representation to read.

type - reference describing the target type.

Returns:

the deserialized object, or null if source is empty or represents JSON null.

Throws:

SerializationException - if the JSON cannot be deserialized.

resolveType

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

Throws:

IOException