org.opensaml.storage

Interface StorageSerializer<Type>

Type Parameters:

Type - the type of object handled

All Superinterfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.InitializableComponent

@ThreadSafeAfterInit
public interface StorageSerializer<Type>
extends net.shibboleth.utilities.java.support.component.InitializableComponent

Interface to a serialization/deserialization process used by a StorageService implementation to optimize the handling of complex objects.

Method Summary

Methods

Modifier and Type	Method and Description
Type	deserialize(long version, String context, String key, String value, Long expiration) Returns an object recovered from a string produced through the serialize(Type) method.
String	serialize(Type instance) Returns a string representing the input object.

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Method Detail

serialize

@Nonnull
@NotEmpty
String serialize(@Nonnull
                                Type instance)
                 throws IOException

Returns a string representing the input object.

Parameters:

instance - object to serialize

Returns:

a string

Throws:

IOException - if an error occurs during serialization

deserialize

@Nonnull
Type deserialize(long version,
                       @Nonnull@NotEmpty
                       String context,
                       @Nonnull@NotEmpty
                       String key,
                       @Nonnull@NotEmpty
                       String value,
                       @Nullable
                       Long expiration)
                 throws IOException

Returns an object recovered from a string produced through the serialize(Type) method.

Parameters:

version - record version

context - context of record

key - key of record

value - data to deserialize

expiration - expiration of record, if any

Returns:

a deserialized object

Throws:

IOException - if an error occurs during deserialization