Package org.dbunit.database

Class DatabaseSequenceFilter

java.lang.Object

org.dbunit.dataset.filter.SequenceTableFilter

org.dbunit.database.DatabaseSequenceFilter

All Implemented Interfaces:

ITableFilter, ITableFilterSimple

public class DatabaseSequenceFilter
extends SequenceTableFilter

This filter orders tables using dependency information provided by DatabaseMetaData.getExportedKeys(java.lang.String, java.lang.String, java.lang.String). Note that this class name is a bit misleading since it is not at all related to database sequences. It just brings database tables in a specific order.

A foreign-key dependency cycle among the ordered tables is rejected with CyclicTablesDependencyException by default. Enable DatabaseConfig.FEATURE_SKIP_CYCLE_CHECK to opt out of that check for schemas whose cyclic references are handled another way (e.g. nullable FK columns populated in a later operation, or database-side deferred constraint checking); tables outside the cycle are still correctly ordered relative to it, and only the relative order of the cyclic tables themselves is left as-supplied (see sort(java.lang.String[], java.lang.String[], java.util.Map)).

Since:

1.5.1 (Mar 23, 2003)

Version:

$Revision$ $Date$

Author:

Manuel Laflamme, Erik Price, Last changed by: $Author$

Constructor Summary

Constructors

Constructor	Description
DatabaseSequenceFilter(IDatabaseConnection connection)	Create a DatabaseSequenceFilter that exposes all the database tables.
DatabaseSequenceFilter(IDatabaseConnection connection, String[] tableNames)	Create a DatabaseSequenceFilter that only exposes specified table names.

Method Summary

Methods inherited from class org.dbunit.dataset.filter.SequenceTableFilter

accept, getTableNames, iterator, toString

Methods inherited from class java.lang.Object

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

Constructor Details

DatabaseSequenceFilter

public DatabaseSequenceFilter(IDatabaseConnection connection,
 String[] tableNames)
                       throws DataSetException,
SQLException

Create a DatabaseSequenceFilter that only exposes specified table names.

Parameters:

connection - the database connection used to resolve table dependencies.

tableNames - the table names to expose, re-ordered to respect FK dependencies.

Throws:

DataSetException - if a table dependency cycle is detected and DatabaseConfig.FEATURE_SKIP_CYCLE_CHECK is not enabled on connection's DatabaseConfig.

SQLException - if an exception is encountered in accessing the database.

DatabaseSequenceFilter

public DatabaseSequenceFilter(IDatabaseConnection connection)
                       throws DataSetException,
SQLException

Create a DatabaseSequenceFilter that exposes all the database tables.

Parameters:

connection - the database connection used to resolve table dependencies.

Throws:

DataSetException - if a table dependency cycle is detected and DatabaseConfig.FEATURE_SKIP_CYCLE_CHECK is not enabled on connection's DatabaseConfig.

SQLException - if an exception is encountered in accessing the database.