Java Preferences API 完整指南：跨平台用戶偏好設定持久化

Java Preferences API：輕量級跨平台配置持久化方案

java.util.prefs.Preferences 自 JDK 1.4 引入，提供系統級的用戶/系統偏好設定存儲機制。Windows 底層使用註冊表，Linux/macOS 使用隱藏文件，實現真正的跨平台透明持久化。本文詳細講解 API 核心用法、存儲機制、適用場景與代碼實戰。

核心特性

• 鍵值對存儲：支援 String、int、long、float、double、boolean、byte[]
• 分層節點樹：userRoot() (用戶級) / systemRoot() (系統級)，節點路徑如 /com/example/app
• 自動持久化：無需手動 flush，JVM 定期/關閉時自動同步到底層存儲
• 默認值機制：get(key, default) 避免 NullPointerException

核心 API 快速參考

完整代碼實戰

import java.util.prefs.Preferences;

public class PreferenceDemo {
    private Preferences prefs;
    
    public void demo() {
        // 1. 定義節點：建議使用類全名確保唯一性
        prefs = Preferences.userRoot().node(this.getClass().getName());
        
        // 2. 讀取 (帶默認值)
        System.out.println("首次讀取 boolean: " + prefs.getBoolean("autoSave", true));
        System.out.println("首次讀取 String: " + prefs.get("lastFile", "default.txt"));
        System.out.println("首次讀取 int: " + prefs.getInt("windowWidth", 800));
        
        // 3. 寫入
        prefs.putBoolean("autoSave", false);
        prefs.put("lastFile", "report.pdf");
        prefs.putInt("windowWidth", 1024);
        
        // 4. 再次讀取驗證持久化
        System.out.println("更新後 autoSave: " + prefs.getBoolean("autoSave", true));
        
        // 5. 刪除特定鍵
        prefs.remove("lastFile");
    }
    
    public static void main(String[] args) {
        new PreferenceDemo().demo();
    }
}

底層存儲機制詳解

適用場景 vs 不適用場景

進階用法與注意事項

1. 導入/導出：exportNode(OutputStream) / importPreferences(InputStream) 支援配置遷移
2. 變更監聽：addPreferenceChangeListener() / addNodeChangeListener() 實現配置熱更新
3. 權限限制：系統節點寫入需管理員權限，非受信代碼 (Applet/WebStart) 受 SecurityManager 限制
4. 並發安全：同一 JVM 內線程安全，但跨進程無鎖機制，極高併發可能數據丟失
5. 不要手動編輯底層存儲：格式為內部實現細節，可能跨版本變更

對比：Preferences vs Properties vs 外部配置中心

Preferences API 是 Java 標準庫中「隱藏的寶石」，恰當使用能極大簡化桌面/客戶端應用的配置持久化開發。