@Internal public class RowDataSerializer extends AbstractRowDataSerializer<RowData>
RowData
.Modifier and Type | Class and Description |
---|---|
static class |
RowDataSerializer.RowDataSerializerSnapshot
|
Constructor and Description |
---|
RowDataSerializer(LogicalType... types) |
RowDataSerializer(LogicalType[] types,
TypeSerializer<?>[] fieldSerializers) |
RowDataSerializer(RowType rowType) |
Modifier and Type | Method and Description |
---|---|
void |
copy(DataInputView source,
DataOutputView target)
Copies exactly one record from the source input view to the target output view.
|
RowData |
copy(RowData from)
Creates a deep copy of the given element in a new element.
|
RowData |
copy(RowData from,
RowData reuse)
Creates a copy from the given element.
|
RowData |
createInstance()
Creates a new instance of the data type.
|
RowData |
deserialize(DataInputView source)
De-serializes a record from the given source input view.
|
RowData |
deserialize(RowData reuse,
DataInputView source)
De-serializes a record from the given source input view into the given reuse record instance
if mutable.
|
RowData |
deserializeFromPages(AbstractPagedInputView source)
De-serializes a record from the given source paged input view.
|
RowData |
deserializeFromPages(RowData reuse,
AbstractPagedInputView source)
Reuse version of
PagedTypeSerializer.deserializeFromPages(AbstractPagedInputView) . |
TypeSerializer<RowData> |
duplicate()
Creates a deep copy of this serializer if it is necessary, i.e. if it is stateful.
|
boolean |
equals(Object obj) |
int |
getArity()
Get the number of fields.
|
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.
|
RowData |
mapFromPages(RowData reuse,
AbstractPagedInputView source)
Map a reused record from the given source paged input view.
|
void |
serialize(RowData row,
DataOutputView target)
Serializes the given record to the given target output view.
|
int |
serializeToPages(RowData row,
AbstractPagedOutputView target)
Serializes the given record to the given target paged output view.
|
void |
skipRecordFromPages(AbstractPagedInputView source)
Skip over bytes of one record from the paged input view, discarding the skipped bytes.
|
TypeSerializerSnapshot<RowData> |
snapshotConfiguration()
Snapshots the configuration of this TypeSerializer.
|
BinaryRowData |
toBinaryRow(RowData row)
Convert
RowData into BinaryRowData . |
public RowDataSerializer(RowType rowType)
public RowDataSerializer(LogicalType... types)
public RowDataSerializer(LogicalType[] types, TypeSerializer<?>[] fieldSerializers)
public TypeSerializer<RowData> duplicate()
TypeSerializer
We need this because Serializers might be used in several threads. Stateless serializers are inherently thread-safe while stateful serializers might not be thread-safe.
duplicate
in class TypeSerializer<RowData>
public RowData createInstance()
TypeSerializer
createInstance
in class TypeSerializer<RowData>
public void serialize(RowData row, DataOutputView target) throws IOException
TypeSerializer
serialize
in class TypeSerializer<RowData>
row
- 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 RowData deserialize(DataInputView source) throws IOException
TypeSerializer
deserialize
in class TypeSerializer<RowData>
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 RowData deserialize(RowData reuse, DataInputView source) throws IOException
TypeSerializer
deserialize
in class TypeSerializer<RowData>
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 RowData copy(RowData from)
TypeSerializer
copy
in class TypeSerializer<RowData>
from
- The element reuse be copied.public RowData copy(RowData from, RowData reuse)
TypeSerializer
copy
in class TypeSerializer<RowData>
from
- The element to be copied.reuse
- The element to be reused. May or may not be used.public void copy(DataInputView source, DataOutputView target) throws IOException
TypeSerializer
target.write(source, 8);
.copy
in class TypeSerializer<RowData>
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 int getArity()
AbstractRowDataSerializer
getArity
in class AbstractRowDataSerializer<RowData>
public BinaryRowData toBinaryRow(RowData row)
RowData
into BinaryRowData
. TODO modify it to code gen.toBinaryRow
in class AbstractRowDataSerializer<RowData>
public int serializeToPages(RowData row, AbstractPagedOutputView target) throws IOException
PagedTypeSerializer
BinaryRowData
.serializeToPages
in class PagedTypeSerializer<RowData>
row
- 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 RowData deserializeFromPages(AbstractPagedInputView source) throws IOException
PagedTypeSerializer
BinaryRowData
. Typically, the content read from source should be copied out when
de-serializing, and we are not expecting the underlying data from source is reused. If you
have such requirement, see #mapFromPages(T, AbstractPagedInputView)
.deserializeFromPages
in class PagedTypeSerializer<RowData>
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 RowData deserializeFromPages(RowData reuse, AbstractPagedInputView source) throws IOException
PagedTypeSerializer
PagedTypeSerializer.deserializeFromPages(AbstractPagedInputView)
.deserializeFromPages
in class PagedTypeSerializer<RowData>
IOException
public RowData mapFromPages(RowData reuse, AbstractPagedInputView source) throws IOException
PagedTypeSerializer
If you choose the zero copy way, you have to deal with the lifecycle of the pages properly.
mapFromPages
in class PagedTypeSerializer<RowData>
reuse
- the reused record to be mappedsource
- 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 void skipRecordFromPages(AbstractPagedInputView source) throws IOException
PagedTypeSerializer
skipRecordFromPages
in class PagedTypeSerializer<RowData>
IOException
public boolean equals(Object obj)
equals
in class TypeSerializer<RowData>
public int hashCode()
hashCode
in class TypeSerializer<RowData>
public boolean isImmutableType()
TypeSerializer
isImmutableType
in class TypeSerializer<RowData>
public int getLength()
TypeSerializer
getLength
in class TypeSerializer<RowData>
-1
for variable length data types.public TypeSerializerSnapshot<RowData> 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<RowData>
null
).TypeSerializerSnapshot.resolveSchemaCompatibility(TypeSerializer)
Copyright © 2014–2024 The Apache Software Foundation. All rights reserved.