NUnit的简单使用示例

     这个礼拜准备了一下给部门内其他同事进行单元测试的培训文档，文档中包含了一些示例，其中有一个示例用于展示NUnit中的一些主要的、常用的Attribute的使用方式。我把这个示例发出来，希望能够对初次使用NUnit的朋友有所帮助。例子很简单，如果熟悉NUnit的朋友就不用看了。

  1using System;
  2
  3/**//*
  4在测试类中，我们需要导入NUnit.Framework命名空间，这个命名空间内包含了Attribute的定义，Assert类
  5的实现等等。一般来说，我们仅需要引用这个命名空间就足够了。
  6*/
  7using NUnit.Framework;
  8
  9/**//*
 10<readme>
 11    <名词解释>
 12        自动化单元测试工具：这里指的是NUnit框架中的nunit-gui.exe和nunit-console.exe
 13        绿条/绿灯：在nunit-gui.exe中，如果一个测试方法显示为绿条/绿灯，表示测试通过。
 14        黄条/黄灯：在nunit-gui.exe中，如果一个测试方法显示为黄条/黄灯，表示测试未执行。
 15        红条/红灯：在nunit-gui.exe中，如果一个测试方法显示为红条/红灯，表示测试不通过。
 16    </名词解释>
 17</readme>  
 18*/
 19namespace PresentAttributes
 20{
 21    /**//// <summary>
 22    /// 展示NUnit中的一些主要的、常用的Attribute,以及使用方式
 23    /// </summary>
 24    
 25    /**//*
 26    每一个测试类都必须使用TestFixtureAttribute来标识，自动化单元测试工具认为没有TestFixtureAttribute
 27    标识的类不是一个测试类，即使类里面包含测试方法。类TestClassHasNoTestFixtureAttribute是一个相关的
 28    示例。
 29    */
 30    [TestFixture]
 31    public class PresentAttributes
 32    {
 33        NUnit对测试类的构造函数的要求#region NUnit对测试类的构造函数的要求
 34        /**//// <summary>
 35        /// 对于每一个测试类，NUnit要求提供一个公有的无参的构造函数，这是因为在自动化单元测试工具在运
 36        /// 行时，需要通过反射的方式构造一个测试类的实例，如果测试类没有提供无参数的构造函数，而仅提供了
 37        /// 一些有参数的构造函数，那么自动化单元测试工具将不知道如何去构造测试类实例。
 38        /// </summary>
 39        public PresentAttributes()
 40        {
 41        }
 42        #endregion
 43
 44        NUnit对测试方法的要求#region NUnit对测试方法的要求
 45        /**//*
 46        对于每一个测试方法，NUnit要求该方法是一个公有的无参数的且返回值为void的方法。这也是因为在
 47        自动化单元测试工具在运行时，需要通过反射的方式去执行测试方法，如果测试方法包含参数或有
 48        返回值，自动化单元测试工具认为此方法错误，并自动忽略执行此方法。
 49        如下所示意的TestMethod1、TestMethod2、TestMethod3这3个方法，在nunit-gui.exe中自动运行时
 50        ，都将显示黄条。
 51        */
 52        [Test]
 53        public int TestMethod1()
 54        {
 55            //do some test 
 56            return 0;
 57        }
 58        [Test]
 59        public void TestMethod2(int pPara1)
 60        {
 61        }
 62        [Test]
 63        private void TestMethod3()
 64        {
 65        }
 66        #endregion
 67
 68        简单断言演示#region 简单断言演示
 69        [Test]
 70        public void TestMethod4()
 71        {
 72            object obj1    =new object();
 73            object obj2    =new object();
 74            Assert.AreNotEqual(obj1,obj2);    //这就是一个断言，在单元测试中，主要通过断言来对被测代码
 75                                            //进行验证
 76        }
 77        #endregion
 78
 79        期望测试方法抛出指定类型的异常#region 期望测试方法抛出指定类型的异常
 80        /**//*
 81        NUnit中使用ExpectedExceptionAttribute来告诉自动化单元测试工具，该测试方法期望抛出一个指定类型
 82        的异常。测试方法抛出的异常必须是指定的类型，即使该方法抛出的异常是指定类型的异常的子类，自动
 83        化单元测试工具都将认为测试不通过（如TestMethod6所演示的）。 
 84        */
 85
 86        [Test]
 87        [ExpectedException(typeof(System.Exception))]
 88        public void TestMethod5()
 89        {
 90            throw new Exception("这是一个异常");
 91        }
 92
 93        [Test]
 94        [ExpectedException(typeof(System.Exception))]
 95        public void TestMethod6()
 96        {
 97            throw new ApplicationException("");    //在.Net中，所有的异常都继承自System.Exception,
 98                                                //ApplicationException当然也不例外
 99        }
100        #endregion
101
102        断言原理探讨#region 断言原理探讨
103        /**//*
104        断言是一个被NUnit封装的方法，该方法接受一个可进行判断的表达式或值，验证该表达式的结果或
105        值是否是期望的，如果不是所期望的，则方法抛出一个AssertionException异常。整个自动化框架对于被
106        测试代码的验证都是建立在异常的基础上的。
107        下面的测试方法TestMethod7将对这个观点进行验证。该方法内部将执行一个断言失败的方法，但测试方法
108        定义为期待抛出异常AssertionException，因此，整个测试方法在自动化单元测试工具中将显示为绿条。 
109        
110        Note:因为断言的验证是建立在异常的基础上的，因此，在一个测试方法中，如果包含1个以上的断言，之前
111        失败的断言将导致之后的断言不被执行。
112        */
113
114        [Test]
115        [ExpectedException(typeof(NUnit.Framework.AssertionException))]
116        public void TestMethod7()
117        {
118            Assert.IsTrue(false);
119        }
120        #endregion
121
122        我们希望在测试类中的所有测试方法执行之前建立测试环境#region 我们希望在测试类中的所有测试方法执行之前建立测试环境
123        /**//*
124        如果希望实现这个目的，你可以使用TestFixtureSetUpAttribute。在一个测试类中，最多只能有一个方法有
125        TestFixtureSetUpAttribute特性，如果有多个方法有TestFixtureSetUpAttribute，那么整个测试类的测试
126        方法都将不被执行。因为贴有TestFixtureSetUp特性的方法其实并不是一个测试方法，所以，该方法不需要
127        贴上TestAttribute特性。
128        Init方法是一个演示，你可以查看nunit-gui.exe中右下的Console.Out面板来验证。
129        */
130        [TestFixtureSetUp]
131        public void Init()
132        {
133            //使当前线程中止1秒，从而通过时间差异显示出方法执行的顺序
134            System.Threading.Thread.Sleep(1000);
135            Console.Write(string.Format("[TestFixtureSetUp]测试类的测试环境已经初始化好了,方法执行于:{0}!\r\n",DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")));
136        }
137        #endregion
138
139        我们希望在测试类中的所有测试方法执行完之后还原测试环境#region 我们希望在测试类中的所有测试方法执行完之后还原测试环境
140        /**//*
141        如果希望实现这个目的，你可以使用TestFixtureTearDownAttribute。在一个测试类中，最多只能有一个方法有
142        TestFixtureTearDownAttribute特性，如果有多个方法有TestFixtureTearDownAttribute，那么整个测试类的测试
143        方法都将不被执行。因为贴有TestFixtureTearDownAttribute特性的方法其实并不是一个测试方法，所以，该方法
144        不需要贴上TestAttribute特性。
145        Revert方法是一个演示，你可以查看nunit-gui.exe中右下的Console.Out面板来验证。
146        */
147        [TestFixtureTearDown]
148        public void Revert()
149        {
150            //使当前线程中止1秒，从而通过时间差异显示出方法执行的顺序
151            System.Threading.Thread.Sleep(1000);
152            Console.Write(string.Format("[TestFixtureTearDown]测试类的测试环境已经还原好了,方法执行于:{0}!\r\n",DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")));
153        }
154        #endregion
155
156        我们希望在测试类中的每一个测试方法执行之前建立测试环境#region 我们希望在测试类中的每一个测试方法执行之前建立测试环境
157        /**//*
158        如果希望实现这个目的，你可以使用SetUpAttribute。在一个测试类中，最多只能有一个方法有SetUpAttribute
159        特性，如果有多个方法有SetUpAttribute，那么整个测试类的测试方法都将不被执行。因为贴有SetUpAttribute
160        特性的方法其实并不是一个测试方法，所以，该方法不需要贴上TestAttribute特性。
161        InitBeforeEveryTestMethod方法是一个演示，你可以查看nunit-gui.exe中右下的Console.Out面板来验证。
162        */
163        [SetUp]
164        public void InitBeforeEveryTestMethod()
165        {
166            //使当前线程中止1秒，从而通过时间差异显示出方法执行的顺序
167            System.Threading.Thread.Sleep(1000);
168            Console.Write(string.Format("[SetUp]测试方法的测试环境已经初始化好了,方法执行于:{0}!\r\n",DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")));
169        }
170        #endregion
171
172        我们希望在测试类中的每一个测试方法执行完之后还原测试环境#region 我们希望在测试类中的每一个测试方法执行完之后还原测试环境
173        /**//*
174        如果希望实现这个目的，你可以使用TearDownAttribute。在一个测试类中，最多只能有一个方法有TearDownAttribute
175        特性，如果有多个方法有TearDownAttribute，那么整个测试类的测试方法都将不被执行。因为贴有TearDownAttribute
176        特性的方法其实并不是一个测试方法，所以，该方法不需要贴上TestAttribute特性。
177        RevertAfterEveryTestMethod方法是一个演示，你可以查看nunit-gui.exe中右下的Console.Out面板来验证。
178        */
179        [TearDown]
180        public void RevertAfterEveryTestMethod()
181        {
182            //使当前线程中止1秒，从而通过时间差异显示出方法执行的顺序
183            System.Threading.Thread.Sleep(1000);
184            Console.Write(string.Format("[TearDown]测试方法的测试环境已经还原好了,方法执行于:{0}!\r\n",DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")));
185        }
186        #endregion
187    }
188}
189

 1using System;
 2using NUnit.Framework;
 3
 4namespace PresentAttributes
 5{
 6    /**//// <summary>
 7    /// TestClassHasNoTestFixtureAttribute 的摘要说明。
 8    /// </summary>
 9    public class TestClassHasNoTestFixtureAttribute
10    {
11        public TestClassHasNoTestFixtureAttribute()
12        {
13        }
14
15        [Test]
16        public void TestMethod1()
17        {
18        }
19    }
20}
21