NUnit之Attribue详解

在上一篇文章“NUnit之Assertion详解”中，给大家介绍了NUnit的断言，现在接着给大家介绍Attribute在NUnit中的具体作用。

Attribute是C#一个重要的语言特征，园子里应该有不少这方面的文章，如果对Attribute不太了解，建议先去稍稍了解一下，亲手做个小程序感受一下Attribute的作用。

我们在使用NUnit编写测试用例时，离不开两个最基本的Attribute，例如，我们要测试一个类的Add方法，使用的代码如下：

[TestFixture]
public class MyTest
{
    [Test]
    public void TestAdd()
    {
        int a = 99;
        int b = 1;
        int value = MyMath.Add(a,b);
        Assert.AreEqual(value, 100);
    }

    Public void TestDel()
    {
       int value = MyMath.del(99,1);
       Assert.AreEqual(value, 98);
    }
}

上面的代码中，已经使用了两个Attribute，即[TestFixture]和[Test]，其中[TestFixture]的作用是声明MyTest类是一个含有测试方法的类，而[Test]则说明TestAdd是一个测试方法，而TestDel由于没有用[Test]声明，所以它不是测试方法，虽然它以Test开头。

对于编译后的Assembly文件，NUnit就是通过查找[TestFixture]和[Test]这类它支持的与测试相关的Attribute来确定哪些类包含了测试方法，以及这些类中的哪些方法是测试方法。

对于上面的例子，如果用NUnit的图形化界面打开其编译后的Assembly，应该看到如下的界面，TedtAdd方法以及它所属的命名空间按照树的形式展开，而TestDel方法由于没有[Test]的声明，所以它只是一个普通的方法，也就没有在树中展现：

点击Run按钮后，NUnit会运行所有的测试方法，运行后的界面如下

通过上面的小例子，我们知道了[TestFixture]和[Test]这两个Attribute的作用，对它支持的Attribute有了初步了解。

如果查看NUnit的源代码(大家可以去官网注册然后下载)，可以知道，在NUnit.Framework这个命名空间中，有TestFixtureAttribute和TestAttribute两个类，它们负责解析带有[TestFixture]和[Test]声明的类和方法（在C#语法规范中，要实现一个名称为[ABC]的Attribute，必须建立名称为ABCAttribute的类，并继承于Attribute这个基类）。

NUnit支持的Attribute远不止上面两个，我大致把它们分为四大类，分别是控制类、数值类、平台类和其它类，下面逐一介绍

 

一：控制类

这些Attribute控制测试类或者测试方法，而且成对出现，功能基本相比，了解一个就自然了解另外一个。

[TestFixture]/[Explicit]：声明一个类是测试类/声明一个类只有在UI界面被选中时才执行

[TestFixtureSetup]/[TestFixtureTearDown]：在测试开始前/结束后要执行的操作，一个TestFixture只能有一个TestFixtureSetup或TestFixtureTearDown。

[Test]/[Ignore]：是测试方法/忽略掉，测试时不执行

[Setup]/[TearDown]：每个测试方法在执行前/结束后要执行的操作

 

二：数值类

数值类Attribue是NUnit的一大亮点，善于使用这些Attribue，将使测试方法变得清晰、简洁、可读性强、可扩展性强，有利于进行数据驱动下的测试。

为了说明下面的例子，使用下面的方法，也就是打印输出输入值及其数据类型，这样便于把执行的结果通过打印的方式在NUnit中输出

Console.WriteLine(t + ", its type:" + typeof(T));

 

[Values]：以参数的形式传入一组值，NUnit会把这组值分解成相应数量的子测试。

例如下面的代码，分别在[Values]中传入三组共8个值，在执行时便一共会分解成8个子测试方法，例如

TestPrintInt([Values(1, 2, 3)] int x)会被分解为
TestPrintInt(1)
TestPrintInt(2)
TestPrintInt(3)三组

如下图，当选中ValueDemo这个节点，然后点击Run按钮后，会看到一共测试了8个测试用例。

当了解了这个Attribue的设计思路后，以后的其它Attribute也就很容易理解了，往往通过它们的命名就可以猜出一二。

 

[ValueSource]：以数据源（Object类型）作为参数，如下图，左边是源程序，右边是编译后生成的子测试

 

[Combinatorial]：两组测试数据进行组合，下面的代码会生成12个子测试，如图

 

[Sequential]：和上面[Combinatorial]的类似，不同之处见下图

 

下面其它的Attribue也都大同小异，不愿意看文字说明的话，大家用NUnit运行一下示例程序，再对比一下源程序就知道了

[Range]：生成某个数据范围内的子测试，如

TestPrintColsole([Range(0.2, 0.6, 0.2)] double d)：生成0.2,0.4,0.6三个子测试用例

TestPrintColsole([Values(1, 2, 3, 4, 5, 6)] int x, [Range(0.2, 0.6, 0.2)] double d)：两个Attribuee结合，共生成18个子测试用例

 [Random]：在某个范围内随机生成测试用例，

TestPrintColsole([Random(-1.0, 1.0, 5)] double d)：-1到1之间生成5个测试用例

TestPrintColsole([Values(1, 2, 3, 4, 5, 6)] int x, [Random(-1.0, 1.0, 5)] double d) ：共生成30个子测试用例

 

三：平台类

[Culture]：当Culture满足某条件下，才执行测试，如：

[Culture("fr-FR")]：仅当在法文Culture时，执行测试

[Culture(Exclude = "en,de")]：非英文和德文Culture时，才执行测试

[Platform]：当Platform满足某条件下，才执行测试，如：

[Platform("NET-4.0")]：仅当framework版本是4.0时，才执行测试

下面是NUnit官网声称的，其支持的平台类型:

Win	Win32	Win32S	Windows	Win32NT
WinCE	Win95	Win98	WinMe	NT3
NT4	NT5	NT6	Win2K	WinXP
Win2003Server	Vista	Win2008Server	Win2008ServerR2	Windows7
Unix	Linux	Net	Net-1.0	Net-1.1
Net-2.0	Net-3.0	Net-3.5	Net-4.0	NetCF
SSCLI	Rotor	Mono	Mono-1.0	Mono-2.0
Mono-3.0	Mono-3.5

四：其它类

[Category]：将测试方法分组，NUnit会取出所有的组名，列在Categories中，点击它可以看到。这提供了另外一种测试用例的运行方法，用户可以在些选择某一类的用例进行测试，而不是只能以点击分单位

[ExpectedException]：运行时抛出的异常才能预期的行为。

如果没有这个Attribute，要测试某些异常时，只能使用Try Catch的方式，而下面的代码则更为简洁：

[Test]
[ExpectedException(typeof(System.DivideByZeroException))]//发生DivideByZeroException时，测试通过
public void Test1()
{
    int a = 0;
    int b = 1 / a;
    PrintConsole<object>.Print(b);
}

[Test]
[ExpectedException( "System.DivideByZeroException")]//发生DivideByZeroException时，测试通过

public void Test2()
{
    int a = 0;
    int b = 1 / a;
    PrintConsole<object>.Print(b);
}

[Maxtime]/ [Timeout]: 测试用例的最大执行时间，前者超时时不取消测试，而后者会强行中断，用法如下

[Test, Maxtime(2000)]

[Test, Timeout(2000)]

[Repeat]: 重复执行多少次，用法如下

[Test, Repeat(100)]

[RequiresMTA]/ [RequiresSTA]/ [RequiresThread]：测试用例必须的在多线程、单线程、独立的线程状态下运行，这三个我没有具体使用过，大家有兴起可以试试。

 

关于NUnit的Attribue就介绍这些，建议对此有兴起的网友，多关注其中数值类和平台类，或是修改NUnit的源代码，实现自己的Attribute，下文会有所介绍。

点此下载VS2010格式的示例程序，解压缩的DLL目录下有NUnit库，引用该库即可以运行。