io.debezium.relational

Class Tables

java.lang.Object

io.debezium.relational.Tables

@ThreadSafe
public final class Tables
extends Object

Structural definitions for a set of tables in a JDBC database.

Author:

Randall Hauch

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Tables.ColumnNameFilter A filter for columns.
static interface	Tables.TableChanger
static interface	Tables.TableNameFilter A filter for tables.

Field Summary

Fields

Modifier and Type	Field and Description
private Set<TableId>	changes
private FunctionalReadWriteLock	lock
private Map<TableId,TableImpl>	tablesByTableId

Constructor Summary

Constructors

Modifier	Constructor and Description
	Tables() Create an empty set of definitions.
protected	Tables(Tables other)

Method Summary

Modifier and Type	Method and Description
Tables	clone()
Set<TableId>	drainChanges()
TableEditor	editOrCreateTable(String catalogName, String schemaName, String tableName) Obtain an editor for the identified table or, if there is no such table, create an editor with the specified ID.
TableEditor	editOrCreateTable(TableId tableId) Obtain an editor for the table with the given ID.
TableEditor	editTable(String catalogName, String schemaName, String tableName) Obtain an editor for the identified table.
TableEditor	editTable(TableId tableId) Obtain an editor for the table with the given ID.
boolean	equals(Object obj)
static Tables.TableNameFilter	filterFor(Predicate<TableId> predicate) Create a Tables.TableNameFilter for the given Predicate.
Table	forTable(String catalogName, String schemaName, String tableName) Obtain the definition of the identified table.
Table	forTable(TableId tableId) Obtain the definition of the identified table.
int	hashCode()
Table	overwriteTable(Table table) Add or update the definition for the identified table.
Table	overwriteTable(TableId tableId, List<Column> columnDefs, List<String> primaryKeyColumnNames) Add or update the definition for the identified table.
Table	removeTable(TableId tableId) Remove the definition of the identified table.
Table	renameTable(TableId existingTableId, TableId newTableId) Rename an existing table.
int	size() Get the number of tables that are in this object.
Tables	subset(Predicate<TableId> filter)
Set<TableId>	tableIds() Get the set of TableIds for which there is a Schema.
String	toString()
Table	updateTable(TableId tableId, Function<Table,Table> changer) Add or update the definition for the identified table.
Table	updateTable(TableId tableId, Tables.TableChanger changer) Add or update the definition for the identified table.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

lock

private final FunctionalReadWriteLock lock

tablesByTableId

private final Map<TableId,TableImpl> tablesByTableId

changes

private final Set<TableId> changes

Constructor Detail

Tables

public Tables()

Create an empty set of definitions.

Tables

protected Tables(Tables other)

Method Detail

filterFor

public static Tables.TableNameFilter filterFor(Predicate<TableId> predicate)

Create a Tables.TableNameFilter for the given Predicate.

Parameters:

predicate - the TableId predicate filter; may be null

Returns:

the TableNameFilter; never null

clone

public Tables clone()

Overrides:

clone in class Object

size

public int size()

Get the number of tables that are in this object.

Returns:

the table count

drainChanges

public Set<TableId> drainChanges()

overwriteTable

public Table overwriteTable(TableId tableId,
                            List<Column> columnDefs,
                            List<String> primaryKeyColumnNames)

Add or update the definition for the identified table.

Parameters:

tableId - the identifier of the table

columnDefs - the list of column definitions; may not be null or empty

primaryKeyColumnNames - the list of the column names that make up the primary key; may be null or empty

Returns:

the previous table definition, or null if there was no prior table definition

overwriteTable

public Table overwriteTable(Table table)

Add or update the definition for the identified table.

Parameters:

table - the definition for the table; may not be null

Returns:

the previous table definition, or null if there was no prior table definition

renameTable

public Table renameTable(TableId existingTableId,
                         TableId newTableId)

Rename an existing table.

Parameters:

existingTableId - the identifier of the existing table to be renamed; may not be null

newTableId - the new identifier for the table; may not be null

Returns:

the previous table definition, or null if there was no prior table definition

updateTable

public Table updateTable(TableId tableId,
                         Function<Table,Table> changer)

Add or update the definition for the identified table.

Parameters:

tableId - the identifier of the table

changer - the function that accepts the current Table and returns either the same or an updated Table; may not be null

Returns:

the previous table definition, or null if there was no prior table definition

updateTable

public Table updateTable(TableId tableId,
                         Tables.TableChanger changer)

Add or update the definition for the identified table.

Parameters:

tableId - the identifier of the table

changer - the function that accepts and changes the mutable ordered list of column definitions and the mutable set of column names that make up the primary key; may not be null

Returns:

the previous table definition, or null if there was no prior table definition

removeTable

public Table removeTable(TableId tableId)

Remove the definition of the identified table.

Parameters:

tableId - the identifier of the table

Returns:

the existing table definition that was removed, or null if there was no prior table definition

forTable

public Table forTable(TableId tableId)

Obtain the definition of the identified table.

Parameters:

tableId - the identifier of the table

Returns:

the table definition, or null if there was no definition for the identified table

forTable

public Table forTable(String catalogName,
                      String schemaName,
                      String tableName)

Obtain the definition of the identified table.

Parameters:

catalogName - the name of the database catalog that contains the table; may be null if the JDBC driver does not show a schema for this table

schemaName - the name of the database schema that contains the table; may be null if the JDBC driver does not show a schema for this table

tableName - the name of the table

Returns:

the table definition, or null if there was no definition for the identified table

tableIds

public Set<TableId> tableIds()

Get the set of TableIds for which there is a Schema.

Returns:

the immutable set of table identifiers; never null

editTable

public TableEditor editTable(TableId tableId)

Obtain an editor for the table with the given ID. This method does not lock the set of table definitions, so use with caution. The resulting editor can be used to modify the table definition, but when completed the new Table needs to be added back to this object via overwriteTable(Table).

Parameters:

tableId - the identifier of the table

Returns:

the editor for the table, or null if there is no table with the specified ID

editTable

public TableEditor editTable(String catalogName,
                             String schemaName,
                             String tableName)

Obtain an editor for the identified table. This method does not lock the set of table definitions, so use with caution. The resulting editor can be used to modify the table definition, but when completed the new Table needs to be added back to this object via overwriteTable(Table).

Parameters:

catalogName - the name of the database catalog that contains the table; may be null if the JDBC driver does not show a schema for this table

schemaName - the name of the database schema that contains the table; may be null if the JDBC driver does not show a schema for this table

tableName - the name of the table

Returns:

the editor for the table, or null if there is no table with the specified ID

editOrCreateTable

public TableEditor editOrCreateTable(TableId tableId)

Obtain an editor for the table with the given ID. This method does not lock or modify the set of table definitions, so use with caution. The resulting editor can be used to modify the table definition, but when completed the new Table needs to be added back to this object via overwriteTable(Table).

Parameters:

tableId - the identifier of the table

Returns:

the editor for the table, or null if there is no table with the specified ID

editOrCreateTable

public TableEditor editOrCreateTable(String catalogName,
                                     String schemaName,
                                     String tableName)

Obtain an editor for the identified table or, if there is no such table, create an editor with the specified ID. This method does not lock or modify the set of table definitions, so use with caution. The resulting editor can be used to modify the table definition, but when completed the new Table needs to be added back to this object via overwriteTable(Table).

Parameters:

catalogName - the name of the database catalog that contains the table; may be null if the JDBC driver does not show a schema for this table

schemaName - the name of the database schema that contains the table; may be null if the JDBC driver does not show a schema for this table

tableName - the name of the table

Returns:

the editor for the table, or null if there is no table with the specified ID

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

subset

public Tables subset(Predicate<TableId> filter)

toString

public String toString()

Overrides:

toString in class Object