模板
教程
環境
性能
功能
管理
軟件測試NUnit 快速入門
軟件測試NUnit 快速入門
注:本頁是基于原來的QuickStart.doc文檔，你可以在早期的NUnit發布中找到它。已經指出它并不是一個非常好的TDD實例。盡管如此，我們仍然將它保留在文檔中，因為它的的確確描述了使用NUnit的基礎。我們會在以后的版本中重新審查或替換它。
讓我們從一個簡單的實例開始吧。假設我們正在編寫一個空應用程序，并且我們有一個基本的領域類-Aclearcase/" target="_blank" >ccount。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]屬性與之關聯-這是一種描述類包含測試代碼的方法（此屬性可以被繼承）。此類必須為public，并且對于其超類沒有任何限制。此類也必須有個一缺省的構造子。
此類包含一個唯一的方法-TransferFunds，而且有一個[Test]屬性與之關聯-它標志了該方法是一個測試方法。測試方法必須返回void，并且不能帶有參數。在我們的測試方法中,我們對一個需要測試的對象進行了普通的初始化，執行以測試的業務方法，并且檢查了業務對象的狀態。Assert類定義了一組方法，這些方法用來檢查前置條件，在我們的例子里，我們使用AreEqual方法保證在轉帳之后，2個帳戶都有正確的余額（本方法有許多重載方法，在本示例中的版本有如下參數：第一個參數是一個期望值，第二個參數是實際值）。
編譯并運行此實例。假設你已經將你的測試代碼編譯為一個bank.dll。啟動NUnit GUI（安裝文件會在桌面和“Program Files"上創建一個快捷方式）。在GUI啟動之后，選擇File->Open菜單，并指向bank.dll所在的路徑，在”Open“對話框打開選擇該文件。當bank.dll文件加載之后，你 會在左邊的面板上看到一個測試樹形結構 ，在右邊會有一組狀態。點擊Run按鈕，狀態條以及測試樹的TransferFunds節點會變紅-我們的測試失敗了?！盓rror and Failures"面板顯示如下信息：
TransferFunds : expected <250> but was <150>
而且，棧跟蹤面板會報告測試代碼中的失敗之處：
at bank.AccountTest.TransferFunds() in C:\nunit\BankSampleTests\AccountTest.cs:line 17
這正是我們期望的：測試失敗是因為我們并沒有實現TransferFunds方法?，F在我們讓它工作吧。不要關閉此GUI，返回你的IDE并修復此代碼，讓你的TransferFunds方法如下：
public void TransferFunds(Account destination, float amount)
{
destination.Deposit(amount);
Withdraw(amount);
}現在，重新編譯代碼，再一次點擊GUI上的按鈕-狀態條以及測試樹變綠了。（注意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);
}我們正測試業務方法的事務屬性-要么都成功，要么都失敗。編譯并運行-紅條。OK，我們已經讓$300.00蒸發了（(1999.com déjà vu?）-源帳戶有一個正確余額150.00，但是目標帳戶則是$450.00.我們如何修復？我們僅需要將最小余額檢查調用放在更新的前面即可：
public void TransferFunds(Account destination, float amount)
{
if(balance-amount<minimumBalance)
throw new InsufficientFundsException();
destination.Deposit(amount);
Withdraw(amount);
}如果Withdraw()方法拋出另外一個異常怎么辦？我們應該在捕獲代碼段中執行一個追加的業務，或是依賴我們的事務管理器來恢復對象的狀態？關于這點，我們需要回答一些問題，但不是現在。同時，我們應該對失敗的測試最些什么呢？刪除它？一個比較好的方式是暫時忽略它，在測試代碼中加入如下屬性：
[Test]
[Ignore("Decide how to implement transaction management")]
public void TransferWithInsufficientFundsAtomicity()
{
// code is the same
}編譯并運行-黃色的狀態條。點擊“Tests Not Run”，在列表里你會看到e 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("Decide how to implement transaction management")]
public void TransferWithInsufficientFundsAtomicity()
{
try
{
source.TransferFunds(destination, 300.00F);
}
catch(InsufficientFundsException expected)
{
}
Assert.AreEqual(200.00F,source.Balance);
Assert.AreEqual(150.00F,destination.Balance);
}
}
}盡管Init方法有一個通用的初始化代碼，但是它返回一個void類型，沒有參數。它標記為[SetUp]屬性。編譯并運行-同樣是黃色的狀態條。
