io.debezium.connector.oracle.xstream

Class XstreamStreamingChangeEventSource

java.lang.Object

io.debezium.connector.oracle.xstream.XstreamStreamingChangeEventSource

All Implemented Interfaces:

ChangeEventSource, StreamingChangeEventSource

public class XstreamStreamingChangeEventSource
extends Object
implements 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

ChangeEventSource.ChangeEventSourceContext

Field Summary

Fields

Modifier and Type	Field and Description
private Clock	clock
private EventDispatcher<TableId>	dispatcher
private ErrorHandler	errorHandler
private OracleConnection	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, OracleConnection jdbcConnection, EventDispatcher<TableId> dispatcher, ErrorHandler errorHandler, Clock clock, OracleDatabaseSchema schema)

Method Summary

Modifier and Type	Method and Description
void	commitOffset(Map<String,?> offset)
private byte[]	convertScnToPosition(Scn scn)
void	execute(ChangeEventSource.ChangeEventSourceContext context)
(package private) oracle.streams.XStreamOut	getXsOut()
(package private) XstreamStreamingChangeEventSource.PositionAndScn	receivePublishedPosition()
private static int	resolvePosVersion(OracleConnection connection, OracleConnectorConfig connectorConfig)
private void	sendPublishedPosition(LcrPosition lcrPosition, Scn 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 OracleConnection jdbcConnection

dispatcher

private final EventDispatcher<TableId> dispatcher

errorHandler

private final ErrorHandler errorHandler

clock

private final 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,
                                         OracleConnection jdbcConnection,
                                         EventDispatcher<TableId> dispatcher,
                                         ErrorHandler errorHandler,
                                         Clock clock,
                                         OracleDatabaseSchema schema)

Method Detail

execute

public void execute(ChangeEventSource.ChangeEventSourceContext context)
             throws InterruptedException

Specified by:

execute in interface StreamingChangeEventSource

Throws:

InterruptedException

commitOffset

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

Specified by:

commitOffset in interface StreamingChangeEventSource

convertScnToPosition

private byte[] convertScnToPosition(Scn scn)

getXsOut

oracle.streams.XStreamOut getXsOut()

sendPublishedPosition

private void sendPublishedPosition(LcrPosition lcrPosition,
                                   Scn scn)

receivePublishedPosition

XstreamStreamingChangeEventSource.PositionAndScn receivePublishedPosition()

resolvePosVersion

private static int resolvePosVersion(OracleConnection connection,
                                     OracleConnectorConfig connectorConfig)