建立新測試

您可以建立新測試,以新增至現有種類和測試集。

關於此作業

這些指示說明如何在「 IBM® MQ 探險家」的現有種類及一組測試中建立新測試 (例如, 佇列管理程式測試 種類中的 佇列 測試集)。 這些指示說明如何在 Eclipse 開發環境中定義測試。 如需撰寫 Java 測試來源的相關資訊,請參閱 WMQTest 介面

如果您想要建立新的測試集或測試種類,而不是使用現有的測試集或測試種類,或者如果您已建立要在「 IBM MQ 探險家 」中管理的新物件,且您要撰寫新物件的測試,請參閱 建立新的測試種類、測試集及物件類型

建立 Eclipse 外掛程式專案來包含新測試

開始之前

請確定您已安裝 Eclipse Graphical Editing Framework (GEF) 工具。 如需相關資訊,請參閱 將 IBM MQ 探險家安裝至 Eclipse 環境

關於此作業

建立及配置新的外掛程式專案來包含新測試:

程序

  1. 開啟 外掛程式開發 視景。
  2. 在「套件瀏覽器」視圖中,按一下滑鼠右鍵,然後按一下 新建 > 外掛程式專案。 這時會開啟「新建外掛程式專案」精靈。
  3. 專案名稱 欄位中,輸入包含新測試的專案名稱。
  4. 下一步
  5. 編輯 版本名稱供應商 欄位中的詳細資料,然後按一下 完成

    請注意,ID 欄位中的值可能與您在精靈的上一頁的名稱欄位中所輸入的值不同。 專案名稱只在開發期間使用;外掛程式 ID 則是供 Eclipse 載入及識別外掛程式之用。

    新的外掛程式專案即會顯示於「套件瀏覽器」視圖中,且會自動開啟外掛程式資訊清單檔。
  6. 在「外掛程式資訊清單」編輯器中,按一下 相依關係 標籤。 在必要外掛程式窗格中已列出兩種相依關係。
  7. 將下列外掛程式新增至 必要外掛程式 窗格:
    • com.ibm.mq.explorer.tests
    • com.ibm.mq.explorer.ui
    • com.ibm.mq.pcf.event
    • com.ibm.mq.runtime
    • org.eclipse.core.resources

    如果無法使用列出的外掛程式,請安裝 Eclipse Graphical Editing Framework (GEF) 工具。 如需相關資訊,請參閱 將 IBM MQ 探險家安裝至 Eclipse 環境

  8. 儲存 MANIFEST。MF 檔案。

結果

外掛程式專案已準備好包含測試

定義新測試

關於此作業

下列指示說明如何在現有的佇列管理程式測試種類的現有測試集 (例如,在佇列測試集中)定義新測試。 如需在「佇列管理程式測試」種類中建立新的測試集、建立新的種類,或定義要測試的新物件類型的相關資訊,請參閱 建立新的種類、測試集和物件類型

配置外掛程式來包含新測試:

程序

  1. 確定 plugin.xmlMANIFEST。MF 檔在「外掛程式資訊清單」編輯器中開啟。
  2. 在「外掛程式資訊清單」編輯器中,按一下 延伸 標籤,以顯示「 延伸 」頁面。
  3. 按一下 新增 ...
    這時會開啟「新建延伸」精靈。
  4. 強調顯示 com.ibm.mq.explorer.tests.Tests 延伸點,然後按一下 完成
    新的測試延伸即會新增至「外掛程式資訊清單」編輯器的所有延伸窗格中。
  5. 按一下新的測試來強調顯示,然後輸入測試的詳細資料,如下表所示:
    屬性 說明 範例值
    ID 測試的唯一 ID。 com.ibm.mq.explorer.tests.samples.QueueNames
    測試的有意義名稱。 My Queues Test
    類別 包含測試的 Java 類別。 請不要輸入這個值;您可以在稍後建立此類別時自動輸入此值。 com.ibm.mq.explorer.tests.samples.QueueNames
    testset 測試所屬的種類。 顯示的範例值會使測試與種類 Queue manager tests 相關聯。 com.ibm.mq.explorer.tests.samples.wmq
    testsubset 測試所屬的子種類。 顯示的範例值會使測試與子種類 Queues 相關聯。 佇列
    說明 測試所檢查項目的說明。 對照簡稱使用慣例檢查佇列名稱。
    furtherinfo 包含測試詳細資訊的 HTML 或 XHTML 文件的位置。 當您在「執行測試」對話框中按兩下測試,或在「測試結果」視圖中按兩下測試結果時,此文件會顯示在「 IBM MQ 探險家 」中。 如需相關資訊,請參閱 測試說明文件 doc/QueueNamesInfo.html(相對於 plugin.xml 檔的檔案位置)。
  6. 儲存「外掛程式資訊清單」編輯器檔案。

結果

外掛程式專案現在已配置為包含新測試;接下來您必須撰寫測試本身。

針對所要撰寫的每一個新測試來定義一個新測試。

撰寫新測試

關於此作業

建立包含測試的新 Java 類別:

程序

  1. 在「 延伸元素詳細資料 」窗格中,按一下畫底線的 類別 欄位標籤。
    這時會開啟「Java 屬性編輯器」精靈。
  2. 確定只選取 繼承的抽象方法 勾選框,然後按一下 完成。 該 Java 類別檔即會在 Java 編輯器中開啟。
  3. 儲存「外掛程式資訊清單」編輯器檔案。 請注意,會自動插入類別欄位中的值。
  4. 編輯 Java 原始檔。
  5. 將測試記載於有效的 XHTML 或 HTML 檔案中。 使用 plugin.xml 檔中的 furtherinfo 屬性中指定的名稱和位置來儲存檔案。 XHTML 檔案的位置可能是本端(儲存在與測試相同的外掛程式中;例如,在 doc 子資料夾中)或遠端(儲存在 Web 伺服器上)。

結果

您已撰寫完測試並且已配置包含該測試的外掛程式。 接下來,請匯出外掛程式並部署該外掛程式來進行測試。

針對您在 plugin.xml 檔中定義的每一個測試撰寫一個新測試。

部署新測試

關於此作業

將包含測試 (或一組測試) 的外掛程式匯出至檔案系統,然後重新啟動「 IBM MQ 探險家 」,以便載入新的外掛程式,並且您可以執行測試:

程序

  1. 在「套件瀏覽器」視圖中,用滑鼠右鍵按一下外掛程式專案 com.ibm.mq.explorer.tests.samples,然後按一下 匯出 ...匯出... 對話框即會開啟。
  2. 在「 外掛程式開發 」視景中,按一下 可部署的外掛程式和片段 來強調顯示它,然後按 下一步
  3. 目錄欄位中,輸入「 IBM MQ 探險家 測試」外掛程式的位置。 此位置是 MQ_INSTALLATION_PATH\eclipse,其中 MQ_INSTALLATION_PATH 代表 IBM MQ 安裝所在的高階目錄。
  4. 可用的外掛程式和片段中選取您的外掛程式,然後按一下 完成
  5. 重新啟動 Eclipse,並切換至「 IBM MQ 探險家 」視景。

結果

您已完成新外掛程式的部署。 現在可以執行新測試了。