Package org.apache.flink.api.java.typeutils.runtime

Class NullableSerializer.NullableSerializerSnapshot<T>

java.lang.Object

org.apache.flink.api.common.typeutils.CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

org.apache.flink.api.java.typeutils.runtime.NullableSerializer.NullableSerializerSnapshot<T>

All Implemented Interfaces:

TypeSerializerSnapshot<T>

Enclosing class:

NullableSerializer<T>

public static class NullableSerializer.NullableSerializerSnapshot<T>
extends CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Snapshot for serializers of nullable types, containing the snapshot of its original serializer.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.flink.api.common.typeutils.CompositeTypeSerializerSnapshot

CompositeTypeSerializerSnapshot.OuterSchemaCompatibility

Constructor Summary

Constructors

Constructor	Description
NullableSerializerSnapshot()
NullableSerializerSnapshot(NullableSerializer<T> serializerInstance)

Method Summary

Modifier and Type	Method	Description
protected NullableSerializer<T>	createOuterSerializerWithNestedSerializers(TypeSerializer<?>[] nestedSerializers)	Creates an instance of the outer serializer with a given array of its nested serializers.
protected int	getCurrentOuterSnapshotVersion()	Returns the version of the current outer snapshot's written binary format.
protected TypeSerializer<?>[]	getNestedSerializers(NullableSerializer<T> outerSerializer)	Gets the nested serializers from the outer serializer.
protected void	readOuterSnapshot(int readOuterSnapshotVersion, DataInputView in, ClassLoader userCodeClassLoader)	Reads the outer snapshot, i.e.
protected CompositeTypeSerializerSnapshot.OuterSchemaCompatibility	resolveOuterSchemaCompatibility(TypeSerializerSnapshot<T> oldSerializerSnapshot)	Checks the schema compatibility of the given old serializer snapshot based on the outer snapshot.
protected void	writeOuterSnapshot(DataOutputView out)	Writes the outer snapshot, i.e.

Methods inherited from class org.apache.flink.api.common.typeutils.CompositeTypeSerializerSnapshot

getCurrentVersion, getNestedSerializerSnapshots, isOuterSnapshotCompatible, readSnapshot, resolveOuterSchemaCompatibility, resolveSchemaCompatibility, restoreSerializer, writeSnapshot

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.flink.api.common.typeutils.TypeSerializerSnapshot

resolveSchemaCompatibility

Constructor Detail

NullableSerializerSnapshot

public NullableSerializerSnapshot()

NullableSerializerSnapshot

public NullableSerializerSnapshot(NullableSerializer<T> serializerInstance)

Method Detail

getCurrentOuterSnapshotVersion

protected int getCurrentOuterSnapshotVersion()

Description copied from class: CompositeTypeSerializerSnapshot

Returns the version of the current outer snapshot's written binary format.

Specified by:

getCurrentOuterSnapshotVersion in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Returns:

the version of the current outer snapshot's written binary format.

getNestedSerializers

protected TypeSerializer<?>[] getNestedSerializers(NullableSerializer<T> outerSerializer)

Description copied from class: CompositeTypeSerializerSnapshot

Gets the nested serializers from the outer serializer.

Specified by:

getNestedSerializers in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Parameters:

outerSerializer - the outer serializer.

Returns:

the nested serializers.

createOuterSerializerWithNestedSerializers

protected NullableSerializer<T> createOuterSerializerWithNestedSerializers(TypeSerializer<?>[] nestedSerializers)

Description copied from class: CompositeTypeSerializerSnapshot

Creates an instance of the outer serializer with a given array of its nested serializers.

Specified by:

createOuterSerializerWithNestedSerializers in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Parameters:

nestedSerializers - array of nested serializers to create the outer serializer with.

Returns:

an instance of the outer serializer.

writeOuterSnapshot

protected void writeOuterSnapshot(DataOutputView out)
                           throws IOException

Description copied from class: CompositeTypeSerializerSnapshot

Writes the outer snapshot, i.e. any information beyond the nested serializers of the outer serializer.

The base implementation of this methods writes nothing, i.e. it assumes that the outer serializer only has nested serializers and no extra information. Otherwise, if the outer serializer contains some extra information that needs to be persisted as part of the serializer snapshot, this must be overridden. Note that this method and the corresponding methods CompositeTypeSerializerSnapshot.readOuterSnapshot(int, DataInputView, ClassLoader), CompositeTypeSerializerSnapshot.resolveOuterSchemaCompatibility(TypeSerializerSnapshot) needs to be implemented.

Overrides:

writeOuterSnapshot in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Parameters:

out - the DataOutputView to write the outer snapshot to.

Throws:

IOException

readOuterSnapshot

protected void readOuterSnapshot(int readOuterSnapshotVersion,
                                 DataInputView in,
                                 ClassLoader userCodeClassLoader)
                          throws IOException

Description copied from class: CompositeTypeSerializerSnapshot

Reads the outer snapshot, i.e. any information beyond the nested serializers of the outer serializer.

The base implementation of this methods reads nothing, i.e. it assumes that the outer serializer only has nested serializers and no extra information. Otherwise, if the outer serializer contains some extra information that has been persisted as part of the serializer snapshot, this must be overridden. Note that this method and the corresponding methods CompositeTypeSerializerSnapshot.writeOuterSnapshot(DataOutputView), CompositeTypeSerializerSnapshot.resolveOuterSchemaCompatibility(TypeSerializerSnapshot) needs to be implemented.

Overrides:

readOuterSnapshot in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Parameters:

readOuterSnapshotVersion - the read version of the outer snapshot.

in - the DataInputView to read the outer snapshot from.

userCodeClassLoader - the user code class loader.

Throws:

IOException

resolveOuterSchemaCompatibility

protected CompositeTypeSerializerSnapshot.OuterSchemaCompatibility resolveOuterSchemaCompatibility(TypeSerializerSnapshot<T> oldSerializerSnapshot)

Description copied from class: CompositeTypeSerializerSnapshot

Checks the schema compatibility of the given old serializer snapshot based on the outer snapshot.

The base implementation of this method assumes that the outer serializer only has nested serializers and no extra information, and therefore the result of the check is CompositeTypeSerializerSnapshot.OuterSchemaCompatibility.COMPATIBLE_AS_IS. Otherwise, if the outer serializer contains some extra information that has been persisted as part of the serializer snapshot, this must be overridden. Note that this method and the corresponding methods CompositeTypeSerializerSnapshot.writeOuterSnapshot(DataOutputView), CompositeTypeSerializerSnapshot.readOuterSnapshot(int, DataInputView, ClassLoader) needs to be implemented.

Overrides:

resolveOuterSchemaCompatibility in class CompositeTypeSerializerSnapshot<T,NullableSerializer<T>>

Parameters:

oldSerializerSnapshot - the old serializer snapshot, which contains the old outer information to check against.

Returns:

a CompositeTypeSerializerSnapshot.OuterSchemaCompatibility indicating whether the new serializer's outer information is compatible, requires migration, or incompatible with the one written in this snapshot.