使用xUnit.net進行數據驅動的單元測試

目前在.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中編輯的結果如下:

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 | 確保會拋出異常

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容