從測試計劃中獲取測試用例信息
　　測試計劃 TestPlan 是使用 TestLink 管理自動化測試過程的切入點，通過指定測試計劃的名稱作為參數(shù)，編寫代碼自動化獲取測試用例的信息，進而獲取測試用例的腳本文件信息并完成腳本文件的執(zhí)行。本部分介紹如何通過編程從測試計劃中獲取測試用例信息。本文使用第三方 Java 程序 TestLink Java API 請參考本系列的第一部分。
　　在調(diào)用 TestLink Java API 之前，需要先實例化 TestLinkAPI 實例對象，代碼清單如下。關(guān)于如何獲取個人訪問密鑰 devKey ，請參考本系列文章的第一部分。
　　清單 1. 獲取 TestLinkAPI 實例
public class APIObject {
private static Logger logger = Logger.getLogger(APIObject.class);
private static TestLinkAPI api = null;
public static TestLinkAPI getAPI() {
if (null == api) {
String url = "http://localhost/testlink/lib/api/xmlrpc.php";
String devKey = "92b9cc5fc38e1ebde8813ff219ce5a07";
logger.debug("URL=" + url);
logger.debug("devKey=" + devKey);
try {
api = new TestLinkAPI(new URL(url)， devKey);
} catch (TestLinkAPIException te) {
logger.error(te.getMessage()， te);
} catch (MalformedURLException mue) {
logger.error(mue.getMessage()， mue);
}
}
return api;
}
}
　　借助上述實例化 api 對象，接著可以獲取測試計劃中的測試用例信息。使用測試計劃獲取測試用例信息的代碼清單如下。需要指定的參數(shù)為測試項目的名稱和測試計劃的名稱，返回的是測試用例數(shù)組。。在調(diào)用 getTestCasesForTestPlan() 方法時，只使用了執(zhí)行類型 ExecutionType.AUTOMATED 對返回的測試用例數(shù)組進行過濾，可以根據(jù)項目組情況，添加更多的過濾條件。
　　清單 2. 獲取測試用例信息
　　String planName="kenneth 測試計劃 ";
　　String projectName= " 測試演示 ";
　　TestLinkAPI api = APIObject.getAPI();
　　TestPlan tl = api.getTestPlanByName(planName，projectName);
　　TestCase[] tcs=api.getTestCasesForTestPlan(tl.getId()， null， null，null，null，null，
　　null，null，ExecutionType.AUTOMATED，null，null);
　　for(TestCase tc:tcs){
　　logger.debug(tc.toString());
　　}
　　測試腳本上傳
　　使用 TestLink 管理自動化測試腳本的優(yōu)勢之一是，很容易復(fù)用維護在 TestLink 上的功能自動化測試用例。自動化測試團隊負責(zé)對現(xiàn)有的測試用例進行分析，劃定需要作為自動化測試執(zhí)行的用例部分。編寫自動化測試用例腳本，并上傳到相應(yīng)的測試用例的附件部分。這樣自動化測試與其相應(yīng)的自動化測試腳本文件可以一一對應(yīng)起來。編寫完畢自動化測試腳本后，訪問 Testlink 站點，點擊主頁的 Test Specification 鏈接，導(dǎo)航到相應(yīng)的測試用例節(jié)點上，雙擊定位到的用例，可以進入用例編輯頁面。手工上傳附件非常簡單，如圖 2 所示。上傳之后，顯示附件的標題，附件的文件名稱，文件大小，文件的 MIME 類型和附件的上傳日期等。點擊附件標題超鏈接可以下載附件到本地。

圖 2. 手工上傳附件到測試用例

　　除了手工上傳測試用例腳本文件外，還可以通過類似下面的編程代碼來實現(xiàn)同樣的功能。示例代碼如清單 1 所示。需要提供的參數(shù)為測試用例對象 TestCase tc，上傳文件的本地文件路徑 file，上傳附件的標題 title，上傳附件的描述信息 desc，附件的文件名字 fileName 和上傳附件的文件 MIME 類型。對于 XML 文件，文件的類型為 text/xml。調(diào)用清單 3 中的方法即可完成附件的上傳，代碼實現(xiàn)也非常簡單。首先，讀取本地腳本文件轉(zhuǎn)換為字節(jié)數(shù)組 byteArray，然后對該字節(jié)數(shù)組進行 Base64 編碼并轉(zhuǎn)換為字符串類型的 fileContent。后，調(diào)用 TestLinkAPI 的 uploadTestCaseAttachment() 方法完成附件的上傳。代碼中使用到了 Commons IO 開源類庫文件中的 FileUitls 類。
　　清單 3. 上傳測試用例附件
private static TestLinkAPI api = APIObject.getAPI();
public static void testUpload(TestCase tc， String file， String title，
String desc， String fileName， String fileType) {
File attFile = new File(file);
String fileContent = "";
try {
byte[] byteArray = FileUtils.readFileToByteArray(attFile);
fileContent = new String(Base64.encodeBase64(byteArray));
} catch (IOException e) {
logger.error(e.getMessage()， e);
}
Attachment attachment = api.uploadTestCaseAttachment(
tc.getId()， // 測試用例編號
title， // 上傳附件的標題
desc， // 附件的描述信息
fileName， // 附件的文件名稱
fileType， // 上傳附件的 MIME 文件類型
fileContent); // 附件的文件內(nèi)容
logger.debug(" 附件上傳完成，" + attachment.toString());
}
　　清單 3 的代碼是上傳附件到測試用例附件區(qū)的核心代碼，為了批量完成為多個用例分別上傳附件，需要在測試用例和需要上傳的本地附件文件做一個映射，循環(huán)調(diào)用清單 3 中的方法依次完成全部的附件上傳。具體的代碼實現(xiàn)留給讀者完成。
　　需要注意的是，TestLink 的版本管理特性可以對測試用例進行版本控制，但不支持對附件也做版本控制，即一個用例的所有版本都共享同樣的附件文件。如果讀者需要為用例的不同版本做自動化測試，可以在上傳腳本文件時為文件名稱附加上版本信息。下載用例腳本文件時，根據(jù)版本信息對腳本文件進行過濾。本文假設(shè)所有的版本可以共享同一份腳本文件，隨時保持附件文件的更新即可。
　　測試腳本文件下載
　　通過完成上述操作，自動化測試用例腳本文件已經(jīng)維護在 TestLink 測試用例附件區(qū)。在使用自動化測試工具執(zhí)行計劃的測試用例之前，需要下載測試用例腳本文件到本地文件系統(tǒng)，以方便自動化測試工具對其進行解析運行。使用 TestLink 管理自動化測試用例腳本的優(yōu)勢之一是，通過編寫簡單的代碼很容易完成腳本文件的下載。下載用例腳本文件的代碼見清單 4，為下載方法指定 TestCase tc 參數(shù)，即可完成該測試用例的附件下載任務(wù)。代碼很簡單，首先根據(jù)測試用例實例 tc 獲取附件數(shù)組 atts，對數(shù)組進行循環(huán)，依次獲取附件 att 的文件名稱和文件內(nèi)容，并保存到本地工作目錄下的 UseCases 文件夾下。
　　清單 4. 下載測試用例附件
private static TestLinkAPI api = APIObject.getAPI();
public static void getAttachments(TestCase tc) {
String dir = System.getProperty("user.dir") + File.separator
+ "UseCases";
File file = new File(dir);
if (!file.exists()) {
file.mkdirs();
}
Attachment[] atts = api.getTestCaseAttachments(tc.getId()， null);
for (Attachment att : atts) {
byte[] decoded = Base64.decodeBase64(att.getContent().getBytes());
FileOutputStream fos;
try {
fos = new FileOutputStream(new File(dir + File.separator
+ att.getFileName()));
logger.debug(" 測試用例附件保存為 =" + dir + File.separator
+ att.getFileName());
fos.write(decoded);
fos.close();
} catch (FileNotFoundException e) {
logger.error(e.getMessage()， e);
} catch (IOException e) {
logger.error(e.getMessage()， e);
}
}
}
　　測試腳本執(zhí)行
　　下載完畢測試用例腳本文件，下一環(huán)節(jié)是使用自動化測試工具執(zhí)行這些用例文件。關(guān)于如何運行基于 XML 格式的自動化測試用例，推薦讀者閱讀 IBM developerWorks 文章《使用 XML 維護 Selenium 自動化測試腳本》。測試用例執(zhí)行完畢，自動化測試工具生成執(zhí)行日志信息、測試結(jié)果信息等。相應(yīng)測試用例的執(zhí)行結(jié)果狀態(tài)，如 passed、failed、blocked 等，需要傳給下一環(huán)節(jié)，用于自動修改 TestLink 上測試用例的執(zhí)行結(jié)果狀態(tài)，完成標示結(jié)果的工作。
　　回傳測試結(jié)果
　　上述步驟中，通過使用第三方自動化測試工具執(zhí)行完畢自動化測試用例，收集到測試結(jié)果。下面需要進行的是，通過編寫代碼自動化地修改維護在 TestLink 上的自動化測試用例的執(zhí)行結(jié)果狀態(tài)。代碼如清單 5 所示，運行下面的代碼會自動把 TestLink 中測試計劃下的測試用例在構(gòu)建"my build"上運行的測試執(zhí)行結(jié)果標記為"通過"。演示程序中，測試計劃編號等數(shù)據(jù)為硬編碼，讀者需要根據(jù)自己的情況去完善回傳測試結(jié)果的程序。如果運行失敗，測試結(jié)果則標為"失敗"狀態(tài)，并和集成的缺陷管理系統(tǒng)進行自動化進行缺陷數(shù)據(jù)同步。
　　清單 5. 自動上傳測試結(jié)果的代碼清單
private static TestLinkAPI api = APIObject.getAPI();
public static void testReport() {
// 測試計劃
Integer planID = 7;
// 測試測試的構(gòu)建
String buildName="my build";
// 測試計劃
Integer tcID = 3;
ReportTCResultResponse response = api.reportTCResult(tcID， null，
planID， ExecutionStatus.PASSED， null， buildName，
" 自動化上傳結(jié)果的備注 "， null， null， null， null， null， null);
logger.debug("response=" + response);
}
　　結(jié)束語
　　通過上面對 TestLink 的介紹，我們了解到了如何基于 TestLink 管理自動化測試過程。本文詳細介紹了基于 TestLink 的自動化測試解決方案的核心實現(xiàn)，分析了架構(gòu)流程圖并對主要的部分給出了代碼示例。關(guān)于如何使用 TestLink 管理功能測試過程，請參考本系列文章的第一部分。