Java ME 單元測試實戰：JMUnit 框架入門與應用

背景與動機

JUnit 依賴反射 API，而 Java ME (CLDC) 不支援反射，導致標準 JUnit 無法直接用於 Java ME 專案。為填補空白，社群開發了 J2MEUnit 與 JMUnit 兩大開源框架（現已規劃合併為 J2MEUnit 2.0）。本文聚焦 JMUnit。

獲取與整合

• SourceForge 下載 JMUnit 打包檔。
• 專案中引入 jmunit.jar，建置路徑加入。
• NetBeans Mobility Pack 5.5+ 內建整合，可直接在 IDE 建立測試套件。

被測試類別範例

// 單位轉換工具類 (CLDC 1.1 float 支援)
public class DistanceConversion {
    public static int feetToMeters(int ft) { return (ft * 3048) / 10000; }
    public static int metersToFeet(int m) { return (m * 3281) / 1000; }
    public static int milesToKm(int mi) { return (mi * 1609) / 1000; }
    public static int kmToMiles(int km) { return (km * 6214) / 10000; }
}

public class TemperatureConversion {
    public static float fahrenheitToCelsius(float f) { return ((f - 32) / 9) * 5; }
    public static float celsiusToFahrenheit(float c) { return ((c * 9) / 5) + 32; }
    public static boolean isHotter(float f, float c) { return fahrenheitToCelsius(f) > c; }
    public static boolean isCooler(float f, float c) { return fahrenheitToCelsius(f) < c; }
}
// CLDC 1.0 版本請將 float 改為 int 定點運算

JMUnit 測試類別撰寫

import com.jmunit.TestCase;
import com.jmunit.TestSuite;

public class ConversionTest extends TestCase {
    public ConversionTest(String name) { super(name); }

    public void testFeetToMeters() {
        assertEquals(3, DistanceConversion.feetToMeters(10)); // 10 ft ≈ 3 m
        assertEquals(30, DistanceConversion.feetToMeters(100));
    }

    public void testMetersToFeet() {
        assertEquals(3281, DistanceConversion.metersToFeet(1000)); // 1000 m ≈ 3281 ft
    }

    public void testTemperature() {
        assertTrue(TemperatureConversion.isHotter(100f, 37f)); // 100°F > 37°C
        assertFalse(TemperatureConversion.isCooler(100f, 37f));
    }

    // 靜態 suite() 方法供測試運行器發現
    public static TestSuite suite() {
        TestSuite suite = new TestSuite();
        suite.addTest(new ConversionTest("testFeetToMeters"));
        suite.addTest(new ConversionTest("testMetersToFeet"));
        suite.addTest(new ConversionTest("testTemperature"));
        return suite;
    }
}

運行測試

• 命令列：java -cp jmunit.jar:classes com.jmunit.textui.TestRunner ConversionTest
• IDE：NetBeans/Eclipse 外掛一鍵運行，顯示綠/紅燈報表。
• 裝置/模擬器：打包測試 MIDlet 部署至真機或 WTK 模擬器驗證目標平台行為。

最佳實踐建議

1. 測試驅動開發 (TDD)：先寫失敗測試，再實作功能。
2. 邊界值測試：0、最大值、溢位邊界。
3. 模擬外部依賴：RMS、HTTP、Socket 等用 Mock 物件隔離。
4. 持續整合：Ant/Maven 整合 jmunit 任務，自動化執行。

雖 Java ME 發展趨緩，但嵌入式、功能機、舊系統維護仍需單元測試保障品質，JMUnit/J2MEUnit 是成熟可靠的選擇。