org.dbunit.dataset
Interface IDataSet

All Known Implementing Classes:

AbstractDataSet, CachedDataSet, CaseInsensitiveDataSet, CompositeDataSet, CsvDataSet, CsvURLDataSet, DatabaseDataSet, DefaultDataSet, FilteredDataSet, FlatDtdDataSet, FlatXmlDataSet, ForwardOnlyDataSet, LowerCaseDataSet, QueryDataSet, ReplacementDataSet, SortedDataSet, SqlLoaderControlDataSet, StreamingDataSet, XlsDataSet, XmlDataSet

public interface IDataSet

Represents a collection of tables.

Since:

Feb 17, 2002

Version:

$Revision: 911 $

Author:

Manuel Laflamme

Method Summary

ITable	getTable(String tableName) Returns the specified table.
ITableMetaData	getTableMetaData(String tableName) Returns the specified table metadata.
String[]	getTableNames() Returns names of tables in this dataset in proper sequence.
ITable[]	getTables() Deprecated. Use iterator() or reverseIterator() instead.
boolean	isCaseSensitiveTableNames() Whether or not this dataset handles table names in a case sensitive way or not.
ITableIterator	iterator() Returns an iterator over the tables in this dataset in proper sequence.
ITableIterator	reverseIterator() Returns an iterator over the tables in this dataset in reverse sequence.

Method Detail

getTableNames

String[] getTableNames()
                       throws DataSetException

Returns names of tables in this dataset in proper sequence. Multiple occurrence of the same name may be returned if multiple tables having the same name are present in the dataset.

Throws:

DataSetException

getTableMetaData

ITableMetaData getTableMetaData(String tableName)
                                throws DataSetException

Returns the specified table metadata.

Throws:

AmbiguousTableNameException - if dataset contains multiple tables having the specified name. Use iterator() to access to all tables.

NoSuchTableException - if dataset do not contains the specified table

DataSetException

getTable

ITable getTable(String tableName)
                throws DataSetException

Returns the specified table.

Throws:

AmbiguousTableNameException - if dataset contains multiple tables having the specified name. Use iterator() to access to all tables.

NoSuchTableException - if dataset do not contains the specified table

DataSetException

getTables

ITable[] getTables()
                   throws DataSetException

Deprecated. Use iterator() or reverseIterator() instead.

Returns tables in this dataset in proper sequence. Multiple tables having the same name but different data may be returned.

Throws:

DataSetException

iterator

ITableIterator iterator()
                        throws DataSetException

Returns an iterator over the tables in this dataset in proper sequence.

Throws:

DataSetException

reverseIterator

ITableIterator reverseIterator()
                               throws DataSetException

Returns an iterator over the tables in this dataset in reverse sequence.

Throws:

DataSetException

isCaseSensitiveTableNames

boolean isCaseSensitiveTableNames()

Whether or not this dataset handles table names in a case sensitive way or not.

Returns:

true if the case sensitivity of table names is used in this dataset.

Since:

2.4.2