io.debezium.data

Class Envelope

java.lang.Object

io.debezium.data.Envelope

public final class Envelope
extends Object

An immutable descriptor for the structure of Debezium message envelopes. An Envelope can be created for each message schema using the defineSchema() builder, and once created can generate Struct objects representing CREATE, READ, UPDATE, and DELETE messages that conform to that schema.

Author:

Randall Hauch

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Envelope.Builder A builder of an envelope schema.
static class	Envelope.FieldName The constants for the names of the fields in the message envelope.
static class	Envelope.Operation The constants for the values for the operation field in the message envelope.

Field Summary

Fields

Modifier and Type	Field and Description
static Set<String>	ALL_FIELD_NAMES The immutable set of all Envelope.FieldNames.
static boolean	OPERATION_REQUIRED Flag that specifies whether the Envelope.FieldName.OPERATION field is required within the envelope.
private org.apache.kafka.connect.data.Schema	schema
static int	VERSION Flag that specifies whether the Envelope.FieldName.OPERATION field is required within the envelope.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Envelope(org.apache.kafka.connect.data.Schema schema)

Method Summary

Modifier and Type	Method and Description
org.apache.kafka.connect.data.Struct	create(org.apache.kafka.connect.data.Struct record, org.apache.kafka.connect.data.Struct source, Long timestamp) Generate a read message with the given information.
static Envelope.Builder	defineSchema()
org.apache.kafka.connect.data.Struct	delete(org.apache.kafka.connect.data.Struct before, org.apache.kafka.connect.data.Struct source, Long timestamp) Generate an delete message with the given information.
static Envelope.Operation	operationFor(org.apache.kafka.connect.source.SourceRecord record) Obtain the operation for the given source record.
org.apache.kafka.connect.data.Struct	read(org.apache.kafka.connect.data.Struct record, org.apache.kafka.connect.data.Struct source, Long timestamp) Generate a read message with the given information.
org.apache.kafka.connect.data.Schema	schema() Get the Schema describing the message envelopes and their content.
org.apache.kafka.connect.data.Struct	update(org.apache.kafka.connect.data.Struct before, org.apache.kafka.connect.data.Struct after, org.apache.kafka.connect.data.Struct source, Long timestamp) Generate an update message with the given information.

Methods inherited from class java.lang.Object

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

Field Detail

VERSION

public static final int VERSION

Flag that specifies whether the Envelope.FieldName.OPERATION field is required within the envelope.

See Also:

Constant Field Values

OPERATION_REQUIRED

public static final boolean OPERATION_REQUIRED

Flag that specifies whether the Envelope.FieldName.OPERATION field is required within the envelope.

See Also:

Constant Field Values

ALL_FIELD_NAMES

public static final Set<String> ALL_FIELD_NAMES

The immutable set of all Envelope.FieldNames.

schema

private final org.apache.kafka.connect.data.Schema schema

Constructor Detail

Envelope

private Envelope(org.apache.kafka.connect.data.Schema schema)

Method Detail

defineSchema

public static Envelope.Builder defineSchema()

schema

public org.apache.kafka.connect.data.Schema schema()

Get the Schema describing the message envelopes and their content.

Returns:

the schema; never null

read

public org.apache.kafka.connect.data.Struct read(org.apache.kafka.connect.data.Struct record,
                                                 org.apache.kafka.connect.data.Struct source,
                                                 Long timestamp)

Generate a read message with the given information.

Parameters:

record - the state of the record as read; may not be null

source - the information about the source that was read; may be null

timestamp - the timestamp for this message; may be null

Returns:

the read message; never null

create

public org.apache.kafka.connect.data.Struct create(org.apache.kafka.connect.data.Struct record,
                                                   org.apache.kafka.connect.data.Struct source,
                                                   Long timestamp)

Generate a read message with the given information.

Parameters:

record - the state of the record after creation; may not be null

source - the information about the source where the creation occurred; may be null

timestamp - the timestamp for this message; may be null

Returns:

the create message; never null

update

public org.apache.kafka.connect.data.Struct update(org.apache.kafka.connect.data.Struct before,
                                                   org.apache.kafka.connect.data.Struct after,
                                                   org.apache.kafka.connect.data.Struct source,
                                                   Long timestamp)

Generate an update message with the given information.

Parameters:

before - the state of the record before the update; may be null

after - the state of the record after the update; may not be null

source - the information about the source where the update occurred; may be null

timestamp - the timestamp for this message; may be null

Returns:

the update message; never null

delete

public org.apache.kafka.connect.data.Struct delete(org.apache.kafka.connect.data.Struct before,
                                                   org.apache.kafka.connect.data.Struct source,
                                                   Long timestamp)

Generate an delete message with the given information.

Parameters:

before - the state of the record before the delete; may be null

source - the information about the source where the deletion occurred; may be null

timestamp - the timestamp for this message; may be null

Returns:

the delete message; never null

operationFor

public static Envelope.Operation operationFor(org.apache.kafka.connect.source.SourceRecord record)

Obtain the operation for the given source record.

Parameters:

record - the source record; may not be null

Returns:

the operation, or null if no valid operation was found in the record