天天看点

NUnit使用详解

NUnit是一个单元测试框架,专门针对于.NET来写的,它是是xUnit的一员。NUnit完全由C#语言来编写,并且编写时充分利用了许多.NET的特性,比如反射,客户属性等等.

最重要的一点是它适合于所有.NET语言.

单元测试:

作为程序员在开发过程中,不可避免地要对软件的类及其方法进行测试。

在Web页面的测试过程中,好多朋友喜欢把测试结果使用Response.Write()显示在页面上。而在类库组件的开发时,由于没有可视化界面,有时不得不为该类库添模一个测试的项目(Console,WinForm,ASP.NET等),在该项目中调用类库组件的功能,以查看测试结果。

上面这种测试不是我们推荐的方法,因为我们在测试的时候应遵循以下原则:

    尽量不要破坏原有的代码结构,即不要在原代码中添加一些冗余的测试代码。

    测试模块应尽可能完整地展现测试结果。

    测试模块不应用完即扔掉,要保存以备后续的维护测试。

一、NUnit运行界面

NUnit使用详解

《图1》

在右边有一个进度条,如果所有测试案例运行成功,就为绿色,反之如果有一个不成功,则为红色,但也有黄色的.

    绿色 描述目前所执行的测试都通过

    黄色 意味某些测试忽略,但是这里没有失败

    红色 表示有失败

左边的树状目录是我们们编写的每一个测试单元。

底部的状态条

    状态:当所有测试完成时,状态变为Completed.运行测试中,状态是Running: <test-name>

    Test Cases:说明加载的程序集中测试案例的总个数。这也是测试树里叶子节点的个数。

    Tests Run: 已经完成的测试个数。

    Failures: 到目前为止,所有测试中失败的个数.

    Time: 显示运行测试时间(以秒计)

二、在VS2008中配置NUnit进行测试

    1.新建一个类库项目。

    2.在解决方案中的项目图标上右击,选择“属性”。

    3.点击左边的“调试”标签

    4.在“启动操作”中选择“启动外部程序”,并指明NUnit程序的运行路径。

    5.在启动选项中的“工作目录”下,指明当前类库项目的DLL文件的所在路径。

NUnit使用详解

    《图2》

    6.运行当前类库项目,我们会发现NUnit被启动起来了。

三、安装Unit与使用

    请到http://www.nunit.org/download.html下载NUnit,然后双击安装即可。

    1.我们要使用NUnit对类库组件进行测试时,一般我们会新建一个测试类文件或新建一个测试项目。

    2.为测试项目添加引用“nunit.framework”

    3.在测试类文件中添加using NUnit.Framework;语句

    4.在该类文件或测试项目中编写测试代码,然后使用NUnit运行我们的测试代码以观察测试结果。

四、NUnit中的常用Attribute

所有NUnit属性都包含在Nunit.Framework命名空间里。测试项目必须引用框架的程序集,即nunit.framework.dll.

1.TestFixtureAttribute

    用来修饰测试类。这个属性标记一个类包含了测试方法。

    被TestFixtureAttribute修饰的类需满足以下限制

        a.必须是一个public类型,否则NUnit不会识别它。

        b.它必须有一个缺省的构造子,否则Nunit不能构建他。

        c.构造子不应该有任何方面的负面影响,因为在一个对话的过程中,NUnit可能构造类多次。

        如:

        using System;

        using NUnit.Framework;

       [TestFixture]

        public class SuccessTests

        {

        // ...

        }

2.TestAttribute

    用来修饰测试方法。Test属性标记某个类的某个方法为一个测试方法,而且此类必需已经标记为一个TestFixture。

    一个测试方法的签名定义如下:

        public void MethodName()

    注意:测试方法必须没有参数。如果程序员将测试方法标记为不正确的签名,它不会运行。

        如:

        using System;

        using NUnit.Framework;

       [TestFixture]

        public class SuccessTests

        {

            [Test]

            public void Add()

            {

                //...

            }

        }

3.SetUpAttribute

    用来修饰方法。所属的类必需已经标记为一个TestFixture。一个TestFixture可以仅有一个SetUp方法。如果有多个定义,TestFixture也会编译成功,但是测试不会运行。SetUpAttribute标记的方法是在每个测试方法被调用之前来完成的。

        如:

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

            [SetUp]

            public void Init()

            { }

            [TearDown]

            public void Dispose()

            { }

            [Test]

            public void Add()

            { }

        }

    SetUp属性是从任何基类继承而来。因此,如果基类已经定义了一个SetUp方法,那么这个方法会在每个派生的类的测试方法之前调用。如果你打算在派生类里加入更多的SetUp功能,你需要将方法标记为适当的属性,然后调用基类方法。

    SetUpAttribute使用案例:

        如:我们以测试加减法为例

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class NumersFixture

        {

                    [Test]

                    public void AddTwoNumbers()

                    {

                                int a=1;

                                int b=2;

                                int sum=a+b;

                                Assert.AreEqual(sum,3);

                    }

                   [Test]

                    public void MultiplyTwoNumbers()

                    {

                                int a = 1;

                                int b = 2;

                                int product = a * b;

                                Assert.AreEqual(2, product);

                    }

        }

        不难看出两个测试方法中有重复的代码,如何去除重复的代码呢?我们可以提取这些代码到一个独立的方法,然后标志这个方法为SetUp 属性,这样2个测试方法可以共享对操作数的初始化了,这里是改动后的代码:

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class NumersFixture

        {

                    private int a;

                    private int b;

                   [SetUp]

                    public void InitializeOperands()

                    {

                                a = 1;

                                b = 2;

                    }

                    [Test]

                    public void AddTwoNumbers()

                    {

                                int sum=a+b;

                                Assert.AreEqual(sum,3);

                    }

                    [Test]

                    public void MultiplyTwoNumbers()

                    {

                                int product = a * b;

                                Assert.AreEqual(2, product);

                    }

        }

        这样NUnit将在执行每个测试前执行标记SetUp属性的方法.在本例中就是执行InitializeOperands()方法.记住,这里这个方法必须为public,不然就会有以下错误:Invalid Setup or TearDown method signature

4.TearDownAttribute

   用来修饰方法。所属的类必需已经标记为一个TestFixture。一个TestFixture可以仅有一个TearDown方法。如果有多个定义,TestFixture也会编译成功,但是测试不会运行。被TearDownAttribute修饰的方法是每个测试方法被调用之后来执行的。

        如:

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

            [SetUp]

            public void Init()

            { }

           [TearDown]

            public void Dispose()

            { }

            [Test]

            public void Add()

            { }

        }

    TearDown属性是从任何的基类继承而来。因此,如果基类已经定义了一个TearDown方法,那么这个方法会在每个派生的类的测试方法之后调用。如果你打算在派生类里加入更多的TearDown功能,你需要将方法标记为适当的属性,然后调用基类方法。

5.TestFixtureSetUpAttribute

    用来修饰方法。所属的类必需已经标记为一个TestFixture。这些个属性标记的方式在fixture任何测试执行之前完成。TestFixture可以仅有一个TestFixtureSetUp方法。如果定义了多个,TestFixture可以成功编译,但是测试不会被执行。

6.TestFixtureTearDownAttribute

    用来修饰方法。所属的类必需已经标记为一个TestFixture。这些个属性标记的方式在fixture任何测试执行之后完成。TestFixture可以仅有一个TestFixtureTearDownAttribute方法。如果定义了多个,TestFixture可以成功编译,但是测试不会被执行。

        如:

        namespace NUnit.Tests

        {

          using System;

          using NUnit.Framework;

          [TestFixture]

          public class SuccessTests

          {

           [TestFixtureSetUp]

            public void Init()

            { }

            [TestFixtureTearDown]

            public void Dispose()

            { }

            [Test]

            public void Add()

            { }

          }

        }

    SetUp/TearDown方法提供达到测试隔离性的目的.SetUp确保共享的资源在每个测试运行前正确初始化,TearDown确保没有运行测试产生的遗留副作用. TestFixtureSetUp/TestFixtureTearDown同样提供相同的目的,但是却在test fixture范围里

    我们写一个简单的测试来说明什么方法调用了,怎么合适调用

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class LifeCycleContractFixture

        {

            [TestFixtureSetUp]

            public void FixtureSetUp()

            {

                Console.Out.WriteLine("FixtureSetUp");

            }

            [TestFixtureTearDown]

            public void FixtureTearDown()

            {

                Console.Out.WriteLine("FixtureTearDown");

            }

            [SetUp]

            public void SetUp()

            {

                Console.Out.WriteLine("SetUp");

            }

            [TearDown]

            public void TearDown()

            {

                Console.Out.WriteLine("TearDown");

            }

           [Test]

            public void Test1()

            {

                Console.Out.WriteLine("Test 1");

            }

            [Test]

            public void Test2()

            {

                Console.Out.WriteLine("Test 2");

            }

        }

        运行结果:

        FixtureSetUp

        SetUp

        Test 1

        TearDown

        SetUp

        Test 2

        TearDown

        FixtureTearDown

7.ExpectedExceptionAttribute

    修饰方法,用来测试一个方法是否抛出了指定的异常。本属性有两种重载方式。第一种是一个Type,此Type为期望的异常的精确类型。 第二种是一个期望的异常全名的字符串。

    在执行测试时,如果它抛出了指定的异常,那么测试通过。如果抛出一个不同的异常,测试就失败。如果抛出了一个由期望异常继承而来的异常,这也是成功的。

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

           [Test]

            [ExpectedException(typeof(InvalidOperationException))]

            public void ExpectAnExceptionByType()

            { }

            [Test]

            [ExpectedException("System.InvalidOperationException")]

            public void ExpectAnExceptionByName()

            { }

        }

8.CategoryAttribute

    修饰方法或修饰类。用来把测试分组,可以使用NUnit的Categories选项卡选择要测试的组,或排除一些组。

    对类分组:

        using System;

        using NUnit.Framework;

        [TestFixture]

        [Category("LongRunning")]

        public class LongRunningTests

        {

        // ...

        }

    对方法分组:

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

            [Test]

            [Category("Long")]

            public void VeryLongTest()

            { }

        }

    下面我们编写三个测试方法,并分为两组“Compare”和“TestNull”,在NUnit中测试“Compare”组的内容:

    第一步:点击左侧的“Categories”选项卡

    第二步:在“Available Categories”列表框中选择“Compare”,点击“Add”按钮

    第三步:点击左侧“Test”选项卡,点击树状目录中的“Class1”,点击“Run”按钮

    我们发现只有TestTowInstanceName和TestTowInstanceEqual两个测试方法运行了,而TestNull没有运行,因此TestNull不是“Compare”组的。

NUnit使用详解

    《图3》

NUnit使用详解

《图4》

9.ExplicitAttribute

    用来修饰类或方法。Explicit属性会忽略一个测试或测试Fixture,直到它被显式的选择运行。。如果test和test fixture在执行的过程中被发现,就忽略他们。所以,这样一来进度条显示为黄色,因为有test或test fixture忽略了。

    修饰类:

        using System;

        using NUnit.Framework;

        [TestFixture, Explicit]

        public class ExplicitTests

        {

        // ...

        }

    修饰方法:

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

            [Test, Explicit]

            public void ExplicitTest()

            { }

        }

10.IgnoreAttribute

    用来修饰类或方法。由于种种原因,有一些测试我们不想运行.当然,这些原因可能包括你认为这个测试还没有完成,这个测试正在重构之中,这个测试的需求不是太明确.但你有不想破坏测试,不然进度条可是红色的哟.怎么办?使用Ignore属性.你可以保持测试,但又不运行它们。

    这个特性用来暂时不运行一个测试或fixture。比起注释掉测试或重命名方法,这是一个比较好的机制,因为测试会和余下的代码一起编译,而且在运行时有一个不会运行测试的标记,这样保证不会忘记测试。

    修饰类:

        using System;

        using NUnit.Framework;

        [TestFixture]

        [Ignore("Ignore a fixture")]

        public class SuccessTests

        {

        // ...

        }

    修饰方法

        using System;

        using NUnit.Framework;

        [TestFixture]

        public class SuccessTests

        {

            [Test]

            [Ignore("Ignore a test")]

            public void IgnoredTest()

            { }

        }

 五:常用断言

在NUnit中,断言是单元测试的核心。NUnit提供了一组丰富的断言,这些断言是Assert类的静态方法。如果一个断言失败,方法的调用不会返回值,并且会报告一个错误。如果一个测试包含多个断言,那些紧跟失败断言的断言都不会执行,因此,通常每个测试方法最好只有一个断言。

Assert类提供了最常用的断言。我们将Assert方法按如下分组:

    a.同等(Equality)断言 

    b.一致性(Identity)断言 

    c.比较(Comparison)断言 

    d.类型(Type)断言 

    e.条件(Condition)测试 

    f.工具(Utility)方法 

1.同等断言

    主要包括Assert.AreEqual()、Assert.AreNotEqual()和Assert.IsNaN()

    前两个方法测试2个参数是否相等。重载的方法支持普通的值类型。

    Assert.AreEqual( int expected, int actual );

    Assert.AreEqual( int expected, int actual, string message );

    Assert.AreEqual( int expected, int actual, string message,params object[] parms );

    Assert.AreEqual( uint expected, uint actual );

    Assert.AreEqual( uint expected, uint actual, string message );

    Assert.AreEqual( uint expected, uint actual, string message,params object[] parms );

    Assert.AreEqual( decimal expected, decimal actual );

    Assert.AreEqual( decimal expected, decimal actual, string message );

    Assert.AreEqual( decimal expected, decimal actual, string message,params object[] parms );

    Assert.AreEqual( float expected, float actual, float tolerance );

    Assert.AreEqual( float expected, float actual, float tolerance,string message );

    Assert.AreEqual( float expected, float actual, float tolerance,string message, params object[] parms );

    Assert.AreEqual( double expected, double actual, double tolerance );

    Assert.AreEqual( double expected, double actual, double tolerance,string message );

    Assert.AreEqual( double expected, double actual, double tolerance,string message, params object[] parms );

    Assert.AreEqual( object expected, object actual );

    Assert.AreEqual( object expected, object actual, string message );

    Assert.AreEqual( object expected, object actual, string message,params object[] parms );

    Assert.AreNotEqual( int expected, int actual );

    Assert.AreNotEqual( int expected, int actual, string message );

    Assert.AreNotEqual( int expected, int actual, string message,params object[] parms );

    Assert.AreNotEqual( uint expected, uint actual );

    Assert.AreNotEqual( uint expected, uint actual, string message );

    Assert.AreNotEqual( uint expected, uint actual, string message,params object[] parms );

    Assert.AreNotEqual( decimal expected, decimal actual );

    Assert.AreNotEqual( decimal expected, decimal actual, string message );

    Assert.AreNotEqual( decimal expected, decimal actual, string message,params object[] parms );

    Assert.AreNotEqual( float expected, float actual );

    Assert.AreNotEqual( float expected, float actual, string message );

    Assert.AreNotEqual( float expected, float actual, string message,params object[] parms );

    Assert.AreNotEqual( double expected, double actual );

    Assert.AreNotEqual( double expected, double actual, string message );

    Assert.AreNotEqual( double expected, double actual, string message,params object[] parms );

    Assert.AreNotEqual( object expected, object actual );

    Assert.AreNotEqual( object expected, object actual, string message );

    Assert.AreNotEqual( object expected, object actual, string message,params object[] parms );

    不同类型的数值可以按期望的那样进行比较。下面的断言会成功: 

        Assert.AreEqual( 5, 5.0 );

    float型和double型的数值通常使用一个附加参数来进行比较,这个参数代表一个误差,在这个误差范围内,它们视为相等。

    如果2个一维数组有相同的长度,而且相应的数组元素也相等,那么通过调用Assert.AreEqual方法,这2个数组视为相等。

    注: 多维数组,嵌套数组(数组的数组),以及其他集合类型,例如ArrayList目前还不支持。

2.一致性断言

    Assert.AreSame()方法、Assert.AreNotSame方法。这两个方法主要判断两个参数引用的是否是同一个对象。

        Assert.AreSame( object expected, object actual );

        Assert.AreSame( object expected, object actual, string message );

        Assert.AreSame( object expected, object actual, string message,params object[] parms );

        Assert.AreNotSame( object expected, object actual );

        Assert.AreNotSame( object expected, object actual, string message );

        Assert.AreNotSame( object expected, object actual, string message,params object[] parms );

    Assert.Contains()方法用来测试在一个数组或列表里是否包含该对象。

       Assert.Contains( object anObject, IList collection );

        Assert.Contains( object anObject, IList collection,string message );

        Assert.Contains( object anObject, IList collection,string message, params object[] parms );

3.比较断言

    Assert.Greater():测试一个对象是否大于另外一个。 

    Assert.Less():测试一个对象是否于小另外一个。 

    Assert.Greater( int arg1, int arg2 );

    Assert.Greater( int arg1, int arg2, string message );

    Assert.Greater( int arg1, int arg2, string message,object[] parms );

    Assert.Greater( uint arg1, uint arg2 );

    Assert.Greater( uint arg1, uint arg2, string message );

    Assert.Greater( uint arg1, uint arg2, string message,object[] parms );

    Assert.Greater( decimal arg1, decimal arg2 );

    Assert.Greater( decimal arg1, decimal arg2, string message );

    Assert.Greater( decimal arg1, decimal arg2, string message,object[] parms );

    Assert.Greater( double arg1, double arg2 );

    Assert.Greater( double arg1, double arg2, string message );

    Assert.Greater( double arg1, double arg2, string message,object[] parms );

    Assert.Greater( double arg1, double arg2 );

    Assert.Greater( double arg1, double arg2, string message );

    Assert.Greater( double arg1, double arg2, string message,object[] parms );

    Assert.Greater( float arg1, float arg2 );

    Assert.Greater( float arg1, float arg2, string message );

    Assert.Greater( float arg1, float arg2, string message,object[] parms );

    Assert.Greater( IComparable arg1, IComparable arg2 );

    Assert.Greater( IComparable arg1, IComparable arg2, string message );

    Assert.Greater( IComparable arg1, IComparable arg2, string message,object[] parms ); 

    Assert.Less( int arg1, int arg2 );

    Assert.Less( int arg1, int arg2, string message );

    Assert.Less( int arg1, int arg2, string message,object[] parms );

    Assert.Less( uint arg1, uint arg2 );

    Assert.Less( uint arg1, uint arg2, string message );

    Assert.Less( uint arg1, uint arg2, string message,object[] parms );

    Assert.Less( decimal arg1, decimal arg2 );

    Assert.Less( decimal arg1, decimal arg2, string message );

    Assert.Less( decimal arg1, decimal arg2, string message,object[] parms );

    Assert.Less( double arg1, double arg2 );

    Assert.Less( double arg1, double arg2, string message );

    Assert.Less( double arg1, double arg2, string message,object[] parms );

    Assert.Less( float arg1, float arg2 );

    Assert.Less( float arg1, float arg2, string message );

    Assert.Less( float arg1, float arg2, string message,object[] parms );

    Assert.Less( IComparable arg1, IComparable arg2 );

    Assert.Less( IComparable arg1, IComparable arg2, string message );

    Assert.Less( IComparable arg1, IComparable arg2, string message,object[] parms );

4.类型断言

    Assert.IsInstanceOfType():判断一个对象的类型是否是期望的类型

    Assert.IsNotInstanceOfType():判断一个对象的类型是否不是期望的类型

    Assert.IsAssignableFrom():判断一个对象的类型是否属于某种类型

    Assert.IsNotAssignableFrom():判断一个对象的类型是否不属于某种类型

    Assert.IsInstanceOfType( Type expected, object actual );

    Assert.IsInstanceOfType( Type expected, object actual,string message );

    Assert.IsInstanceOfType( Type expected, object actual,string message, params object[] parms );

    Assert.IsNotInstanceOfType( Type expected, object actual );

    Assert.IsNotInstanceOfType( Type expected, object actual,string message );

    Assert.IsNotInstanceOfType( Type expected, object actual,string message, params object[] parms );

    Assert.IsAssignableFrom( Type expected, object actual );

    Assert.IsAssignableFrom( Type expected, object actual,string message );

    Assert.IsAssignableFrom( Type expected, object actual,string message, params object[] parms );

    Assert.IsNotAssignableFrom( Type expected, object actual );

    Assert.IsNotAssignableFrom( Type expected, object actual,string message );

    Assert.IsNotAssignableFrom( Type expected, object actual,string message, params object[] parms );

5.条件测试断言

这些方法测试并把测试的值作为他们的第一个参数以及把一个消息作为第二个参数,第二个参数是可选的。本文提供了下面的方法:

    Assert.IsTrue( bool condition );

    Assert.IsTrue( bool condition, string message );

    Assert.IsTrue( bool condition, string message, object[] parms );

    Assert.IsFalse( bool condition);

    Assert.IsFalse( bool condition, string message );

    Assert.IsFalse( bool condition, string message, object[] parms );

    Assert.IsNull( object anObject );

    Assert.IsNull( object anObject, string message );

    Assert.IsNull( object anObject, string message, object[] parms );

    Assert.IsNotNull( object anObject );

    Assert.IsNotNull( object anObject, string message );

    Assert.IsNotNull( object anObject, string message, object[] parms );

    Assert.IsNaN( double aDouble );

    Assert.IsNaN( double aDouble, string message );

    Assert.IsNaN( double aDouble, string message, object[] parms );

    Assert.IsEmpty( string aString );

    Assert.IsEmpty( string aString, string message );

    Assert.IsEmpty( string aString, string message,params object[] args );

    Assert.IsNotEmpty( string aString );

    Assert.IsNotEmpty( string aString, string message );

    Assert.IsNotEmpty( string aString, string message,params object[] args );

    Assert.IsEmpty( ICollection collection );

    Assert.IsEmpty( ICollection collection, string message );

    Assert.IsEmpty( ICollection collection, string message,params object[] args );

    Assert.IsNotEmpty( ICollection collection );

    Assert.IsNotEmpty( ICollection collection, string message );

    Assert.IsNotEmpty( ICollection collection, string message,params object[] args );

6.StringAssert断言

    StringAssert.Contains( string expected, string actual );

    StringAssert.Contains( string expected, string actual,string message );

    StringAssert.Contains( string expected, string actual,string message, params object[] args );

    StringAssert.StartsWith( string expected, string actual );

    StringAssert.StartsWith( string expected, string actual, string message );

    StringAssert.StartsWith( string expected, string actual,string message, params object[] args );

    StringAssert.EndsWith( string expected, string actual );

    StringAssert.EndsWith( string expected, string actual,string message );

    StringAssert.EndsWith( string expected, string actual,string message, params object[] args );

    StringAssert.AreEqualIgnoringCase( string expected, string actual );

    StringAssert.AreEqualIgnoringCase( string expected, string actual,string message );

    StringAssert.AreEqualIgnoringCase( string expected, string actual,string message params object[] args );

7.实用方法

   Fail()和Ignore(),是为了让我们对测试过程有更多的控制:

        Assert.Fail();

        Assert.Fail( string message );

        Assert.Fail( string message, object[] parms );

        Assert.Ignore();

        Assert.Ignore( string message );

        Assert.Ignore( string message, object[] parms );

    Assert.Fail方法为你提供了创建一个失败测试的能力:

        public void AssertStringContains( string expected, string actual )

        {

            AssertStringContains( expected, actual, string.Empty );

        }

        public void AssertStringContains( string expected, string actual,string message )

        {

            if ( actual.IndexOf( expected ) < 0 )

                Assert.Fail( message );

        }

   Assert.Ignore方法为你提供在运行时动态忽略一个测试或者一个测试套件(suite)的能力。它可以在一个测试,一个setup或fixture setup的方法中调用。我们建议你只在无效的案例中使用。它也为更多扩展的测试包含或排斥提供了目录能力,或者你可以简单将不同情况下运行的测试运行分解到不同的程序集。