NUnit使用

NUnit是.net平台上使用得最为广泛的测试框架之一，本文将通过示例来描述NUnit的使用方法，并提供若干编写单元测试的建议和技巧，供单元测试的初学者参考。

继续下文之前，先来看看一个非常简单的测试用例（TestCase）：

1. [Test]
2. public void AdditionTest()
3. {
4. int expectedResult = 2;
5. Assert.AreEqual(exptectedResult, 1 + 1);
6. }

你肯定会说这个TestCase也太白痴了吧！这也是许多NUnit文档被人诟病的一点，但是我的理解并不是这样，xUnit本来就是编写UT的简易框架，keep it simple and stupid，任何通过复杂的TestCase来介绍NUnit的用法都是一种误导，UT复杂之处在于如何在实际项目中应用和实施，而不是徘徊于该如何使用NUnit。
主要内容：
1、NUnit的基本用法
2、测试用例的组织
3、NUnit的断言(Assert)
4、常用单元测试工具介绍
一、NUnit的基本用法
和其他xNUnit框架不同的是，NUnit框架使用Attribute（如前面代码中的[Test]）来描述测试用例的，也就是说我们只要掌握了 Attribute的用法，也就基本学会如何使用NUnit了。VSTS所集成的单元测试也支持类似NUnit的Attributes，下表对比了 NUnit和VSTS的标记：

usage	NUnit attributes	VSTS attributes
标识测试类	TestFixture	TestClass
标识测试用例（TestCase）	Test	TestMethod
标识测试类初始化函数	TestFixtureSetup	ClassInitialize
标识测试类资源释放函数	TestFixtureTearDown	ClassCleanup
标识测试用例初始化函数	Setup	TestInitialize
标识测试用例资源释放函数	TearDown	TestCleanUp
标识测试用例说明	N/A	Description
标识忽略该测试用例	Ignore	Ignore
标识该用例所期望抛出的异常	ExpectedException	ExpectedException
标识测试用例是否需要显式执行	Explicit	?
标识测试用例的分类	Category	?

现在，让我们找一个场景，通过示例来了解上述NUnit标记的用法。来看看一个存储在数据库中的数字类：
这是我们常见的DAL+Entity的设计，DigitDataProvider和Digit类的实现代码如下：
1）Digit.cs类：

1. using System;
2. using System.Data;
3. namespace Product
4. {
5. /// <summary>
6. /// Digit 的摘要说明
7. /// </summary>
8. /// 创 建 人: Aero
9. /// 创建日期: 2006-3-22
10. /// 修 改 人:
11. /// 修改日期:
12. /// 修改内容:
13. /// 版    本:
14. public class Digit
15. {
16. private Guid _digitId;
17. public Guid DigitID
18. {
19. get { return this._digitId; }
20. set { this._digitId = value; }
21. }
22. private int _value = 0;
23. public int Value
24. {
25. get { return this._value; }
26. set { this._value = value; }
27. }
28. #region 构造函数
29. /// <summary>
30. /// 默认无参构造函数
31. /// </summary>
32. /// 创 建 人: Aero
33. /// 创建日期: 2006-3-22
34. /// 修 改 人:
35. /// 修改日期:
36. /// 修改内容:
37. public Digit()
38. {
39. //
40. // TODO: 在此处添加构造函数逻辑
41. //
42. }
43. /// <summary>
44. /// construct the digit object from a datarow
45. /// </summary>
46. /// <param name="row"></param>
47. public Digit(DataRow row)
48. {
49. if (row == null)
50. {
51. throw new ArgumentNullException();
52. }
53. if (row["DigitID"] != DBNull.Value)
54. {
55. this._digitId = new Guid(row["DigitID"].ToString());
56. }
57. if (row["Value"] != DBNull.Value)
58. {
59. this._value = Convert.ToInt32(row["Value"]);
60. }
61. }
62. #endregion
63. }
64. }

2）DigitDataProvider类：

1. using System;
2. using System.Data;
3. using System.Data.SqlClient;
4. using System.Collections;
5. namespace Product
6. {
7. /// <summary>
8. /// DigitDataProvider 的摘要说明
9. /// </summary>
10. /// 创 建 人: Aero
11. /// 创建日期: 2006-3-22
12. /// 修 改 人:
13. /// 修改日期:
14. /// 修改内容:
15. /// 版    本:
16. public class DigitDataProvider
17. {
18. /// <summary>
19. /// 定义数据库连接
20. /// </summary>
21. private SqlConnection _dbConn;
22. public SqlConnection Connection
23. {
24. get { return this._dbConn; }
25. set { this._dbConn = value; }
26. }
27. #region 构造函数
28. /// <summary>
29. /// 默认无参构造函数
30. /// </summary>
31. /// 创 建 人: Aero
32. /// 创建日期: 2006-3-22
33. /// 修 改 人:
34. /// 修改日期:
35. /// 修改内容:
36. public DigitDataProvider()
37. {
38. //
39. // TODO: 在此处添加构造函数逻辑
40. //
41. }
42. public DigitDataProvider(SqlConnection conn)
43. {
44. this._dbConn = conn;
45. }
46. #endregion
47. #region 成员函数定义
48. /// <summary>
49. /// retrieve all Digits in the database
50. /// </summary>
51. /// <returns></returns>
52. public ArrayList GetAllDigits()
53. {
54. // retrieve all digit record in database
55. SqlCommand command = this._dbConn.CreateCommand();
56. command.CommandText = "SELECT * FROM digits";
57. SqlDataAdapter adapter = new SqlDataAdapter(command);
58. DataSet results = new DataSet();
59. adapter.Fill(results);
60. // convert rows to digits collection
61. ArrayList digits = null;
62. if (results != null && results.Tables.Count > 0)
63. {
64. DataTable table = results.Tables[0];
65. digits = new ArrayList(table.Rows.Count);
66. foreach (DataRow row in table.Rows)
67. {
68. digits.Add(new Digit(row));
69. }
70. }
71. return digits;
72. }
73. /// <summary>
74. /// remove all digits from the database
75. /// </summary>
76. /// <returns></returns>
77. public int RemoveAllDigits()
78. {
79. // retrieve all digit record in database
80. SqlCommand command = this._dbConn.CreateCommand();
81. command.CommandText = "DELETE FROM digits";
82. return command.ExecuteNonQuery();
83. }
84. /// <summary>
85. /// retrieve and return the entity of given value
86. /// </summary>
87. /// <exception cref="System.NullReferenceException">entity not exist in the database</exception>
88. /// <param name="value"></param>
89. /// <returns></returns>
90. public Digit GetDigit(int value)
91. {
92. // retrieve entity of given value
93. SqlCommand command = this._dbConn.CreateCommand();
94. command.CommandText = "SELECT * FROM digits WHERE Value='" + value + "'";
95. SqlDataAdapter adapter = new SqlDataAdapter(command);
96. DataSet results = new DataSet();
97. adapter.Fill(results);
98. // convert rows to digits collection
99. Digit digit = null;
100. if (results != null && results.Tables.Count > 0
101. && results.Tables[0].Rows.Count > 0)
102. {
103. digit = new Digit(results.Tables[0].Rows[0]);
104. }
105. else
106. {
107. throw new NullReferenceException("not exists entity of given value");
108. }
109. return digit;
110. }
111. /// <summary>
112. /// remove prime digits from database
113. /// </summary>
114. /// <returns></returns>
115. public int RemovePrimeDigits()
116. {
117. throw new NotImplementedException();
118. }
119. #endregion
120. }
121. }

3）新建测试数据库：

1. CREATE TABLE [dbo].[digits] (
2. [DigitID] [uniqueidentifier] NOT NULL ,
3. [Value] [int] NOT NULL
4. ) ON [PRIMARY]
5. GO

下面，我们开始尝试为DigitDataProvider类编写UT，新建DigitDataProviderTest.cs类。
1、添加nunit.framework引用：

并在DigitDataProviderTest.cs中添加：

using NUnit.Framework;

2、编写测试用例
1）标识测试类：NUnit要求每个测试类都必须添加TestFixture的Attribute，并且携带一个public无参构造函数。

1. [TestFixture]
2. public class DigitProviderTest
3. {
4. public DigitProviderTest()
5. {
6. }
7. }

2）编写DigitDataProvider.GetAllDigits()的测试函数

1. /// <summary>
2. /// regular test of DigitDataProvider.GetAllDigits()
3. /// </summary>
4. [Test]
5. public void TestGetAllDigits()
6. {
7. // initialize connection to the database
8. // note: change connection string to ur env
9. IDbConnection conn = new SqlConnection(
10. "Data source=localhost;user id=sa;password=sa;database=utdemo");
11. conn.Open();
12. // preparing test data
13. IDbCommand command = conn.CreateCommand();
14. string commadTextFormat = "INSERT INTO digits(DigitID, Value) VALUES('{0}', '{1}')";
15. for (int i = 1; i <= 100; i++)
16. {
17. command.CommandText = string.Format(commadTextFormat, Guid.NewGuid().ToString(), i.ToString());
18. command.ExecuteNonQuery();
19. }
20. // test DigitDataProvider.GetAllDigits()
21. int expectedCount = 100;
22. DigitDataProvider provider = new DigitDataProvider(conn as SqlConnection);
23. IList results = provider.GetAllDigits();
24. // that works?
25. Assert.IsNotNull(results);
26. Assert.AreEqual(expectedCount, results.Count);
27. // delete test data
28. command = conn.CreateCommand();
29. command.CommandText = "DELETE FROM digits";
30. command.ExecuteNonQuery();
31. // close connection to the database
32. conn.Close();
33. }

什么？很丑？很麻烦？这个问题稍后再讨论，先来看看一个完整的测试用例该如何定义：

1. [Test]
2. public void TestCase()
3. {
4. // 1) initialize test environement, like database connection
5. // 2) prepare test data, if neccessary
6. // 3) test the production code by using assertion or Mocks.
7. // 4) clear test data
8. // 5) reset the environment
9. }

NUnit要求每一个测试函数都可以独立运行（往往有人会误解NUnit并按照Consoler中的排序来执行），这就要求我们在调用目标函数之前先要初始化目标函数执行所需要的环境，如打开数据库连接、添加测试数据等。为了不影响其他的测试函数，在调用完目标函数后，该测试函数还要负责还原初始环境，如删除测试数据和关闭数据库连接等。对于同一测试类里的测试函数来说，这些操作往往是相同的，让我们对上面的代码进行一次Refactoring， Extract Method：

1. /// <summary>
2. /// connection to database
3. /// </summary>
4. private static IDbConnection _conn;
5. /// <summary>
6. /// 初始化测试类所需资源
7. /// </summary>
8. [TestFixtureSetUp]
9. public void ClassInitialize()
10. {
11. // note: change connection string to ur env
12. DigitProviderTest._conn = new SqlConnection(
13. "Data source=localhost;user id=sa;password=sa;database=utdemo");
14. DigitProviderTest._conn.Open();
15. }
16. /// <summary>
17. /// 释放测试类所占用资源
18. /// </summary>
19. [TestFixtureTearDown]
20. public void ClassCleanUp()
21. {
22. DigitProviderTest._conn.Close();
23. }
24. /// <summary>
25. /// 初始化测试函数所需资源
26. /// </summary>
27. [SetUp]
28. public void TestInitialize()
29. {
30. // add some test data
31. IDbCommand command = DigitProviderTest._conn.CreateCommand();
32. string commadTextFormat = "INSERT INTO digits(DigitID, Value) VALUES('{0}', '{1}')";
33. for (int i = 1; i <= 100; i++)
34. {
35. command.CommandText = string.Format(
36. commadTextFormat, Guid.NewGuid().ToString(), i.ToString());
37. command.ExecuteNonQuery();
38. }
39. }
40. /// <summary>
41. /// 释放测试函数所需资源
42. /// </summary>
43. [TearDown]
44. public void TestCleanUp()
45. {
46. // delete all test data
47. IDbCommand command = DigitProviderTest._conn.CreateCommand();
48. command.CommandText = "DELETE FROM digits";
49. command.ExecuteNonQuery();
50. }
51. /// <summary>
52. /// regular test of DigitDataProvider.GetAllDigits()
53. /// </summary>
54. [Test]
55. public void TestGetAllDigits()
56. {
57. int expectedCount = 100;
58. DigitDataProvider provider =
59. new DigitDataProvider(DigitProviderTest._conn as SqlConnection);
60. IList results = provider.GetAllDigits();
61. // that works?
62. Assert.IsNotNull(results);
63. Assert.AreEqual(expectedCount, results.Count);
64. }

NUnit提供了以下Attribute来支持测试函数的初始化：
TestFixtureSetup：在当前测试类中的所有测试函数运行前调用；
TestFixtureTearDown：在当前测试类的所有测试函数运行完毕后调用；
Setup：在当前测试类的每一个测试函数运行前调用；
TearDown：在当前测试类的每一个测试函数运行后调用。

3）编写DigitDataProvider.RemovePrimeDigits()的测试函数
唉，又忘了质数判断的算法，这个函数先不实现（throw new NotImplementedException()），对应的测试函数先忽略。

1. /// <summary>
2. /// regular test of DigitDataProvider.RemovePrimeDigits
3. /// </summary>
4. [Test, Ignore("Not Implemented")]
5. public void TestRemovePrimeDigits()
6. {
7. DigitDataProvider provider =
8. new DigitDataProvider(DigitProviderTest._conn as SqlConnection);
9. provider.RemovePrimeDigits();
10. }

Ignore的用法：

Ignore(string reason)

4）编写DigitDataProvider.GetDigit()的测试函数
当查找一个不存在的Digit实体时，GetDigit()会不会像我们预期一样抛出NullReferenceExceptioin呢？

1. /// <summary>
2. /// Exception test of DigitDataProvider.GetDigit()
3. /// </summary>
4. [Test, ExpectedException(typeof(NullReferenceException))]
5. public void TestGetDigit()
6. {
7. int expectedValue = 999;
8. DigitDataProvider provider = new DigitDataProvider(DigitProviderTest._conn as SqlConnection);
9. Digit digit = provider.GetDigit(expectedValue);
10. }

ExpectedException的用法

ExpectedException(Type t)
ExpectedException(Type t, string expectedMessage)

在NUnitConsoler里执行一把，欣赏一下黄绿灯吧。本文相关代码可从UTDemo_Product.rar下载。
二、测试函数的组织
现在有一个性能测试的Testcase，执行一次要花上一个小时，我们并不需要（也无法忍受）每次自动化测试时都去执行这样的Testcase，使用NUnit的Explicit标记可以让这个TestCase只有在显示调用下才会执行：

1. [Test, Explicit]
2. public void OneHourTest()
3. {
4. //
5. }

不幸的是，这样耗时的TestCase在整个测试工程中可能有数十个，或许更多，我们能不能把这些TestCase都组织起来，要么一起运行，要么不运行呢？NUnit提供的Category标记可实现此功能：

1. [Test, Explicit, Category("LongTest")]
2. public void OneHourTest()
3. {
4. ...
5. }
6. [Test, Explicit, Category("LongTest")]
7. public void TwoHoursTest()
8. {
9. ...
10. }

这样，只有当显示选中LongTest分类时，这些TestCase才会执行

三、NUnit的断言
NUnit提供了一个断言类NUnit.Framework.Assert，可用来进行简单的state base test(见idior的Enterprise Test Driven Develop)，可别对这个断言类期望太高，在实际使用中，我们往往需要自己编写一些高级断言。
常用的NUnit断言有：

method	usage	example
Assert.AreEqual(object expected, object actual[, string message])	验证两个对象是否相等	Assert.AreEqual(2, 1+1)
Assert.AreSame(object expected, object actual[, string message])	验证两个引用是否指向同意对象	object expected = new object(); object actual = expected; Assert.AreSame(expected, actual)
Assert.IsFalse(bool)	验证bool值是否为false	Assert.IsFalse(false)
Assert.IsTrue(bool)	验证bool值是否为true	Assert.IsTrue(true)
Assert.IsNotNull(object)	验证对象是否不为null	Assert.IsNotNull(new object())
Assert.IsNull(object)	验证对象是否为null	Assert.IsNull(null);

这里要特殊指出的Assert.AreEqual只能处理基本数据类型和实现了Object.Equals接口的对象的比较，对于我们自定义对象的比较，通常需要自己编写高级断言，这个问题郁闷了我好一会，下面给出一个用于level=1的情况下的对象比较的高级断言的实现：

1. public class AdvanceAssert
2. {
3. /// <summary>
4. /// 验证两个对象的属性值是否相等
5. /// </summary>
6. /// <remarks>
7. /// 目前只支持的属性深度为1层
8. /// </remarks>
9. public static void AreObjectsEqual(object expected, object actual)
10. {
11. // 若为相同引用，则通过验证
12. if (expected == actual)
13. {
14. return;
15. }
16. // 判断类型是否相同
17. Assert.AreEqual(expected.GetType(), actual.GetType());
18. // 测试属性是否相等
19. Type t = expected.GetType();
20. PropertyInfo[] properties = t.GetProperties(BindingFlags.Instance | BindingFlags.Public);
21. foreach (PropertyInfo property in properties)
22. {
23. object obj1 = t.InvokeMember(property.Name,
24. BindingFlags.Instance | BindingFlags.Public | BindingFlags.GetProperty,
25. null, expected, null);
26. object obj2 = t.InvokeMember(property.Name,
27. BindingFlags.Instance | BindingFlags.Public | BindingFlags.GetProperty,
28. null, actual, null);
29. // 判断属性是否相等
30. AdvanceAssert.AreEqual(obj1, obj2, "assertion failed on " + property.Name);
31. }
32. }
33. /// <summary>
34. /// 验证对象是否相等
35. /// </summary>
36. private static void AreEqual(object expected, object actual, string message)
37. {
38. Type t = expected.GetType();
39. if (t.Equals(typeof(System.DateTime)))
40. {
41. Assert.AreEqual(expected.ToString(), actual.ToString(), message);
42. }
43. else
44. {
45. // 默认使用NUnit的断言
46. Assert.AreEqual(expected, actual, message);
47. }
48. }
49. }

四、常用单元测试工具介绍：
1、NUnit：目前最高版本为2.2.7（也是本文所使用的NUnit的版本）
下载地址：http://www.nunit.org
2、TestDriven.Net：一款把NUnit和VS IDE集成的插件

下载地址：http://www.testdriven.net/
3、NUnit2Report：和nant结合生成单元测试报告
下载地址：http://nunit2report.sourceforge.net
4、Rhino Mocks 2：个人认为时.net框架下最好的mocks库，而且支持.net 2.0, rocks~!
下载地址：http://www.ayende.com/projects/rhino-mocks.aspx

出处：http://blog.csdn.net/fogle/article/details/5690510