Java 開發者必知的 6 大現代核心類庫：Guava、Joda-Time、Hamcrest、Mockito、SLF4J、Logback

Java 開發者必知的 6 大現代核心類庫：Guava、Joda-Time、Hamcrest、Mockito、SLF4J、Logback

Java 生態系統持續演進，JDK 標準庫在某些領域設計滯後。本文介紹 6 個生產級專案幾乎必用的現代類庫，它們解決了 JDK 的痛點，大幅提升開發效率與代碼質量。無論你是維護舊專案還是啟動新專案，這些類庫都值得納入技術棧。

1. Guava - Google 核心類庫

為什麼需要 Guava？

JDK 集合、字串、快取、並發等 API 設計不夠人性化。Guava 是 JDK 的「強力補完計畫」，甚至有人說「應該併入 JDK」。

核心功能展示

// Maven 依賴
// com.google.guava:guava:31.1-jre

// 統計單詞出現次數 - 一行代碼搞定
String content = Files.asCharSource(new File(args[0]), StandardCharsets.UTF_8).read();

Multiset<String> wordCount = HashMultiset.create(
    Splitter.on(CharMatcher.WHITESPACE)
        .omitEmptyStrings()
        .trimResults()
        .split(content)
);

// 輸出: [hello×3, world×2, java×1]
System.out.println(wordCount);

Guava 核心模組速覽

遷移建議

• 舊專案使用 Apache Commons Lang/Collections → 漸進式替換為 Guava
• 新專案直接引入 Guava，建立統一工具類規範
• 注意：Guava 部分功能 Java 8+ Stream/Optional 已原生支援，按需選擇

2. Joda-Time - 日期時間處理的黃金標準

JDK Date API 的痛點

• 設計反直覺：月份 0-11、年份偏移 1900、不可變性差
• 幾乎所有方法被 Deprecated，SimpleDateFormat 非線程安全
• 時區、格式化、計算 API 支離破碎

Joda-Time 優雅解法

// Maven: joda-time:joda-time:2.12.5

// 建立日期 - 參數語義清晰
DateTime firstDay2013 = new DateTime().withDate(2013, 1, 1); // 2013-01-01T00:00:00.000

// 日期運算 - 流暢 API
DateTime twoDaysLater = firstDay2013.plusDays(2);     // 2013-01-03
DateTime lastMonth = firstDay2013.minusMonths(1);     // 2012-12-01
boolean isLeap = firstDay2013.dayOfYear().withMaximumValue().getDayOfYear() == 366;

// 格式化 - 線程安全，可重用
DateTimeFormatter fmt = DateTimeFormat.forPattern("yyyy-MM-dd HH:mm:ss");
String formatted = fmt.print(firstDay2013);           // "2013-01-01 00:00:00"
DateTime parsed = fmt.parseDateTime("2013-12-25 12:00:00");

// 區間與持續時間
Interval interval = new Interval(start, end);
Period period = interval.toPeriod(); // 年月日時分秒
Duration duration = interval.toDuration(); // 標準毫秒數

關鍵優勢

• 不可變物件：線程安全，無副作用
• 豐富類型：Instant(時間點)、DateTime(帶時區)、LocalDate/Time(無時區)、Period(人類時間)、Duration(機器時間)
• 完整時區支援：OLSON 時區資料庫
• JSR-310 參考實現：作者 Stephen Colebourne 主導 Java 8 新日期 API 設計

遷移路徑

Java 8+ 專案 → 直接使用 java.time.* (JSR-310)，API 與 Joda-Time 高度相似。Java 7 或舊專案 → 必須用 Joda-Time。

3. Hamcrest - 可讀性極強的斷言庫

傳統斷言的痛點

// 誰是預期？誰是實際？記不住！
assertEquals(expected, actual);  // JUnit 3 風格
assertEquals(actual, expected);  // JUnit 4+ 風格，易搞混

Hamcrest 流暢斷言

 18 && u.isActive();
    }
    public void describeTo(Description d) { d.appendText("成年活躍用戶"); }
});

整合現狀

JUnit 4.4+ 內建 Hamcrest 核心，無需額外依賴。JUnit 5 推薦使用 org.hamcrest:hamcrest:2.2 完整版。

4. Mockito - 最簡單強大的 Mock 框架

為什麼選 Mockito？

核心 API 實戰

// Maven: org.mockito:mockito-core:5.3.1

// 1. 建立 Mock
List<String> mockedList = mock(List.class);

// 2. 存根行為
when(mockedList.get(0)).thenReturn("first");
when(mockedList.get(1)).thenThrow(new RuntimeException("error"));
when(mockedList.size()).thenReturn(10);

// 3. 驗證調用
verify(mockedList).get(0);
verify(mockedList, times(2)).get(anyInt());
verify(mockedList, never()).clear();

// 4. 參數捕獲
ArgumentCaptor<String> captor = ArgumentCaptor.forClass(String.class);
verify(mockedList).add(captor.capture());
assertEquals("captured", captor.getValue());

// 5. Spy (部分 Mock 真實物件)
List<String> spyList = spy(new ArrayList<>());
when(spyList.size()).thenReturn(100); // 覆蓋特定方法
spyList.add("real"); // 真實調用

最佳實踐原則

• 避免 verify 內部實現細節：關注輸入輸出行為，而非方法調用順序
• 優先使用 when-then：而非 doReturn-when (語法較舊)
• 不要 Mock 值物件/實體類：只 Mock 服務介面、Repository、外部依賴
• 測試邊界條件：空集合、異常拋出、超時、null 參數

5. SLF4J + Logback - 現代日誌標準組合

為什麼棄用 Log4j 1.x / Commons Logging？

• Commons Logging 類載入機制導致類庫衝突
• Log4j 1.x 2015 年停止維護，存在安全漏洞 (CVE-2021-44228 影響 Log4j 2.x)
• 日誌模式語法晦澀，效能不如 Logback

SLF4J 門面 + Logback 實現

// Maven 依賴
// org.slf4j:slf4j-api:2.0.7
// ch.qos.logback:logback-classic:1.4.7

// 代碼中只依賴 SLF4J API
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Service {
    private static final Logger log = LoggerFactory.getLogger(Service.class);
    
    public void process(String name) {
        // 佔位符語法：延遲字串構建，效能極佳
        log.debug("處理用戶: {}", name); 
        log.info("訂單 {} 金額: {}", orderId, amount);
        log.error("處理失敗", exception); // 異常自動打印堆棧
    }
}

Logback 配置 (logback.xml)

<configuration>
    <!-- 控制台輸出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <!-- 檔案輸出，按日期滾動 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/app.%d{yyyy-MM-dd}.log.gz</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

日誌模式對比

Logback 模式語義自明，無需查文檔。

6. 類庫選型決策矩陣

總結

這 6 個類庫解決了 JDK 核心缺口：

1. Guava：集合/快取/字串/並發工具箱
2. Joda-Time：人性化日期時間 (Java 8+ 用 java.time)
3. Hamcrest：可讀斷言，測試即文檔
4. Mockito：零樣板 Mock，專注行為驗證
5. SLF4J：統一日誌門面，解耦實現
6. Logback：高效能、原生 SLF4J、靈活配置

將它們納入專案標準化模板，能讓團隊專注業務邏輯，而非重複造輪子或與糟糕 API 搏鬥。技術選型無絕對標準，但「不造輪子、用成熟方案」永遠是工程智慧的體現。