目前在.Net框架下的測試工具主要有Nunit、內置的MSTest以及xUnit這三個工具,本文就簡單的介紹一下如何在VS中使用xUnit進行數據驅動的單元測試。
1. 安裝
直接使用NuGet安裝如下兩個庫即可:
PM> Install-Package xunit
PM> Install-Package xunit.runner.visualstudio -Pre (Visual Studio測試瀏覽器支持, VS2015目前必須裝Pre的)
2.搭建項目
新建一個類庫項目包含兩個目錄,分別存放:
TestDatas文件夾:測試需要的數據及其類型
UnitTests文件夾:單元測試
測試數據采用csv格式,好處是可以使用Excel進行編輯,同時數據結構易于解析。
ProviderTypeData_AddProviderType.csv文件在Excel中和VS中編輯的結果如下:
3.解析數據
需要有一個CSVFileHelper基礎類來將csv格式的數據轉換成DataTable。
public static class CSVFileHelper
{
public static DataTable OpenCSV(string filePath)
{
//Encoding encoding = Common.GetType(filePath); //Encoding.ASCII;//
DataTable dt = new DataTable();
FileStream fs = new FileStream(filePath, System.IO.FileMode.Open, System.IO.FileAccess.Read);
StreamReader sr = new StreamReader(fs, System.Text.Encoding.GetEncoding("GB2312"));
//StreamReader sr = new StreamReader(fs, encoding);
//string fileContent = sr.ReadToEnd();
//encoding = sr.CurrentEncoding;
//記錄每次讀取的一行記錄
string strLine = "";
//記錄每行記錄中的各字段內容
string[] aryLine = null;
string[] tableHead = null;
//標示列數
int columnCount = 0;
//標示是否是讀取的第一行
bool IsFirst = true;
//逐行讀取CSV中的數據
while ((strLine = sr.ReadLine()) != null)
{
//strLine = Common.ConvertStringUTF8(strLine, encoding);
//strLine = Common.ConvertStringUTF8(strLine);
if (IsFirst == true)
{
tableHead = strLine.Split(',');
IsFirst = false;
columnCount = tableHead.Length;
//創建列
for (int i = 0; i < columnCount; i++)
{
DataColumn dc = new DataColumn(tableHead[i]);
dt.Columns.Add(dc);
}
}
else
{
aryLine = strLine.Split(',');
DataRow dr = dt.NewRow();
for (int j = 0; j < columnCount; j++)
{
dr[j] = aryLine[j];
}
dt.Rows.Add(dr);
}
}
if (aryLine != null && aryLine.Length > 0)
{
dt.DefaultView.Sort = tableHead[0] + " " + "asc";
}
sr.Close();
fs.Close();
return dt;
}
}
4.定義數據類型
有了測試數據和數據轉換工具還不夠,還需要一個能被xUnit使用的類型,就是目錄結構中的ProviderTypeData類。
public class ProviderTypeData : TheoryData<string, string, string>
{
public ProviderTypeData(string csvPath)
{
var path = Common.CurrentPath + csvPath;
var dt = CSVFileHelper.OpenCSV(path);
foreach (DataRow dr in dt.Rows)
{
Add(dr[0].ToString(), dr[1].ToString(), dr[2].ToString());
}
}
}
父類TheoryData的泛型參數與數據源的列一一對應,測試數據有三列,所以就有三個泛型參數。
然后使用父類的Add方法加載解析好的數據。
5.編寫測試
public class ProviderTypeTest
{
//測試數據
public static ProviderTypeData providerTypeData_AddProviderType = new ProviderTypeData(
"\\TestDatas\\ProviderTypeData_AddProviderType.csv");
public ProviderTypeTest()
{
}
[Trait("TPS", "供應商分類")]
[Theory(DisplayName = "0001_驗證數據_空數據_拋出")]
[MemberData("providerTypeData_AddProviderType")]
public void ValidData_EmptyData_ThrowException(
string providerTypeName, string providerCode, string parentCode)
{
//do test
}
}
簡單說明一下:
1.測試數據需要是公共靜態屬性,在聲明時實例化。
2.xUnit與MSTest在特性和斷言的使用上有區別,見附錄。
3.Trait特性聲明了測試的分類,可以在VS的測試資源管理器中按特征查看。
4.Theory特性聲明當前測試方法需要測試數據作為參數。
5.如果定義了Skip的值,那么測試將會被自動跳過。
[Theory(DisplayName = "0001_驗證數據_空數據_拋出", Skip = "未完成")]
6.MemberData特性聲明了測試需要的數據源。
調試測試,結果如下:
有三條測試數據,就會執行三次測試,測試結果如下:
(請忽略測試的時間,因為我在截圖調試結果)
以上,我們就可以實現數據驅動的測試。
附錄
Attribute標記對比:
NUnit 2.2 | MSTest | xUnit.net | 備注
-|-|-
[Test] | [TestMethod] | [Fact] | 標記為測試方法
[TestFixture] | [TestClass] | n/a | 包含有測試方法的類,在xUnit.net中無需標記,它會查找程序集中所有的public的測試方法
[ExpectedException] | [ExpectedException] | Assert.Throws/ Record.Exception | 期望拋出異常
[SetUp] | [TestInitialize] | Constructor(即構造函數) | 在每個測試方法執行之前用于初始化的方法
[TearDown] | [TestCleanup] | IDisposable.Dispose | 在每個測試方法執行之后用于結束的方法
[TestFixtureSetUp] | [ClassInitialize] | IUseFixture<T> | 在所有測試方法執行之前用于初始化的方法
[TestFixtureTearDown] | [ClassCleanup] | IUseFixture<T> | 在所有測試方法執行之后用于結束的方法
[Ignore] | [Ignore] | [Fact(Skip="reason")] | 臨時忽略被標記的方法
n/a | [Timeout] | [Fact(Timeout=n)] | 用于指定被測試方法的最大執行時間(單位毫秒),如果超過指定時間則會被標記為測試失敗
[Property] | [TestProperty] | [Trait] | 設置特征
n/a | [DataSource] | [Theory], [XxxData] | 測試數據
Assertions斷言對比:
NUnit 2.2 | MSTest | xUnit.net | 備注
-|-|-
AreEqual | AreEqual | Equal | 相等比較
AreNotEqual | AreNotEqual | NotEqual | 不相等比較
AreNotSame | AreNotSame | NotSame | 不相同比較
AreSame | AreSame | Same | 相同比較
Contains | Contains (on CollectionAssert) | Contains | 包含
DoAssert | n/a | n/a |
n/a | DoesNotContain (on CollectionAssert) | DoesNotContain | 不包含
n/a | n/a | DoesNotThrow | 沒有拋異常
Fail | Fail | n/a | 可用Assert.True(false, "message")替代
Greater | n/a | n/a | 可用Assert.True(x > y)替代
Ignore | Inconclusive | n/a |
n/a | n/a | InRange | 確保數據在某個范圍內
IsAssignableFrom | n/a | IsAssignableFrom |
IsEmpty | n/a | Empty | 為空
IsFalse | IsFalse | False | 為假
IsInstanceOfType | IsInstanceOfType | IsType |
IsNaN | n/a | n/a | 可用Assert.True(double.IsNaN(x))替代
IsNotAssignableFrom | n/a | n/a | 可用Assert.False(obj is Type)替代
IsNotEmpty | n/a | NotEmpty | 不為空
IsNotInstanceOfType | IsNotInstanceOfType | IsNotType |
IsNotNull | IsNotNull | NotNull |
IsNull | IsNull | Null |
IsTrue | IsTrue | True |
Less | n/a | n/a | 可用Assert.True(x < y)替代
n/a | n/a | NotInRange | 確保數據在不某個范圍內
n/a | n/a | Throws | 確保會拋出異常