io.debezium.connector.oracle.xstream

Class XstreamStreamingChangeEventSource

java.lang.Object

io.debezium.connector.oracle.xstream.XstreamStreamingChangeEventSource

All Implemented Interfaces:

io.debezium.pipeline.source.spi.ChangeEventSource, io.debezium.pipeline.source.spi.StreamingChangeEventSource

public class XstreamStreamingChangeEventSource
extends Object
implements io.debezium.pipeline.source.spi.StreamingChangeEventSource

A StreamingChangeEventSource based on Oracle's XStream API. The XStream event handler loop is executed in a separate executor.

Author:

Gunnar Morling

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XstreamStreamingChangeEventSource.PositionAndScn

Nested classes/interfaces inherited from interface io.debezium.pipeline.source.spi.ChangeEventSource

io.debezium.pipeline.source.spi.ChangeEventSource.ChangeEventSourceContext

Field Summary

Fields

Modifier and Type	Field and Description
private io.debezium.util.Clock	clock
private io.debezium.pipeline.EventDispatcher<io.debezium.relational.TableId>	dispatcher
private io.debezium.pipeline.ErrorHandler	errorHandler
private io.debezium.jdbc.JdbcConnection	jdbcConnection
private AtomicReference<XstreamStreamingChangeEventSource.PositionAndScn>	lcrMessage A message box between thread that is informed about committed offsets and the XStream thread.
private static org.slf4j.Logger	LOGGER
private OracleOffsetContext	offsetContext
private int	posVersion
private OracleDatabaseSchema	schema
private boolean	tablenameCaseInsensitive
private oracle.streams.XStreamOut	xsOut
private String	xStreamServerName

Constructor Summary

Constructors

Constructor and Description
XstreamStreamingChangeEventSource(OracleConnectorConfig connectorConfig, OracleOffsetContext offsetContext, io.debezium.jdbc.JdbcConnection jdbcConnection, io.debezium.pipeline.EventDispatcher<io.debezium.relational.TableId> dispatcher, io.debezium.pipeline.ErrorHandler errorHandler, io.debezium.util.Clock clock, OracleDatabaseSchema schema)

Method Summary

Modifier and Type	Method and Description
void	commitOffset(Map<String,?> offset)
private byte[]	convertScnToPosition(long scn)
void	execute(io.debezium.pipeline.source.spi.ChangeEventSource.ChangeEventSourceContext context)
(package private) oracle.streams.XStreamOut	getXsOut()
(package private) XstreamStreamingChangeEventSource.PositionAndScn	receivePublishedPosition()
private void	sendPublishedPosition(LcrPosition lcrPosition, Long scn)

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final org.slf4j.Logger LOGGER

jdbcConnection

private final io.debezium.jdbc.JdbcConnection jdbcConnection

dispatcher

private final io.debezium.pipeline.EventDispatcher<io.debezium.relational.TableId> dispatcher

errorHandler

private final io.debezium.pipeline.ErrorHandler errorHandler

clock

private final io.debezium.util.Clock clock

schema

private final OracleDatabaseSchema schema

offsetContext

private final OracleOffsetContext offsetContext

xStreamServerName

private final String xStreamServerName

xsOut

private volatile oracle.streams.XStreamOut xsOut

tablenameCaseInsensitive

private final boolean tablenameCaseInsensitive

posVersion

private final int posVersion

lcrMessage

private final AtomicReference<XstreamStreamingChangeEventSource.PositionAndScn> lcrMessage

A message box between thread that is informed about committed offsets and the XStream thread. When the last offset is committed its value is passed to the XStream thread and a watermark is set to signal which events were safely processed. This is important as setting watermark in a concurrent thread can lead to a deadlock due to an internal Oracle code locking.

Constructor Detail

XstreamStreamingChangeEventSource

public XstreamStreamingChangeEventSource(OracleConnectorConfig connectorConfig,
                                         OracleOffsetContext offsetContext,
                                         io.debezium.jdbc.JdbcConnection jdbcConnection,
                                         io.debezium.pipeline.EventDispatcher<io.debezium.relational.TableId> dispatcher,
                                         io.debezium.pipeline.ErrorHandler errorHandler,
                                         io.debezium.util.Clock clock,
                                         OracleDatabaseSchema schema)

Method Detail

execute

public void execute(io.debezium.pipeline.source.spi.ChangeEventSource.ChangeEventSourceContext context)
             throws InterruptedException

Specified by:

execute in interface io.debezium.pipeline.source.spi.StreamingChangeEventSource

Throws:

InterruptedException

commitOffset

public void commitOffset(Map<String,?> offset)

Specified by:

commitOffset in interface io.debezium.pipeline.source.spi.StreamingChangeEventSource

convertScnToPosition

private byte[] convertScnToPosition(long scn)

getXsOut

oracle.streams.XStreamOut getXsOut()

sendPublishedPosition

private void sendPublishedPosition(LcrPosition lcrPosition,
                                   Long scn)

receivePublishedPosition

XstreamStreamingChangeEventSource.PositionAndScn receivePublishedPosition()