1 public class JWebUnitTest extends WeBTestCase{2  public static void main(String[] args){3    junit.textui.TestRunner.run(new TestSuite(JWebUnitTest.class));4  }5  public void setUp(){6    getTestContext().setBaseUrl("http://httpunit.sourceforge.net");7    getTestContext().setProxyName("webproxy.watson.ibm.com");8    getTestContext().setProxyPort(8080);9  }10  public void testSearch(){11    beginAt("/index.html");12    clickLinkWithText("Cookbook");13  }14 }

如果沒注意清單 2 中特定于 JUnit 的代碼，那么您可以看到，測試用例現在變得相當整潔、簡練。需要查看的重要的行是第 6 行、第 11 行和第 12 行。在第 6 行，基本 URL 被設置到 HttpUnit 的主頁中。第 11 行用相對路徑 /index.html 連接站點。第 12 行用于單擊頁面上具有文本 Cookbook 的鏈接。如果鏈接有效，那么 JUnit 會報告成功；否則，JUnit 會報告異常。

jWebUnit API：進一步觀察
每個 jWebUnit 測試的核心都是 net.sourceforge.jwebunit.WebTestCase 類，它代表測試用例。每個測試用例都必須是從這個類擴展而來。（net.sourceforge.jwebunit.WebTestCase 類本身則是從 junit.framework.TestCase 類擴展而來的，它在 JUnit 中代表測試用例。） 表 1 描述了這個類的一些常用方法：

另一個重要的類是 net.sourceforge.jwebunit.TestContext。它為測試創建上下文。可以用這個類來處理像 cookie、會話和授權之類的信息。表 2 顯示了這個類的一些重要方法：

下載 jWebUnit，在 Eclipse 中配置 jWebUnit
jWebUnit 是用純 Java 代碼實現的，所以可以以 JAR 文件的形式獲得它 （請參閱 參考資料，從中獲得下載鏈接）。在完成下載之后，請按以下步驟在 Eclipse 平臺上配置 jWebUnit 庫：

1. 把下載的文件 jwebunit-1.2.zip 釋放到臨時目錄中（假設是 C:/temp）。
2. 在 Eclipse 中創建新 Java 項目，將其命名為 jWebUnit。
3. 右擊 Package EXPlorer 視圖中的 jWebUnit 項目，然后選擇 Properties。
4. 單擊 Java Build Path。單擊 Libraries 標簽中的 Add External JARs。
5. 瀏覽到 C:/temp/jwebunit-1.2/lib 目錄，選擇這個目錄中的所有 JAR 文件。
6. 單擊 OK。

現在可以在 Eclipse 中的 jWebUnit 項目下開發 jWebUnit 測試用例了。

構建示例應用程序
現在就可以查看 jWebUnit API 的實際應用了。我將帶您研究一個示例應用程序，幫助您更好地理解 jWebUnit 的真正威力。這個應用程序是一個測試用例，用于打開一個 Google 搜索頁面并搜索文本 HttpUnit。應用程序需要測試以下場景：

• 打開 Google 主頁 http://www.google.com。
  
  
• 確定該頁包含一個名為 q 的表單元素。（在 Google 的主頁上，名為 q 的文本框是接受用戶查詢輸入的文本框。）應用程序用這個元素輸入搜索參數。
  
  
• 在搜索文本框中輸入字符串 HttpUnit Home，并提交表單。
  
  
• 獲得結果頁，并確定該頁面包含的鏈接中包含文本 HttpUnit Home。
  
  
• 單擊包含文本 HttpUnit Home 的鏈接。

現在測試場景已經就緒，可以編寫 Java 應用程序，用 jWebUnit 實現這些需求了。

第一步是聲明一個從 WebTestCase 擴展而來的類，如清單 3 所示：

public class GoogleTest extends WebTestCase {   static String searchLink = "";}

正如我在前面提到過的，jWebUnit 要求每個測試用例都是從 WebTestCase 中擴展而來的。searchLink 保存傳入的搜索參數。這個值以命令行參數的形式傳遞給測試用例。

下一步是聲明入口點 —— main() 方法，如清單 4 所示：

public static void main(String[] args) {   searchLink = args[0];   junit.textui.TestRunner.run(new TestSuite(GoogleTest.class));}

main() 方法調用 junit.textui.TestRunner.run() 執行 JTest 測試用例。因為需要運行 GoogleTest 測試用例，所以，作為參數傳遞給 run() 方法的測試套件采用 GoogleTest.class 作為參數。

接下來，JTest 調用 setUp() 方法來設置基本 URL 和代理，如清單 5 所示：

public void setUp() {   getTestContext().setBaseUrl("http://www.google.com");   getTestContext().setProxyName("proxy.host.com");   getTestContext().setProxyPort(80);}

清單 5 把基本 URL 設置為 http://www.google.com。這意味著測試用例的啟動是相對于這個 URL 的。下面兩個語句設置連接到 Internet 的代理主機和代理端口。如果是直接連接到 Internet，那么可以忽略代理設置語句。

現在開始瀏覽站點并輸入搜索參數。清單 6 顯示了訪問 Web 頁面，然后測試所有場景的代碼：

public void testSearch() {   beginAt("/");   assertFormElementPresent("q");   setFormElement("q", "HttpUnit");   submit("btnG");   assertLinkPresentWithText(searchLink);   clickLinkWithText(searchLink);}

清單 6 的代碼連接到基本 URL，并相對于 / 開始瀏覽。然后它斷定頁面中包含一個名為 q 的表單元素 —— q 是 Google 主頁上查詢輸入文本框的名稱。下一條語句用值 HttpUnit 設置名為 q 的文本框。再下一條語言提交表單上名為 btnG 的提交按鈕。（在 Google 的主頁上，名為 btnG 的按鈕是標簽為 Google Search 的按鈕。）表單是在這個對話中提交的，下一頁列出搜索結果。在結果頁面上，代碼首先檢查是否有一個鏈接的文本是 HttpUnit Home。如果該鏈接不存在，那么測試就以 AssertionFailedError 失敗。如果該鏈接存在，則測試執行的下一個操作是單擊鏈接。

運行示例應用程序
現在把示例應用程序投入使用當中：

1. 下載示例應用程序 j-webunitsample.jar （請參閱 下載）。
   
   
2. 在一個目錄中解壓縮 j-webunitsample.jar。例如，如果把它釋放到 C:/temp 中，那么就要把源文件和類文件放在 C:/temp/com/jweb/test 中，而 setclasspth.bat 則放在 C:/temp 中。
   
   
3. 編輯 setclasspath.bat：設置 JAR_BASE 指向包含所有必需 JAR 文件的目錄。例如，如果在 C:/temp 中釋放 jwebunit-1.2.zip 文件，那么將 JAR_BASE 設置為 C:/temp/jwebunit-1.2/lib。
   
   
4. 打開命令行提示符，切換到 C:/temp 目錄。
   
   
5. 執行 setclasspath.bat。這會設置執行測試用例所需的 CLASSPATH。
   
   
6. 用命令 java com.jweb.test.GoogleTest "HttpUnit Home" 運行應用程序。

示例輸出
在執行了測試用例之后，會在命令行輸出一個測試用例報告。如果測試失敗，報告看起來如清單 7 中所示：