建立自訂 Java 程式碼

自訂程式碼利用測試中的參照作為輸入,且會將修改過的值傳回測試中。使用 ICustomCode2 介面來建立自訂程式碼,及使用 ITestExecutionServices 介面來延伸測試執行。 這些介面包含在 com.ibm.rational.test.lt.kernel.services 套件中。

關於這項作業

註: 當您在自訂程式碼中使用 ITestExecutionServices 介面來報告測試結果時,自訂程式碼的結果會顯示在測試日誌中。 如果您有記載自訂驗證點裁決,這些會反映在整體排程裁決中。

自訂程式碼輸入值可位於參照或欄位參照中。 您也可以將字串當成引數傳遞至自訂程式碼。作為自訂程式碼之輸入的參照,必須包括在與自訂程式碼相同的測試中。 在此測試中,參照必須位於它所影響的程式碼之前。 請確認測試含有自訂的程式碼輸入所需的參照。如需建立參照和欄位參照的詳細資料,請參閱建立參照或欄位參照

如果自訂程式碼使用外部 JAR 檔,您可能需要變更 Java™ 建置路徑。在某些情況下,您可以先執行測試再加入自訂程式碼,來避免手動變更建置路徑。 第一次執行測試時,編譯所需的類別和程式庫會加入建置路徑中。例如,若您已新增自訂程式碼的測試先前已執行過,您可以匯入「測試及效能工具平台 (TPTP)」類別,這些要在測試日誌中建立自訂事件所需要的類別。 不過,如果測試從未執行過,則會發生匯入錯誤,因為除非執行測試,否則類別的名稱不會在專案的建置路徑中。

如果程式碼使用外部資源,例如,SQL 資料庫或管理客戶關係的產品,您必須配置自訂程式碼在您執行測試的每一部電腦上工作。

自訂程式碼是儲存在專案的 src 資料夾中,其中包含呼叫該程式碼的測試。依預設,自訂程式碼是位於 src 資料夾中名稱為 test 的套件。

您可以針對位於多個專案中的測試,重複使用自訂程式碼套件。 專案必須在一個工作區中。如果要在專案之間重複使用自訂程式碼,請在自訂程式碼套件之前使用專案名稱。例如,類別名稱欄位

下例顯示兩個自訂程式碼類別的標準「導覽器」視圖。(「測試導覽器」不會顯示 Java 原始檔。)

內含 ReplaceCC.java 和 VerifyUserID.java 類別的導覽器視圖

當您在測試中新增 ReplaceCC.javaVerifyYUserID.java 自訂程式碼類別,並將值傳回至測試時,替代列出這兩個類別。

test 套件也包含針對專案中的測試所產生的 Java 程式碼。

您可以將自訂程式碼放在不同的套件中(例如:custom)。請將自訂程式碼與產生的程式碼分開,特別是使用來源控制系統時。

程序

如果要新增自訂程式碼,請執行下列動作:

  1. 開啟測試,然後選取測試元素。
  2. 按一下新增插入,然後選取自訂程式碼 新增會將自訂程式碼附加到所選的測試元素底端。插入會將自訂程式碼新增到所選測試元素的上方。
    註: 在新增或插入自訂程式碼之後,「問題」視圖顯示錯誤,表示新的自訂程式碼元素沒有 Java 檔。此錯誤訊息一直存在,直到您按一下檢視程式碼產生程式碼為止,以提醒您自訂程式碼測試元素尚未與任何 Java 程式碼相關聯。
  3. 檢查類別名稱欄位,並完成下列其中一個步驟:
    • 如果要呼叫的程式碼已存在,請變更類別名稱以符合其名稱。請按一下檢視程式碼,於 Java 編輯器中開啟程式碼。
    • 如果程式碼不存在,請變更類別名稱來說明程式碼的用途。 請按一下產生程式碼來產生用來記載結果的範本類別,並在 Java 編輯器中開啟它。如果這個名稱的類別已存在,系統會警告您它會被改寫。
  4. 引數欄位中,按一下新增
  5. 在「自訂程式碼」視窗中,選取您程式碼需要的所有輸入。自訂程式碼」視窗會列出測試中,所有可用來作為程式碼輸入的值(測試中位於程式碼之前的參照或欄位參照)。
  6. 按一下確定 視窗會關閉,所選取的參照會新增至引數欄位。
  7. 選擇性的: 如果要新增字串作為自訂程式碼的輸入,請按一下文字,然後輸入要使用的字串。
  8. 在測試中,於自訂程式碼之後,找出程式碼傳回測試的值。
  9. 強調顯示該值。
  10. 用滑鼠右鍵按一下強調顯示的值,按一下替代,然後選取自訂程式碼的類別名稱。 這時會列出您已新增的自訂程式碼類別。當您做了選擇之後,要傳回至測試的值會以橙色強調顯示,並以此資訊更新使用者表格。

下一步

自訂程式碼不會顯示在「測試導覽器」視圖中。如果要檢視自訂程式碼,請開啟「套件瀏覽器」視圖,並使用 Java 工具來識別您已新增的自訂程式碼。

意見