org.dbunit

Interface PrepAndExpectedTestCase

All Known Implementing Classes:

DefaultPrepAndExpectedTestCase

public interface PrepAndExpectedTestCase

Test case supporting prep data and expected data.

Since:

2.4.8

Version:

$Revision$ $Date$

Author:

Jeff Jensen jeffjensen AT users.sourceforge.net, Last changed by: $Author$

Method Summary

Methods

Modifier and Type	Method and Description
void	cleanupData() Cleanup tables specified in prep and expected datasets, using the provided databaseTester.
void	configureTest(VerifyTableDefinition[] verifyTables, String[] prepDataFiles, String[] expectedDataFiles) Configure the test.
IDataSet	getExpectedDataset() Get the expected dataset, created from the expectedDataFiles.
IDataSet	getPrepDataset() Get the prep dataset, created from the prepDataFiles.
void	postTest() Execute all post-test steps.
void	postTest(boolean verifyData) Execute post-test steps.
void	preTest() Execute pre-test steps.
void	preTest(VerifyTableDefinition[] verifyTables, String[] prepDataFiles, String[] expectedDataFiles) Convenience method to call configureTest() and preTest().
Object	runTest(VerifyTableDefinition[] verifyTables, String[] prepDataFiles, String[] expectedDataFiles, PrepAndExpectedTestCaseSteps testSteps) Run the DbUnit test.
void	verifyData() For the provided VerifyTableDefinitions, verify each table's actual results are as expected.

Method Detail

configureTest

void configureTest(VerifyTableDefinition[] verifyTables,
                 String[] prepDataFiles,
                 String[] expectedDataFiles)
                   throws Exception

Configure the test. Call this method before performing the test steps.

Parameters:

verifyTables - Table definitions to verify after test execution.

prepDataFiles - The prep data files to load as seed data.

expectedDataFiles - The expected data files to load as expected data.

Throws:

Exception

preTest

void preTest()
             throws Exception

Execute pre-test steps. Call this method before performing the test steps.

Throws:

Exception

preTest

void preTest(VerifyTableDefinition[] verifyTables,
           String[] prepDataFiles,
           String[] expectedDataFiles)
             throws Exception

Convenience method to call configureTest() and preTest().

Parameters:

verifyTables - Table definitions to verify after test execution.

prepDataFiles - The prep data files to load as seed data.

expectedDataFiles - The expected data files to load as expected data.

Throws:

Exception

runTest

Object runTest(VerifyTableDefinition[] verifyTables,
             String[] prepDataFiles,
             String[] expectedDataFiles,
             PrepAndExpectedTestCaseSteps testSteps)
               throws Exception

Run the DbUnit test.

Parameters:

verifyTables - Table definitions to verify after test execution.

prepDataFiles - The prep data files to load as seed data.

expectedDataFiles - The expected data files to load as expected data.

testSteps - The test steps to run.

Returns:

User defined object from running the test steps.

Throws:

Exception

Since:

2.5.2

postTest

void postTest()
              throws Exception

Execute all post-test steps. Call this method after performing the test steps.

Throws:

Exception

postTest

void postTest(boolean verifyData)
              throws Exception

Execute post-test steps. Call this method after performing the test steps.

Parameters:

verifyData - Specify true to perform verify data steps, false to not. Useful to specify false when test has failure in progress (e.g. an exception) and verifying data would fail, masking original test failure.

Throws:

Exception

verifyData

void verifyData()
                throws Exception

For the provided VerifyTableDefinitions, verify each table's actual results are as expected.

Throws:

Exception

cleanupData

void cleanupData()
                 throws Exception

Cleanup tables specified in prep and expected datasets, using the provided databaseTester. See IDatabaseTester.onTearDown().

Throws:

Exception

getPrepDataset

IDataSet getPrepDataset()

Get the prep dataset, created from the prepDataFiles.

Returns:

The prep dataset.

getExpectedDataset

IDataSet getExpectedDataset()

Get the expected dataset, created from the expectedDataFiles.

Returns:

The expected dataset.