org.springframework.data.redis.serializer

Interface RedisSerializer<T>

All Known Implementing Classes:

GenericJackson2JsonRedisSerializer, GenericToStringSerializer, Jackson2JsonRedisSerializer, JdkSerializationRedisSerializer, OxmSerializer, StringRedisSerializer

public interface RedisSerializer<T>

Basic interface serialization and deserialization of Objects to byte arrays (binary data). It is recommended that implementations are designed to handle null objects/empty arrays on serialization and deserialization side. Note that Redis does not accept null keys or values but can return null replies (for non existing keys).

Author:

Mark Pollack, Costin Leau, Christoph Strobl

Method Summary

Modifier and Type	Method and Description
static RedisSerializer<byte[]>	byteArray() Obtain a RedisSerializer that passes thru byte[].
default boolean	canSerialize(Class<?> type)
T	deserialize(byte[] bytes) Deserialize an object from the given binary data.
default Class<?>	getTargetType()
static RedisSerializer<Object>	java() Obtain a RedisSerializer using java serialization.
static RedisSerializer<Object>	java(ClassLoader classLoader) Obtain a RedisSerializer using java serialization with the given ClassLoader.
static RedisSerializer<Object>	json() Obtain a RedisSerializer that can read and write JSON using Jackson.
byte[]	serialize(T t) Serialize the given object to binary data.
static RedisSerializer<String>	string() Obtain a simple String to byte[] (and back) serializer using UTF-8 as the default Charset.

Method Detail

serialize

@Nullable
byte[] serialize(@Nullable
                           T t)
                    throws SerializationException

Serialize the given object to binary data.

Parameters:

t - object to serialize. Can be null.

Returns:

the equivalent binary data. Can be null.

Throws:

SerializationException

deserialize

@Nullable
T deserialize(@Nullable
                        byte[] bytes)
                 throws SerializationException

Deserialize an object from the given binary data.

Parameters:

bytes - object binary representation. Can be null.

Returns:

the equivalent object instance. Can be null.

Throws:

SerializationException

java

static RedisSerializer<Object> java()

Obtain a RedisSerializer using java serialization.
Note: Ensure that your domain objects are actually serializable.

Returns:

never null.

Since:

2.1

java

static RedisSerializer<Object> java(@Nullable
                                    ClassLoader classLoader)

Obtain a RedisSerializer using java serialization with the given ClassLoader.
Note: Ensure that your domain objects are actually serializable.

Parameters:

classLoader - the ClassLoader to use for deserialization. Can be null.

Returns:

new instance of RedisSerializer. Never null.

Since:

2.1

json

static RedisSerializer<Object> json()

Obtain a RedisSerializer that can read and write JSON using Jackson.

Returns:

never null.

Since:

2.1

string

static RedisSerializer<String> string()

Obtain a simple String to byte[] (and back) serializer using UTF-8 as the default Charset.

Returns:

never null.

Since:

2.1

byteArray

static RedisSerializer<byte[]> byteArray()

Obtain a RedisSerializer that passes thru byte[].

Returns:

never null.

Since:

2.2

canSerialize

default boolean canSerialize(Class<?> type)

getTargetType

default Class<?> getTargetType()