代码改变世界

你学会测试了吗(2):测试语法之属性介绍

2008-09-03 21:48 李永京 阅读(...) 评论(...) 编辑 收藏

前言

这个简短的系列一一讲解一下.Net下测试的相关知识,希望对初学者有所帮助。

上一篇中我向大家介绍了几个测试工具,推荐使用TestDriven.NET。至本文完稿官方提供了TestDriven.NET-2.14.2190 Beta版(直接下载)和TestDriven.NET-2.13.2184正式版(直接下载)。此文为这个系列的第二篇,我将使用这个工具,介绍TestDriven.NET所支持的一些重要的属性。

属性

TestDriven.NET支持多种单元测试框架,像NUnit,MbUnit,MS Team System,这里我选择了最为经典的NUnit单元测试框架来介绍TestDriven.NET所支持的一些重要的属性。TestDriven.NET其实已经支持大部分NUnit的属性,但是有些属性现在还不支持。

在我们使用TestDriven.NET测试前,项目必须引用框架的程序集,即nunit.framework.dll,并且在每个包含测试的源文件中必须使用using语句引用该程序集,像这样:using NUnit.Framework; 在NUnit中,所有的属性都包含在Nunit.Framework命名空间里。

首先我们依次熟悉一下这些属性。

1.TestFixtureAttribute

这个属性用来修饰测试类,表示这个类包含了测试方法。注意一下使用这个属性修饰类有一些限制:这个类必须是public,必须有一个缺省的构造函数。

using System;
using NUnit.Framework;

namespace TestDrivenNET
{
    [TestFixture]
    public class YJingLeeFixture
    {
        //......
    }
}

2.TestAttribute

这个属性标记类的某一方法为一个测试方法,此类已经标记为一个TestFixture。一个测试方法的签名定义如下:

[Test]
public void TestMethod()
{
}

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

3.SetUpAttribute

这个属性用来修饰方法,修饰后这个方法在每个测试方法被调用之前运行的,我们可以用它来重新设置一些变量,在每个方法运行之前赋值。

[SetUp]
public void Init()
{
}

4.TearDownAttribute

这个属性用来修饰方法,说明这个方法是在每个测试方法被调用完之后运行的,我们可以用来释放一些暂存的变量。

[TearDown]
public void Dispose()
{
}

5.SetUpFixtureAttribute

这个属性这个属性用来修饰类,这个类包含了SetUpAttribute或者TearDownAttribute属性,必须是public和一个缺省的构造函数。只要使用这个属性,在其命名空间下,运行测试则首先运行其中SetUpAttribute修饰的方法,在运行测试结束则运行其中TearDownAttribute修饰的方法。注意一个命名空间下只有一个SetUpFixtureAttribute,如果这个属性在整个程序集下定义,则在整个程序集下有效。我们常常用它来设置全局的条件。

[SetUpFixture]
public class MySetUpClass
{
    [SetUp]
    public void RunBeforeAnyTests()
    {
    }
    [TearDown]
    public void RunAfterAnyTests()
    {
    }
}

6.TestFixtureSetUpAttribute

这个属性用来修饰方法,修饰后这个方法在fixture任何测试执行之前运行,我们常常用来初始化一些对象等,类似于类中的构造函数。

[TestFixtureSetUp]
public void FixtureInit()
{
}

7.TestFixtureTearDownAttribute

这个属性用来修饰方法,修饰后这个方法在fixture任何测试执行之后运行,我们常常用来释放一些资源。

[TestFixtureTearDown]
public void FixtureDispose()
{
}

8.ExpectedExceptionAttribute

使用这个属性表明这个方法会抛出一个预期的异常。用这种方法来指出这个测试执行时会抛出的异常。Type,为期望的异常的精确类型。 第二个是一个期望的异常全名的字符串。 不管是哪一种,在执行测试时,如果它抛出了指定的异常,那么测试通过。如果抛出一个不同的异常,测试就失败。如果抛出了一个由期望异常继承而来的异常,这也是成功的。

[Test]
[ExpectedException(typeof(InvalidOperationException))]
public void ExpectAnExceptionByType()
{
}
[Test]
[ExpectedException("System.InvalidOperationException")]
public void ExpectAnExceptionByName()
{
}

9.PlatformAttribute

平台属性用于指定测试方法测试方法或测试Fixture运行的平台。平台选择包括了各种操作系统和.NET Framework版本。使用无大小写之分的字符串来指定平台,也通过使用Include或Exclude属性包含或排除运行的平台。也可以指定PlatformAttribute参数。不管是哪一种情况,都可以用多个逗号分隔字符串。

TestFixture语法

[TestFixture]
[Platform("NET-2.0")]
public class YJingLeeFixture
{
}

Test语法

[Test]
[Platform(Exclude = "WinXP")]
public void SomeTest()
{
}

平台指定值:Win系列、Unix、Linux、 Net、Net-1.0、Net-1.1、Net-2.0、NetCF等。它们可以平台指定值:Win系列、Unix、Linux、 Net、Net-1.0、Net-1.1、Net-2.0、NetCF等。它们可以为大写,小写或者混合的。

10.CategoryAttribute

这个属性可以将某些测试方法或测试Fixture指定为属于某个特定的分类。当使用分类时,仅选择的类别可以测试。没有选择的类别测试是不会运行的。 例如我们有些测试需要运行很长的时间,肯定不希望每次都去运行它。你就可以把这些测试归到某个类别中,然后在NUnit的GUI中将它排除在测试范围之外。注意这个属性在TestDriven.NET中不支持。

TestFixture语法

[TestFixture]
[Category("LongRunning")]
public class YJingLeeFixture
{
}

Test语法

[Test]
[Category("VeryLong")]
public void VeryLongTest()
{
}

11.ExplicitAttribute

这个属性会忽略一个测试方法或测试Fixture,直到它被显式的选择运行。如果你指定了它(比如你把鼠标放在这个方法上,然后选择RunTest)这个测试方法就会运行。我们常常用于暂时避免的测试方法。

TestFixture语法

[TestFixture,Explicit]
public class YJingLeeFixture
{
}

Test语法

[Test, Explicit]
public void ExplicitTest()
{
}

12.SuiteAttribute

Suite属性用来定义基于用户偏好的集合。在测试中不常用,因为框架提供了动态创建机制。

13.IgnoreAttribute

这个属性表明这个测试方法或测试Fixture会被忽略掉。一段时间内不会运行这个方法或测试Fixture。我们可以将测试方法或Fixture标记为Ignore属性,运行测试时,就不会执行。 例如我们常常使用这个属性标记暂时不运行测试或者重构软件时需要保留的测试来代替使用注释或重命名的方法,这样做,测试代码会和有这个标记的代码一起编译,在运行时不会运行标记的测试代码,这样保证不会忘记过去测试。

TestFixture语法

[TestFixture]
[Ignore("Ignore a fixture")]
public class YJingLeeFixture
{
}

Test语法

[Test]
[Ignore("Ignore a test")]
public void IgnoredTest()
{
}

在TestDriven.NET中,如果使用这个属性,测试显示结果如下:
测试样例

好了,有关NUnit单元测试框架的属性就介绍这么多了,TestDriven.NET测试工具支持了这里大多数属性,我们完全可以使用这个工具完成我们的测试工作。下篇我继续为大家介绍断言的基本语法,接下来以一个实例实战一下测试技巧。