基於 JUnit 的全域單元測試執行器實作指南

背景痛點

模組化專案擁有數十個獨立 Java 工程、數百個 JUnit 測試類別，分散於不同目錄。手工執行繁瑣，腳本維護成本高（新增測試須改腳本），亟需一個自動發現並一次執行所有測試的全域測試程式。

核心機制：JUnit 4 支援多類別集合執行

JUnit 4 定義 Runner 介面，Suite 繼承 Runner 可執行多個測試類別。自訂 AllJunitTestRunner extends Suite，建構子傳入經過過濾的測試類別集合：

public AllJunitTestRunner(Class<?> clazz, RunnerBuilder builder) throws InitializationError {
    super(builder, clazz, loadAllTestClass(filterClassNameList(clazz, loadAllClassesName(clazz))));
}

發現所有測試類別流程

1. 掃描 Classpath：取得 java.class.path，分割路徑，排除 .jar（可選擇性支援），遞迴掃描目錄收集所有 .class 檔案名稱（轉為完整類別名，如 com.aa.bb.Cc）。
2. 名稱過濾：支援通配符排除套件（如 com.aa.bb.cc1.*）。
3. 載入 Class 物件：Class.forName，捕獲 ClassNotFoundException 跳過。
4. 排除非測試類別：
   • 抽象類別：(clazz.getModifiers() & Modifier.ABSTRACT) != 0
   • 內部類別：名稱含 $ 或 isLocalClass()/isAnonymousClass()
5. 識別 JUnit 3/4 風格：
   • JUnit 3：繼承 junit.framework.TestCase（TestCase.class.isAssignableFrom(clazz)）。
   • JUnit 4：至少一個方法標註 @Test（method.getAnnotation(Test.class) != null）。

通過所有條件者加入 toBeRanTestClassList。

執行入口

建立空測試類別指定 Runner：

@RunWith(AllJunitTestRunner.class)
public class AllJunitTest { }

執行此類別即自動跑完專案群所有測試。

改進方向

• 以自訂 Annotation 取代硬編碼過濾規則，靈活配置於測試類別上。
• 掃描階段加入路徑前置過濾，避免遞迴進入無關目錄提升效能。

總結

利用 JUnit 4 Runner 機制、Classpath 掃描與反射識別測試類別，實現零維護成本的全域測試執行。實務上大幅減少手工/腳本負擔，確保新增測試即時生效，提升敏捷開發品質。