Java 利用匯入切換實作：模擬條件編譯的封裝技巧

Java 移除了 C 的「條件編譯」（#ifdef），但透過**套件匯入機制**可實現同樣效果：在不修改業務代碼的前提下，透過切換 import 套件，替換整組實作類別。本文將展示如何用此技巧實現「斷言工具」的開發/發布版本切換，並說明其核心原理與應用場景。

為何 Java 移除條件編譯？

• C 用 #ifdef 處理跨平台差異 → Java 設計為「一次編寫、到處執行」，原生跨平台無需條件編譯
• 但條件編譯還有**調試碼控制**等高價值用途：開發期啟用斷言/日誌，發布時完整移除，零效能負擔

核心技巧：同名類別、不同套件、切換 import

建立兩個同名類別 Assert，放在不同套件：

1. 開發版：com.bruceeckel.tools.debug.Assert

package com.bruceeckel.tools.debug;

public class Assert {
    private static void perr(String msg) { System.err.println(msg); }

    public final static void is_true(boolean exp) {
        if (!exp) perr("Assertion failed");
    }
    public final static void is_false(boolean exp) {
        if (exp) perr("Assertion failed");
    }
    public final static void is_true(boolean exp, String msg) {
        if (!exp) perr("Assertion failed: " + msg);
    }
    public final static void is_false(boolean exp, String msg) {
        if (exp) perr("Assertion failed: " + msg);
    }
}

2. 發布版：com.bruceeckel.tools.Assert

package com.bruceeckel.tools;

public class Assert {
    public final static void is_true(boolean exp) {}
    public final static void is_false(boolean exp) {}
    public final static void is_true(boolean exp, String msg) {}
    public final static void is_false(boolean exp, String msg) {}
}

發布版方法體為空，**編譯器內聯優化後完全消除呼叫**，零執行期開銷。

3. 業務代碼：僅切換 import

package c05;

// 開發期：import com.bruceeckel.tools.debug.*;
// 發布期：import com.bruceeckel.tools.*;
import com.bruceeckel.tools.debug.*;

public class TestAssert {
    public static void main(String[] args) {
        Assert.is_true((2 + 2) == 5);        // 開發期印錯誤，發布期無操作
        Assert.is_false((1 + 1) == 2);       // 同上
        Assert.is_true((2 + 2) == 5, "2+2=5");
        Assert.is_false((1 + 1) == 2, "1+1!=2");
    }
}

運作原理

1. Java 編譯器根據 import 解析 Assert 類別
2. 開發期匯入 debug 套件 → 呼叫含檢查邏輯的版本
3. 發布期匯入 tools 套件 → 呼叫空方法版本
4. 業務代碼 TestAssert **完全不修改**

優勢對比

應用場景擴充

此技巧適用於任何「需在不修改業務碼下切換實作」的場景：

• 日誌框架：開發期 DebugLogger、發布期 NullLogger
• 資料庫驅動：測試用 H2Driver、生產用 PostgresDriver
• 外部服務 Stub：開發期 MockPaymentService、生產用 RealPaymentService
• 效能監控：開發期 DetailedProfiler、發布期 NoOpProfiler

注意事項

1. 兩個實作類別**必須擁有完全相同的公共介面**（方法簽名、回傳型別、異常）
2. 建議定義共同介面 interface Assert { ... }，兩類別 implements Assert，編譯器強制一致性
3. 發布構建腳本（Maven/Gradle）可自動切換 import 或依賴範圍

總結

Java 雖無條件編譯，但透過**套件命名空間隔離 + 匯入切換**，實現了更優雅、類型安全、IDE 友善的實作替換機制。這正是「介面導向設計」在建構層面的自然延伸：業務碼依賴介面，實作由匯入決定，編譯期綁定，零執行期開銷。