Built by Maven

Core Components

A class-by-class index of dbUnit’s core abstractions, grouped by area. If you already know which task you’re doing, use the rest of Using DbUnit instead — those pages are organized around workflows ("how do I load a CSV dataset," "how do I run an operation"). This page is for the other direction: you already have a class in hand — from JavaDoc, a stack trace, or someone else’s code — and want to know what it is and where it’s covered.

Most classes below link straight to the topic page that already covers them in depth. A few — ITable, VerifyTableDefinition, IOperationListener, and Assertion/DbUnitAssert — didn’t have a page anywhere else, so they get one here.

Connections & Configuration

Class Covered
IDatabaseConnection, DatabaseConnection, DatabaseDataSourceConnection Connections & Configuration — wraps a JDBC connection or DataSource; the factory for creating datasets/tables from a live database.
DatabaseDataSet Connections & Configuration — the IDataSet adapter over a live database connection.
CachingConnectionProvider Connections & Configuration — caches/reuses one IDatabaseConnection across test methods.
DatabaseConfig Properties & Features — the feature-flag/property configuration object for a connection.
IMetadataHandler, InMemoryMetadataResultSet New: IMetadataHandler — corrects a vendor driver’s DatabaseMetaData quirks; register via DatabaseConfig.PROPERTY_METADATA_HANDLER.

Datasets & Tables

Class Covered
IDataSet, DefaultDataSet, DataSetBuilder Datasets — a named collection of `ITable`s, and the fluent builder for constructing one in code.
ITable, ITableMetaData, Column, Columns, ITableIterator New: ITable & Table Metadata — one table’s contract, schema, and cell access.
FlatXmlDataSet Flat XML — one XML element per row, the most commonly used file format.
XmlDataSet XML — the original, more verbose XML format.
CsvDataSet CSV — one CSV file per table, plus a table-ordering.txt manifest.
XlsDataSet Excel (XLS) — one sheet per table.
JsonDataSet JSON — one top-level key per table, values as row-object arrays.
YamlDataSet YAML — one top-level key per table.
SqlLoaderControlDataSet SQL*Loader — builds a dataset from Oracle SQL*Loader control files.
QueryDataSet Query-Based — tables populated from arbitrary SQL queries.
StreamingDataSet Streaming Datasets — forward-only, low-memory access over a producer.
DataFileLoader and implementations Data File Loader — loads a dataset file from the classpath, with ReplacementDataSet substitution built in.
CompositeDataSet, ReplacementDataSet, TableDecoratorDataSet, SortedDataSet/SortedTable, CachedDataSet Decorators — wrap an existing IDataSet/ITable to add behavior.
FilteredDataSet Decorators for the SequenceTableFilter ordering strategy; Filters for DatabaseSequenceFilter, IncludeTableFilter, and ExcludeTableFilter.

Database Operations

Class Covered
DatabaseOperation Database Operations — abstract base for a database mutation performed before/after a test.
DatabaseOperation.INSERT Database Operations
DatabaseOperation.DELETE Database Operations
DatabaseOperation.DELETE_ALL Database Operations
DatabaseOperation.TRUNCATE_TABLE Database Operations
DatabaseOperation.REFRESH Database Operations
DatabaseOperation.CLEAN_INSERT Database Operations
DatabaseOperation.NONE, CompositeOperation, TransactionOperation, CloseConnectionOperation Database Operations
InsertIdentityOperation Database Operations — MSSQL-specific, toggles IDENTITY_INSERT.

Data Comparisons & Assertions

Class Covered
ValueComparer ValueComparer Comparison — pluggable per-column comparison beyond plain equality.
FailureHandler, DifferenceListener, Difference Failure Handling — customize what happens when a comparison finds a mismatch.
Assertion, DbUnitAssert, DbUnitValueComparerAssert New: Assertion & DbUnitAssert — the static facade and the two instance-based engines it delegates to.

Filters

Class Covered
ITableFilter/ITableFilterSimple, IncludeTableFilter, ExcludeTableFilter, SequenceTableFilter, DatabaseSequenceFilter, PrimaryKeyFilter Filters — which tables (and in what order) participate in an operation or comparison.
IColumnFilter, DefaultColumnFilter, GeneratedColumnFilter Filters — which columns participate.
IRowFilter, RowFilterTable Filters — which rows participate.

Data Types

Class Covered
DataType, IDataTypeFactory, DefaultDataTypeFactory Data Types — maps SQL types to Java types; register a vendor-specific factory via DatabaseConfig.PROPERTY_DATATYPE_FACTORY.

Test Integration

Class Covered
IDatabaseTester and implementations IDatabaseTester Guide — the preferred, composition-based way to wire dbUnit into a test.
DBTestCase and subclasses Test Integration — the inheritance-based alternative.
PrepAndExpectedTestCase, PrepAndExpectedTestCaseSteps PrepAndExpectedTestCase — turn-key prep/verify/cleanup test case.
VerifyTableDefinition New: VerifyTableDefinition — defines one table to verify: column filters and `ValueComparer`s.
IOperationListener New: IOperationListener — hooks into connection setup/teardown lifecycle events.