XStreamSerializer
and
JacksonSerializer
, as direct Java serialization is relatively error
prone. We hence strongly encourage to use either the XStream or Jackson solution in favor of this Serializer
implementation.@Deprecated public class JavaSerializer extends Object implements Serializer
XStreamSerializer
might be a more suitable alternative.Modifier and Type | Class and Description |
---|---|
static class |
JavaSerializer.Builder
Deprecated.
Builder class to instantiate a
JavaSerializer . |
Modifier | Constructor and Description |
---|---|
protected |
JavaSerializer(JavaSerializer.Builder builder)
Deprecated.
Instantiate a
JavaSerializer based on the fields contained in the JavaSerializer.Builder . |
Modifier and Type | Method and Description |
---|---|
static JavaSerializer.Builder |
builder()
Deprecated.
Instantiate a Builder to be able to create a
JavaSerializer . |
<T> boolean |
canSerializeTo(Class<T> expectedRepresentation)
Deprecated.
Indicates whether this Serializer is capable of serializing to the given
expectedRepresentation . |
Class |
classForType(SerializedType type)
Deprecated.
Returns the class for the given type identifier.
|
<S,T> T |
deserialize(SerializedObject<S> serializedObject)
Deprecated.
Deserializes the first object read from the given
bytes . |
Converter |
getConverter()
Deprecated.
Returns the
Converter used by this Serializer to convert between serialized representations. |
<T> SerializedObject<T> |
serialize(Object instance,
Class<T> expectedType)
Deprecated.
Serialize the given
object into a Serialized Object containing the given
expectedRepresentation . |
SerializedType |
typeForClass(Class type)
Deprecated.
Returns the type identifier for the given class.
|
protected JavaSerializer(JavaSerializer.Builder builder)
JavaSerializer
based on the fields contained in the JavaSerializer.Builder
.builder
- the JavaSerializer.Builder
used to instantiate a JavaSerializer
instancepublic static JavaSerializer.Builder builder()
JavaSerializer
.
The RevisionResolver
is defaulted to an SerialVersionUIDRevisionResolver
.
JavaSerializer
public <T> SerializedObject<T> serialize(Object instance, @Nonnull Class<T> expectedType)
Serializer
object
into a Serialized Object containing the given
expectedRepresentation
.
Use Serializer.canSerializeTo(Class)
to detect whether the expectedRepresentation
is supported by
this serializer.serialize
in interface Serializer
T
- The expected data type representing the serialized objectinstance
- The object to serializeexpectedType
- The expected data type representing the serialized objectpublic <T> boolean canSerializeTo(@Nonnull Class<T> expectedRepresentation)
Serializer
expectedRepresentation
.
When true
, this does *not* guarantee that the serialization and (optional) conversion will also
succeed when executed. For example, when a serializer produces a byte[]
containing JSON, trying to
convert to a Dom4J Document will fail, even though this serializer has a converter to convert
byte[]
to Dom4J instances.canSerializeTo
in interface Serializer
T
- The type of data a Serialized Object should containexpectedRepresentation
- The type of data a Serialized Object should containtrue
if the expectedRepresentation
is supported, otherwise false
.public <S,T> T deserialize(@Nonnull SerializedObject<S> serializedObject)
Serializer
bytes
. The bytes
are not consumed
from the array or modified in any way. The resulting object instance is cast to the expected type.deserialize
in interface Serializer
S
- The data type of the serialized objectT
- The expected deserialized typeserializedObject
- the instance describing the type of object and the bytes providing the serialized datapublic Class classForType(@Nonnull SerializedType type)
Serializer
type
is an instance of the returned Class.
If a class cannot be resolved (i.e. because the class is not available on this JVM's classpath) this method
returns an UnknownSerializedType
instance which proides access to the raw underlying data.classForType
in interface Serializer
type
- The type identifier of the objectpublic SerializedType typeForClass(Class type)
Serializer
Serializer.serialize(Object, Class)
.typeForClass
in interface Serializer
type
- Class representing the type of the serializable Object.public Converter getConverter()
Serializer
Converter
used by this Serializer to convert between serialized representations. Generally,
this Converter depends on the type of data the serializer serializes to.getConverter
in interface Serializer
Copyright © 2010–2023. All rights reserved.