Package org.dbunit.operation

Class DatabaseOperation

java.lang.Object

org.dbunit.operation.DatabaseOperation

Direct Known Subclasses:

AbstractOperation, CloseConnectionOperation, CompositeOperation, TransactionOperation

public abstract class DatabaseOperation
extends Object

Defines the interface contract for operations performed on the database.

Since:

Feb 18, 2002

Version:

$Revision$

Author:

Manuel Laflamme

Field Summary

Fields

Modifier and Type	Field	Description
static final DatabaseOperation	CLEAN_INSERT	Deletes all rows of the dataset's tables, then inserts the dataset's rows.
static final DatabaseOperation	DELETE	Deletes rows matching the dataset's primary keys.
static final DatabaseOperation	DELETE_ALL	Deletes all rows of the dataset's tables.
static final DatabaseOperation	INSERT	Inserts the dataset's rows.
static final DatabaseOperation	NONE	No-op that does nothing to the database.
static final DatabaseOperation	REFRESH	Updates existing rows and inserts rows that do not yet exist (upsert).
static final DatabaseOperation	TRUNCATE_TABLE	Truncates the dataset's tables.
static final DatabaseOperation	UPDATE	Updates existing rows matching the dataset's primary keys.

Constructor Summary

Constructors

Constructor	Description
DatabaseOperation()

Method Summary

Modifier and Type	Method	Description
static final DatabaseOperation	CLOSE_CONNECTION(DatabaseOperation operation)	Wraps the given operation so it closes the connection after executing.
abstract void	execute(IDatabaseConnection connection, IDataSet dataSet)	Executes this operation on the specified database using the specified dataset contents.
static final DatabaseOperation	TRANSACTION(DatabaseOperation operation)	Wraps the given operation so it runs within its own transaction.

Methods inherited from class java.lang.Object

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

Field Details

NONE

public static final DatabaseOperation NONE

No-op that does nothing to the database.

See Also:

• DatabaseOperation.DummyOperation

UPDATE

public static final DatabaseOperation UPDATE

Updates existing rows matching the dataset's primary keys.

See Also:

• UpdateOperation

INSERT

public static final DatabaseOperation INSERT

Inserts the dataset's rows.

See Also:

• InsertOperation

REFRESH

public static final DatabaseOperation REFRESH

Updates existing rows and inserts rows that do not yet exist (upsert).

See Also:

• RefreshOperation

DELETE

public static final DatabaseOperation DELETE

Deletes rows matching the dataset's primary keys.

See Also:

• DeleteOperation

DELETE_ALL

public static final DatabaseOperation DELETE_ALL

Deletes all rows of the dataset's tables.

See Also:

• DeleteAllOperation

TRUNCATE_TABLE

public static final DatabaseOperation TRUNCATE_TABLE

Truncates the dataset's tables.

See Also:

• TruncateTableOperation

CLEAN_INSERT

public static final DatabaseOperation CLEAN_INSERT

Deletes all rows of the dataset's tables, then inserts the dataset's rows.

See Also:

• DeleteAllOperation
• InsertOperation
• CompositeOperation

Constructor Details

DatabaseOperation

public DatabaseOperation()

Method Details

TRANSACTION

public static final DatabaseOperation TRANSACTION(DatabaseOperation operation)

Wraps the given operation so it runs within its own transaction.

Parameters:

operation - the operation to wrap.

Returns:

the wrapped, transactional operation.

See Also:

• TransactionOperation

CLOSE_CONNECTION

public static final DatabaseOperation CLOSE_CONNECTION(DatabaseOperation operation)

Wraps the given operation so it closes the connection after executing.

Parameters:

operation - the operation to wrap.

Returns:

the wrapped operation.

See Also:

• CloseConnectionOperation

execute

public abstract void execute(IDatabaseConnection connection,
 IDataSet dataSet)
                      throws DatabaseUnitException,
SQLException

Executes this operation on the specified database using the specified dataset contents.

Parameters:

connection - the database connection.

dataSet - the dataset to be used by this operation.

Throws:

DatabaseUnitException - if a DbUnit-specific error occurs while executing the operation.

SQLException - if a database access error occurs while executing the operation.