T
- The data type that the deserializer deserializes.@Internal public final class TypeDeserializerAdapter<T> extends TypeSerializer<T> implements TypeDeserializer<T>
TypeSerializer
and TypeDeserializer
.
It either wraps a type deserializer or serializer, and can only ever be used for deserialization
(i.e. only read-related methods is functional).
Methods related to deserialization are directly forwarded to the wrapped deserializer or serializer, while serialization methods are masked and not intended for use.
Constructor and Description |
---|
TypeDeserializerAdapter(TypeDeserializer<T> deserializer)
Creates a
TypeDeserializerAdapter that wraps a TypeDeserializer . |
TypeDeserializerAdapter(TypeSerializer<T> serializer)
Creates a
TypeDeserializerAdapter that wraps a TypeSerializer . |
Modifier and Type | Method and Description |
---|---|
boolean |
canEqual(Object obj)
Returns true if the given object can be equaled with this object.
|
void |
copy(DataInputView source,
DataOutputView target)
Copies exactly one record from the source input view to the target output view.
|
T |
copy(T from)
Creates a deep copy of the given element in a new element.
|
T |
copy(T from,
T reuse)
Creates a copy from the given element.
|
T |
createInstance()
Creates a new instance of the data type.
|
T |
deserialize(DataInputView source)
De-serializes a record from the given source input view.
|
T |
deserialize(T reuse,
DataInputView source)
De-serializes a record from the given source input view into the given reuse record instance if mutable.
|
TypeSerializer<T> |
duplicate()
Creates a deep copy of this serializer if it is necessary, i.e.
|
CompatibilityResult<T> |
ensureCompatibility(TypeSerializerConfigSnapshot<?> configSnapshot)
This method is deprecated.
|
boolean |
equals(Object obj) |
int |
getLength()
Gets the length of the data type, if it is a fix length data type.
|
int |
hashCode() |
boolean |
isImmutableType()
Gets whether the type is an immutable type.
|
void |
serialize(T record,
DataOutputView target)
Serializes the given record to the given target output view.
|
TypeSerializerConfigSnapshot<T> |
snapshotConfiguration()
Snapshots the configuration of this TypeSerializer.
|
public TypeDeserializerAdapter(TypeDeserializer<T> deserializer)
TypeDeserializerAdapter
that wraps a TypeDeserializer
.deserializer
- the actual deserializer to wrap.public TypeDeserializerAdapter(TypeSerializer<T> serializer)
TypeDeserializerAdapter
that wraps a TypeSerializer
.serializer
- the actual serializer to wrap.public T deserialize(DataInputView source) throws IOException
TypeSerializer
deserialize
in interface TypeDeserializer<T>
deserialize
in class TypeSerializer<T>
source
- The input view from which to read the data.IOException
- Thrown, if the de-serialization encountered an I/O related error. Typically raised by the
input view, which may have an underlying I/O channel from which it reads.public T deserialize(T reuse, DataInputView source) throws IOException
TypeSerializer
deserialize
in interface TypeDeserializer<T>
deserialize
in class TypeSerializer<T>
reuse
- The record instance into which to de-serialize the data.source
- The input view from which to read the data.IOException
- Thrown, if the de-serialization encountered an I/O related error. Typically raised by the
input view, which may have an underlying I/O channel from which it reads.public TypeSerializer<T> duplicate()
TypeSerializer
duplicate
in interface TypeDeserializer<T>
duplicate
in class TypeSerializer<T>
public int getLength()
TypeSerializer
getLength
in interface TypeDeserializer<T>
getLength
in class TypeSerializer<T>
-1
for variable length data types.public boolean equals(Object obj)
equals
in interface TypeDeserializer<T>
equals
in class TypeSerializer<T>
public boolean canEqual(Object obj)
TypeSerializer
canEqual
in interface TypeDeserializer<T>
canEqual
in class TypeSerializer<T>
obj
- Object which wants to take part in the equality relationpublic int hashCode()
hashCode
in interface TypeDeserializer<T>
hashCode
in class TypeSerializer<T>
public boolean isImmutableType()
TypeSerializer
isImmutableType
in class TypeSerializer<T>
public T createInstance()
TypeSerializer
createInstance
in class TypeSerializer<T>
public T copy(T from)
TypeSerializer
copy
in class TypeSerializer<T>
from
- The element reuse be copied.public T copy(T from, T reuse)
TypeSerializer
copy
in class TypeSerializer<T>
from
- The element to be copied.reuse
- The element to be reused. May or may not be used.public void serialize(T record, DataOutputView target) throws IOException
TypeSerializer
serialize
in class TypeSerializer<T>
record
- The record to serialize.target
- The output view to write the serialized data to.IOException
- Thrown, if the serialization encountered an I/O related error. Typically raised by the
output view, which may have an underlying I/O channel to which it delegates.public void copy(DataInputView source, DataOutputView target) throws IOException
TypeSerializer
target.write(source, 8);
.copy
in class TypeSerializer<T>
source
- The input view from which to read the record.target
- The target output view to which to write the record.IOException
- Thrown if any of the two views raises an exception.public TypeSerializerConfigSnapshot<T> snapshotConfiguration()
TypeSerializer
The snapshot of the TypeSerializer is supposed to contain all information that affects the serialization format of the serializer. The snapshot serves two purposes: First, to reproduce the serializer when the checkpoint/savepoint is restored, and second, to check whether the serialization format is compatible with the serializer used in the restored program.
IMPORTANT: TypeSerializerSnapshots changed after Flink 1.6. Serializers implemented against Flink versions up to 1.6 should still work, but adjust to new model to enable state evolution and be future-proof. See the class-level comments, section "Upgrading TypeSerializers to the new TypeSerializerSnapshot model" for details.
snapshotConfiguration
in class TypeSerializer<T>
null
).TypeSerializerSnapshot.resolveSchemaCompatibility(TypeSerializer)
public CompatibilityResult<T> ensureCompatibility(TypeSerializerConfigSnapshot<?> configSnapshot)
TypeSerializer
TypeSerializerSnapshot.resolveSchemaCompatibility(TypeSerializer)
.
New serializers should not override this method any more! Serializers implemented against Flink versions up to 1.6 should still work, but should adjust to new model to enable state evolution and be future-proof. See the class-level comments, section "Upgrading TypeSerializers to the new TypeSerializerSnapshot model" for details.
ensureCompatibility
in class TypeSerializer<T>
Copyright © 2014–2020 The Apache Software Foundation. All rights reserved.