原著：NUnit v2.1
原文：NUnit文档之QuickStart.doc
翻译：lover_P
--------------------------------------------------------------------------------
[译者序]
    纵观软件的开发，测试已经日益成为软件开发过程中的重要环节，通常一个软件的开发周期中测试要占到一半时间甚至更多。而在测试过程中，单元测试更是万里长征第一步，单元测试进行得是否完善，直接影响到后期集成测试的效率。进行单元测试，有许多软件可以自动完成，NUnit就是其中之一。这是一款与JUnit齐名的，同属于xUnit家族的单元测试软件（在http://www.nunit.org/我们可以免费得到这款软件）。

[正文]

    让我们从一个简单的例子开始。假设我们正在编写一个银行应用程序，而我们有一个这一领域的基本类——Account。Account支持存款、取款和资金转帐。这个Account类看起来会是这个样子：

namespace bank {
    public class Account {
        private float balance;

        public void Deposit(float amount) {
            balance += amount;
        }

        public void Withdraw(float amount) {
            balance -= amount;
        }

        public void TransferFunds(Account destination, float amount) {
        }

        public float Balance {
            get {
                return balance;
            }
        }
    }
}

    现在我们来为这个类写一个测试——AccountTest。我们要测试的第一个类方法是TransferFunds。

namespace bank {
    using NUnit.Framework;

    [TestFixture]
    public class AccountTest {

        [Test]
        public void TransferFunds() {
            Account source = new Account();
            source.Deposit(200.00F);
            Account destination = new Account();
            destination.Deposit(150.00F);

            source.TransferFunds(destination, 100.00F);
            Assert.AreEqual(250.00F, destination.Balance);
            Assert.AreEqual(100.00F, source.Balance);
        }
    }
}

    首先要注意的是这个类关联了一个[TestFixture]特性（attribute）——这表示这个类包含了测试代码（这个特性可以被继承）。这个类必须是公有的，但他的父类并不受限制。这个类还必须有一个默认构造函数。

    类中唯一的一个方法——TransferFunds()，关联了一个[Test]特性——这表示它是一个测试方法。测试方法的返回值必须为void并且不能带有参数。在我们的测试方法中，我们对被测试的对象进行了一般的初始化，执行了被测试的方法并检查了对象的状态。Assert类定义了一组方法用于检查给定的条件，在我们的例子中我们使用了AreEqual()方法来确保交易过后两个账户都有正确的余额（这个方法有很多重载，我们在这个例子中使用的版本带有两个参数：第一个参数是我们的期望值，第二个参数是实际值）。

    编译并运行这个例子。假设你已经将你的测试代码编译为bank.dll。打开NUint Gui（安装程序会在你的桌面和“程序”菜单中建立一个快捷方式），打开GUI后，选择File->Open菜单项，找到你的bank.dll并在“Open”对话框中选中它。bank.dll装载后你会在左边的面板中看到一个测试树结构，还有右边的一组状态面板。单击Run按钮，状态条和测试树种的TransferFunds节点变成了红色——我们的测试失败了。“Errors and Failures”面板显示如下消息——“TransferFunds: expected <250> but was <150>”，在它正下方的堆栈跟踪面板报告了测试失败的语句在代码中的位置——“at bank.AccountTest.TransferFunds() in C:\nunit\BankSampleTests\AccountTest.cs:line 17”

    这正是预期的结果，因为我们还未实现TransferFunds()方法。现在我们来搞定它。不要关闭GUI，回到你的IDE并修改代码，使你的TransferFunds()方法看起来像这样：

public void TransferFunds(Account destination, float amount) {
    destination.Deposit(amount);
    Withdraw(amount);
}

    现在重新编译你的代码并再次在GUI中点击Run按钮——状态条和数节点变绿了。（注意GUI会自动地为你重新加载程序集；我们可以一直开着GUI而在IDE中继续工作并写更多的测试）。

    让我们来为我们的Account的代码添加一些错误检测。为账户添加一个最小余额限制，通过你的最小透支保护费来维持它的持续运作。首先我们来为Account类添加一个最小余额保护属性：

private float minimumBalance = 10.00F;

public float MinimumBalance {
    get {
        return minimumBalance;
    }
}

    我们使用一个异常来指出透支：

namespace bank {
    using System;

    public class InsufficientFundsException : ApplicationException {
    }
}

    向我们的AccountTest类添加一个新的方法：

[Test]
[ExpectedException(typeof(InsufficientFundsException))]
public void TransferWithInsufficientFunds() {
    Account source = new Account();
    source.Deposit(200.00F);
    Account destination = new Account();
    destination.Deposit(150.00F);
    source.TransferFunds(destination, 300.00F);
}

    这个测试方法除了[Test]特性之外还关联了一个[ExpectedException]特性——这指出测试代码希望抛出一个指定类型的异常；如果在执行过程中没有抛出这样的一个异常——该测试将会失败。编译你的代码并回到GUI。由于你编译了你的测试代码，GUI会变灰并重构了测试树，好像这个测试还没有被运行过（GUI可以监视测试程序集的变化，并在测试树结构发生变化时进行更新——例如，添加了新的测试）。点击“Run”按钮——我们又一次得到了一个红色的状态条。我们得到了下面的失败消息：“TransferWithInsufficentFunds: InsufficientFundsException was expected”。我们来再次修改Account的代码，象下面这样修改TransferFunds()方法：

public void TransferFunds(Account destination, float amount) {
    destination.Deposit(amount);

    if(balance - amount < minimumBalance)
        throw new InsufficientFundsException();

    Withdraw(amount);
}

    编译并运行测试——绿了。成功！不过等等，看看我们刚写的代码，我们会发现银行在每一笔不成功的转账操作时都亏钱了。让我们来写一个测试来确认我们的猜测。添加这个测试方法：

[Test]
public void TransferWithInsufficientFundsAtomicity() {
    Account source = new Account();
    source.Deposit(200.00F);
    Account destination = new Account();
    destination.Deposit(150.00F);

    try {
        source.TransferFunds(destination, 300.00F);
    }
    catch(InsufficientFundsException expected) {
    }

    Assert.AreEqual(200.00F,source.Balance);
    Assert.AreEqual(150.00F,destination.Balance);
}

    我们测试了方法的交易属性——是否所有的操作都成功了。编译并运行——红条。是的，我们平白无故地损失了300块钱——source账户有正确的余额150.00，但destination账户显示：$450.00。我们该如何修改？我们能够只将最小余额检查的调用放到数据更新的前面么：

public void TransferFunds(Account destination, float amount) {
    if(balance - amount < minimumBalance) {
        throw new InsufficientFundsException();
    }
    destination.Deposit(amount);
    Withdraw(amount);
}

    如果Withdraw()方法抛出了另外一个异常呢？我们应该在catch块中执行一个补救处理，还是依赖我们的交易管理器来重新装载对象的状态？某些时候我们必须回答这样的问题，但不是现在；可我们眼前如何应付这个失败的测试呢——删除它？一个不错的方法是临时忽略它在你的测试方法中添加下面的特性：

[Test]
[Ignore("Need to decide how to implement transaction management in the application")]
public void TransferWithInsufficientFundsAtomicity() {
    // code is the same
}

    编译并运行——黄条。单击“Test Not Run”选项卡，你会看到bank.AccountTest.TransferWithInsufficientFundsAtomicity()连同这个测试被忽略的原因一起列在列表中。

    看看我们的测试代码，我们可以看到一些适宜的重构。所有的方法共享一组公共的测试对象。让我们来将这些初始化代码放到一个setup方法中并在所有的测试中重用它们。我们的测试类的重构版本像下面这样：

namespace bank {
    using System;
    using NUnit.Framework;

    [TestFixture]
    public class AccountTest {
        Account source;
        Account destination;

        [SetUp]
        public void Init() {
            source = new Account();
            source.Deposit(200.00F);
            destination = new Account();
            destination.Deposit(150.00F);
        }

        [Test]
        public void TransferFunds() {
            source.TransferFunds(destination, 100.00f);

            Assert.AreEqual(250.00F, destination.Balance);
            Assert.AreEqual(100.00F, source.Balance);
        }

        [Test]
        [ExpectedException(typeof(InsufficientFundsException))]
        public void TransferWithInsufficientFunds() {
            source.TransferFunds(destination, 300.00F);
        }

        [Test,
         Ignore (
            "Need to decide how to implement transaction management in the application"
        )]
        public void TransferWithInsufficientFundsAtomicity() {
            try {
                source.TransferFunds(destination, 300.00F);
            }
            catch(InsufficientFundsException expected) {
            }

            Assert.AreEqual(200.00F,source.Balance);
            Assert.AreEqual(150.00F,destination.Balance);
        }
    }
}

    注意这个初始化方法拥有通用的初始化代码，它的返回值类型为void，没有参数，并且由[SetUp]特性标记。编译并运行——同样的黄条！