NUnit学习笔记3--Attribute使用介绍

本章主要讲解NUnit的几个Attribute（特性）的用法。

1，TestFixture

Imports  NUnit.Framework

< TestFixture() >  _
Public   Class Class1Test Class Class1Test
    Public Sub New()Sub New()

    End Sub
end class

上面代码中的<TestFixture()>就是一个特性(C#中使用 [TestFixture]),这个特性告诉NUnit：
这个类包含了测试代码,你需要给我看一下。然后NUnit就到这个类里面去看看是否有需要他出马的机会。

2,Test

      < Test() >  _
      Public   Sub FindMaxTest() Sub FindMaxTest()
         '定义一个数组
         Dim list1 As Int32() = {1, 3, 10, 4}
 
         Dim my As New Class1
         '测试数组list1中的最大整数是不是10。
         Assert.AreEqual(4, my.FindMax(list1))
     End Sub

这里的<Test()>（C#中为[Test]),这个特性告诉NUnit：
这是一个需要测试的方法，你给我测试一下，并用颜色告诉我结果（红色说明测试失败，绿色说明测试成功）。
对应到NUnit的gui中如下图：

图中左边那个灰色的圆点（FindMaxTest）就是由Test特性标示出来的一个需要测试的方法，然后我们可以通过按“Run”来运行这个测试，NUnit将通过颜色来返回。

这是NUnit最主要的2个Attribute，有了这2个，就可以编写单元测试了。



除了这2个Attribute之外，还有一些其他的Attribute，可以提供给我们更强大的功能，下面列出一些常用的：
 

标识测试类	TestFixture
标识测试方法	Test
标识测试类初始化函数	TestFixtureSetup
标识测试类资源释放函数	TestFixtureTearDown
标识测试用例初始化函数	Setup
标识测试用例资源释放函数	TearDown
标识忽略该测试方法	Ignore
标识该用例所期望抛出的异常	ExpectedException
标识测试用例的分类	Category

让我们接下去讲解其他Attribute:
3,TestFixtureSetup和TestFixtureTearDown
TestFixtureSetup这个特性的作用是为整个测试类初始化一些资源，准备好测试环境，然后给该测试类的几个测试（Test）使用，而TestFixtureTearDown则是把TestFixtureSetup初始化的一些资源释放掉。
我们可以通过下面这个例子来更好的理解：

Imports  NUnit.Framework

< TestFixture() >  _
Public   Class Class1Test Class Class1Test
    Private con As Connection

    <TestFixtureSetUp()> _
    Public Sub MyFixtureSetUp()Sub MyFixtureSetUp()
        '打开数据库联接
        conn = New Connection("sqlXXX", user, password)
        conn.open()
    End Sub

    <TestFixtureTearDown()> _
    Public Sub MyFixtureTearDown()Sub MyFixtureTearDown()
        '关闭数据库联接
        conn.close()
    End Sub


    <Test()> _
    Public Sub Mytest1()Sub Mytest1()
        '使用conn作某些测试
    End Sub

    <Test()> _
    Public Sub Mytest2()Sub Mytest2()
        '使用conn作某些测试
    End Sub

End Class

当你用NUnit测试Mytest1，Mytest2这2个test时，程序的运行顺序是这样的：
MyFixtureSetUp（初始化测试环境）
Mytest1（test1）
Mytest2（test2）
TestFixtureTearDown（释放资源）

4,Setup和TearDown
这2个特性和TestFixtureSetup，TestFixtureTearDown有点类似，区别在于：
Setup将在每个test之前运行，TearDown将在每个test之后运行。简单的说TestFixtureSetup，TestFixtureTearDown在一个测试类中之会运行一次；而Setup和TearDown，这个测试类有几个test被测试，就将运行几次。
举例说明：

Imports  NUnit.Framework

< TestFixture() >  _
Public   Class Class1Test Class Class1Test
    Private con As Connection

    <SetUp()> _
    Public Sub MyFixtureSetUp()Sub MyFixtureSetUp()
        '打开数据库联接
        conn = New Connection("sqlXXX", user, password)
        conn.open()
    End Sub

    <TearDown()> _
    Public Sub MyFixtureTearDown()Sub MyFixtureTearDown()
        '关闭数据库联接
        conn.close()
    End Sub


    <Test()> _
    Public Sub Mytest1()Sub Mytest1()
        '使用conn作某些测试
    End Sub

    <Test()> _
    Public Sub Mytest2()Sub Mytest2()
        '使用conn作某些测试
    End Sub

End Class

当你用NUnit测试Mytest1，Mytest2这2个test时，程序的运行顺序是这样的：
SetUp（初始化测试环境）
Mytest1（test1）
TearDown（释放资源）
SetUp（初始化测试环境）
Mytest2（test2）
TearDown（释放资源）

可以看出，每个test前后都运行了SetUp和TearDown

对3和4这2组特性的选择，我个人在实际使用中感觉差别不大，随便用哪种都行，2种都用也无不可。我一般是用TestFixtureSetup和TestFixtureTearDown，一次性把资源都设置好，然后再一次性释放，写起来方便

5，Ignore
临时忽略一些test。
在以下情况可能会用到：
（1），你的测试用例写好了，但实际代码却还没完成，这样的话测试肯定是不能通过的，但是你又不想看到NUnit抛出一个红灯笼，你就可以暂时用Ignore忽略掉这个test。NUnit会抛出一个黄灯，提醒你这个测试被忽略了。（不过，抛出个红灯笼也有好处的，它能鞭策你快点写好代码，哈哈）
（2），有些测试可能耗费非常长的时间（比如几个小时），你展示不想测试它们，而想等半夜再测试，你就可以暂时Ignore它们。（不过，推荐用Category特性来把这些长时间测试分类出来，而不是用Ignore，这个将在后面讲到）

实例说明：

      < Test(), Ignore( " Not Ready " ) >  _
      Public   Sub FindMaxTest() Sub FindMaxTest()
         '定义一个数组
         Dim list1 As Int32() = {1, 3, 10, 4}
 
         Dim my As New Class1
         '测试数组list1中的最大整数是不是10。
         Assert.AreEqual(10, my.FindMax(list1))
     End Sub

(C#中为[Test,Ignore("XXX")]           )
运行NUnit，我们将看到如下结果：

 

6,ExpectedException
标识该用例所期望抛出的异常
有时候我们知道在特定条件下我们的程序将会抛出某个异常，我们就可以用ExpectedException这个特性在测试代码中验证，程序是否如我们所想的抛出了这个异常。
如，我们那个求最大值的方法，如果传进去一个空的int32数组，应该会抛出一个NullReferenceException异常，为了验证我的猜想，我写了如下测试：

      < Test() >  _
      Public   Sub FindMaxTest() Sub FindMaxTest()Sub FindMaxTest()Sub FindMaxTest()
         '定义一个数组
         Dim list1() As Int32 = {1, 3, 10, 4}
         Dim list2() As Int32 = {1, 3, 4, 10}
         Dim list3() As Int32 = {10, 3, 1, 4}
         Dim list4() As Int32 = {-2, -1, -3}
 
         Dim my As New Class1
        '测试数组list1中的最大整数是不是10。
        Assert.AreEqual(10, my.FindMax(list1))

        '测试边界值
        Assert.AreEqual(10, my.FindMax(list2))
        Assert.AreEqual(10, my.FindMax(list3))

        '测试负数数组，数组中最大值应该是－1
        Assert.AreEqual(-1, my.FindMax(list4))
    End Sub

    <Test(), ExpectedException(GetType(NullReferenceException))> _
    Public Sub TestForException()Sub TestForException()
        Dim list1() As Int32
        Dim my As New Class1
        my.FindMax(list1)
    End Sub

(C#中为[Test,ExpectedException(Typeof(NullReferenceExcepton))]        )
运行NUnit，如下：


果然如此，程序的确抛出了NullReferenceException。而假如系统没有如我们所料抛出异常，或者抛出的不是此类异常，NUnit则会给我们个红灯笼。

7， Category
分类。
该特性可以把一些测试分成不同的种类，比如我们前面提到的，假如有些测试很耗时，我们就可以把它们分类成LongTime测试，而把其他的测试分类成ShortTime测试，然后，我们可以在NUnit中选择只运行ShortTime的测试，那些LongTime的测试则可以在夜晚自动构建的时候运行它们。
使用举例如下：

 

Imports  NUnit.Framework

< TestFixture() >  _
Public   Class Class1Test Class Class1Test

    <Test(), Category("ShortTime")> _
    Public Sub Mytest1()Sub Mytest1()

    End Sub

    <Test(), Category("ShortTime")> _
    Public Sub Mytest2()Sub Mytest2()

    End Sub

    <Test(), Category("LongTime")> _
    Public Sub Mytest3()Sub Mytest3()

    End Sub

    <Test(), Category("LongTime")> _
    Public Sub Mytest4()Sub Mytest4()

    End Sub
End Class

(C#中为[Test][Category（“ShortTime”)]        )
这个测试类中有2种测试方法：ShortTime和LongTime，
运行NUnit，选择"Categories"，我们将看到，Available Categories中看到有2种分类，选择“shortTime”，然后运行，只有ShortTime的那些测试方法被运行了。



除了这些Attribute之外，其实还有一些，不过我在实际使用中很少用到，我就不拿出来讲了。

下篇学习笔记，我将列举几种单元测试与项目结合的方法。