在上一篇文章“ 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库,引用该库即可以运行。