org.apache.flink.table.runtime.typeutils

Class AbstractRowDataSerializer<T extends RowData>

java.lang.Object

org.apache.flink.api.common.typeutils.TypeSerializer<T>

org.apache.flink.table.runtime.typeutils.AbstractRowDataSerializer<T>

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BinaryRowDataSerializer, RowDataSerializer

@Internal
public abstract class AbstractRowDataSerializer<T extends RowData>
extends TypeSerializer<T>

Row serializer, provided paged serialize paged method.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractRowDataSerializer()

Method Summary

Modifier and Type	Method and Description
abstract T	deserializeFromPages(AbstractPagedInputView source) De-serializes a record from the given source paged input view.
abstract T	deserializeFromPages(T reuse, AbstractPagedInputView source) Reuse version of deserializeFromPages(AbstractPagedInputView).
abstract int	getArity() Get the number of fields.
abstract T	mapFromPages(AbstractPagedInputView source) Map a record from the given source paged input view.
abstract T	mapFromPages(T reuse, AbstractPagedInputView source) Reuse version of mapFromPages(AbstractPagedInputView).
abstract int	serializeToPages(T record, AbstractPagedOutputView target) Serializes the given record to the given target paged output view.
abstract BinaryRowData	toBinaryRow(T rowData) Convert a RowData to a BinaryRowData.

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

copy, copy, copy, createInstance, deserialize, deserialize, duplicate, equals, getLength, hashCode, isImmutableType, serialize, snapshotConfiguration

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRowDataSerializer

public AbstractRowDataSerializer()

Method Detail

getArity

public abstract int getArity()

Get the number of fields.

toBinaryRow

public abstract BinaryRowData toBinaryRow(T rowData)
                                   throws IOException

Convert a RowData to a BinaryRowData.

Throws:

IOException

serializeToPages

public abstract int serializeToPages(T record,
                                     AbstractPagedOutputView target)
                              throws IOException

Serializes the given record to the given target paged output view. Some implementations may skip some bytes if current page does not have enough space left, .e.g BinaryRowData.

Parameters:

record - The record to serialize.

target - The output view to write the serialized data to.

Returns:

Returns the skipped number of bytes.

Throws:

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.

deserializeFromPages

public abstract T deserializeFromPages(AbstractPagedInputView source)
                                throws IOException

De-serializes a record from the given source paged input view. For consistency with serialize format, some implementations may need to skip some bytes of source before de-serializing, .e.g 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(AbstractPagedInputView).

Parameters:

source - The input view from which to read the data.

Returns:

The de-serialized element.

Throws:

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.

deserializeFromPages

public abstract T deserializeFromPages(T reuse,
                                       AbstractPagedInputView source)
                                throws IOException

Reuse version of deserializeFromPages(AbstractPagedInputView).

Throws:

IOException

mapFromPages

public abstract T mapFromPages(AbstractPagedInputView source)
                        throws IOException

Map a record from the given source paged input view. This method provides a possibility to achieve zero copy when de-serializing. You can either choose copy or not copy the content read from source, but we encourage to make it zero copy.

If you choose the zero copy way, you have to deal with the lifecycle of the pages properly.

Parameters:

source - The input view from which to read the data.

Returns:

The mapped element.

Throws:

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.

mapFromPages

public abstract T mapFromPages(T reuse,
                               AbstractPagedInputView source)
                        throws IOException

Reuse version of mapFromPages(AbstractPagedInputView).

Throws:

IOException