開始
1. 用DBTestCase的子類建立數(shù)據(jù)庫
2. 用你自己的TestCase子類建立數(shù)據(jù)庫
3. 數(shù)據(jù)庫數(shù)據(jù)校驗
4. DbUnit的Ant任務和Canoo web測試（此處省略，另詳）
用DBTestCase的子類建立數(shù)據(jù)庫
第一步：創(chuàng)建你的dataset文件
你的測試需要一些數(shù)據(jù)。這就意味著你必須創(chuàng)建dataset。許多情況下你都是處理xml的dataset。你可以人工湊一些一般的xml dataset或是從你的數(shù)據(jù)庫中導出一個xml dataset.
第二步：繼承DBTestCase類
現(xiàn)在你要創(chuàng)建一個測試類。最簡單的方式是用通過繼承DbUnit的DBTestCase來創(chuàng)建你自己的測試類。DBTestCase繼承了Junit的TestCase類。一個模板方法你需要實現(xiàn)，getDataSet()返回你在第一步創(chuàng)建的dataset。DBTestCase依靠IdatabaseTester來工作，默認的配置是使用PropertiesBaseJdbcDatabaseTester，它是用系統(tǒng)屬性來指出DriverManager的配置。最簡單的方式是在你測試類的構造函數(shù)中配置它。你可以通過覆蓋getDatabaseTester()方法來修改它的行為。
使用下面提供的三種IDatabaseTester之一實現(xiàn)，你也可以使用下面表中描述的DBTestCase的其它子類。
|
JdbcBaseDBTestCase
|
使用DriverManager來創(chuàng)建連接(在JdbcDatabaseTester的幫助下)
|
|
DataSourceBasedDBTestCase
|
使用javax.sql.DataSource來創(chuàng)建連接(在DataSourceDatabaseTester的幫助下)
|
|
JndiBasedDBTestCase
|
使用javax.sql.DataSourece通過JNDI定位(在jndiDatabaseTester的幫助下)
|
下面是一個簡單的實現(xiàn)，連接到一個Hypersonic數(shù)據(jù)庫并返回xml dataset：
public class SampleTest extends DBTestCase
{
public SampleTest(String name)
{
super( name );
System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_DRIVER_CLASS, "org.hsqldb.jdbcDriver" );
System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_CONNECTION_URL, "jdbc:hsqldb:sample" );
System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_USERNAME, "sa" );
System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_PASSWORD, "" );
// System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_SCHEMA, "" );
}
protected IDataSet getDataSet() throws Exception
{
return new FlatXmlDataSet(new FileInputStream("dataset.xml"));
}
}
第三步：（可選）實現(xiàn)getSetUpOperation()和getTearDownOperation()方法
默認的情況，DbUnit在每次執(zhí)行test之前執(zhí)行一個CLEAN_INSERT操作并且不之后不執(zhí)行清除操作。你可以通過覆蓋getSetUpOperation()和getTearDownOperation()來改變這個行為。
下面這個例子演示你可以通過簡單的覆蓋方法改變執(zhí)行測試前和后。
public class SampleTest extends DBTestCase
{
protected DatabaseOperation getSetUpOperation() throws Exception
{
return DatabaseOperation.REFRESH;
}
protected DatabaseOperation getTearDownOperation() throws Exception
{
return DatabaseOperation.NONE;
}
}
第四步：實現(xiàn)你的testXXX()方法
就像你使用JUit一樣實現(xiàn)test方法。你的數(shù)據(jù)庫在測試方法之前初始化并且在測試之后清除，這取決于你在前幾步是怎么做的。
用你自己的TestCase子類建立數(shù)據(jù)庫
為了使用DbUnit你不是必須要繼承DBTestCase類。你可以覆蓋標準的Junit的SetUp()方法，執(zhí)行你所需要的數(shù)據(jù)庫操作。如果你要執(zhí)行清除，同樣覆蓋teardown()方法。
例如：
public class SampleTest extends TestCase
{
public SampleTest(String name)
{
super(name);
}
protected void setUp() throws Exception
{
super.setUp();
// initialize your database connection here
IDatabaseConnection connection = null;
//
// initialize your dataset here
IDataSet dataSet = null;
//
try1
{
DatabaseOperation.CLEAN_INSERT.execute(connection, dataSet);
}
finally
{
connection.close();
}
}
}
自從2.2版本你可以使用IdatabaseTester來完成同樣的功能。就像前面所提到過的，DBTestCase內(nèi)部是使用IdatabaseTester來實現(xiàn)的。你的測試類可以使用這個功能操作數(shù)據(jù)集(DataSets)。目前有4個方便的實現(xiàn)。
|
JdbcDatabaseTester
|
使用DriverManager來創(chuàng)建連接。
|
|
PropertiesBasedJdbcDatabaseTester
|
也是使用DriverManager來創(chuàng)建連接，但是配置信息是從系統(tǒng)屬性中讀取的。這是DBTestCase的默認實現(xiàn)方式。
|
|
DataSourceDatabaseTester
|
使用javax.sql.DataSource創(chuàng)建連接。
|
|
JndiDatabaseTester
|
使用javax.sql.DataSource通過JNDI尋找
|
你也可以提供你自己的IdatabaseTester實現(xiàn)，推薦使用AbstractDatabaseTester作為一個開始點。
例：
public class SampleTest extends TestCase
{
private IDatabaseTester databaseTester;
public SampleTest(String name)
{
super(name);
}
protected void setUp() throws Exception
{
databaseTester = new JdbcDatabaseTester("org.hsqldb.jdbcDriver",
"jdbc:hsqldb:sample", "sa", "");
// initialize your dataset here
IDataSet dataSet = null;
//
databaseTester.setDataSet( dataSet );
// will call default setUpOperation
databaseTester.onSetUp();
}
protected void tearDown() throws Exception
{
// will call default tearDownOperation
databaseTester.onTearDown();
}
}
數(shù)據(jù)庫數(shù)據(jù)校驗
DbUnit提供校驗兩個表或是數(shù)據(jù)集是否包含相同的數(shù)據(jù)的方法。下面的兩個方法是在執(zhí)行測試類的時候可以校驗你的數(shù)據(jù)庫中是否包含預期的數(shù)據(jù)。
public class Assertion
{
public static void assertEquals(ITable expected, ITable actual)
public static void assertEquals(IDataSet expected, IDataSet actual)
}
例子
以下例子，展示怎么比較一個數(shù)據(jù)庫表的快照和一個XML表。
public class SampleTest extends DBTestCase
{
public SampleTest(String name)
{
super(name);
}
// Implements required setup methods here
public void testMe() throws Exception
{
// Execute the tested code that modify the database here
// Fetch database data after executing your code
IDataSet databaseDataSet = getConnection().createDataSet();
ITable actualTable = databaseDataSet.getTable("TABLE_NAME");
// Load expected data from an XML dataset
IDataSet expectedDataSet = new FlatXmlDataSet(new File("expectedDataSet.xml"));
ITable expectedTable = expectedDataSet.getTable("TABLE_NAME");
// Assert actual database table match expected table
Assertion.assertEquals(expectedTable, actualTable);
}
}
actual數(shù)據(jù)集是一個數(shù)據(jù)庫的快照可以和你想要比較的expected數(shù)據(jù)集進行比較。就象他的名字一樣，expected數(shù)據(jù)集中包含預期的值。
expected數(shù)據(jù)集一定要和你建立數(shù)據(jù)庫時的對象不一樣。因為你需要兩個數(shù)據(jù)集，一個是在測試之前建立數(shù)據(jù)庫，一個是提供匹配測試時的expected數(shù)據(jù)。
使用查詢來獲取數(shù)據(jù)庫的快照
你也可以校驗查詢的結果是不是和期望的數(shù)據(jù)集匹配。這個查詢可以使查詢一個表中的一部分也可以是多表的聯(lián)合查詢。
Itable actualJoinData = getConnection().createQueryTable("RESULT_NAME",
"SELECT * FROM TABLE1, TABLE2 WHERE ");
在比較的時候忽略一些列
有些時候希望忽視一些列來進行比較，特別是對主鍵，日期或是時間列，這些列的值是在測試的時候又代碼產(chǎn)生的。一種方式是在你的expected表中省略你不想比較的列的聲明。這樣你可以過濾真實的數(shù)據(jù)庫表只暴露出expected表中的列。
下面這些代碼片段向你展示怎么過濾真實數(shù)據(jù)庫中的表。首先，真實數(shù)據(jù)庫中必須包含expected表中的所有列。另外，真實表中有這些列而expected表中沒有這些列，這種情況是允許的。
ITable filteredTable = DefaultColumnFilter.includedColumnsTable(actual,
expected.getTableMetaData().getColumns());
Assertion.assertEquals(expected, filteredTable);
這個技術的主要限制是你不能在你的expected數(shù)據(jù)集XML中使用DTD。使用DTD的話你需要過濾expected表和真實表中的列。查看FAQ中關于在運行時排除一些表的列(excluding some table columns at runtime)。
行順序
默認的情況下，用DbUnit得到的數(shù)據(jù)庫快照表是按主鍵排序的。如果一個表沒有主鍵或是主鍵是由數(shù)據(jù)庫自動產(chǎn)生的，行的順序是不確定的，那么assertEquals將會失敗。
你一定要排序你的數(shù)據(jù)庫快照通過在IdatabaseConnection.createQueryTable時手工加入”ORDER BY”語句。或者你可以這樣使用SortedTable:
Assertion.assertEquals(new SortedTable(expected),
new SortedTable(actual, expected.getTableMetaData()));