Java 讀取 Properties 配置文件兩大核心方法：ClassLoader 與 ResourceBundle 實戰對比

場景：外部化配置管理

數據庫連接參數、第三方服務密鑰、功能開關等不應硬編碼，通過 .properties 文件外部化，運行時動態加載。

項目結構示例

src/
└── main/
    ├── java/
    │   └── com/example/config/
    │       └── ConfigLoader.java
    └── resources/
        └── application.properties

application.properties 內容

jdbc.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.username=root
jdbc.password=secret123
app.feature.cache.enabled=true
app.max.connections=20

方法一：ClassLoader + Properties.load()（推薦通用）

package com.example.config;

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

public class ConfigLoader {
    private static final Properties PROPS = new Properties();

    static {
        // 1. 通過類加載器獲取資源流（classpath 根目錄）
        try (InputStream in = ConfigLoader.class.getClassLoader()
                .getResourceAsStream("application.properties")) {
            if (in == null) {
                throw new IllegalStateException("找不到 application.properties");
            }
            PROPS.load(in);
        } catch (IOException e) {
            throw new ExceptionInInitializerError(e);
        }
    }

    public static String get(String key) {
        return PROPS.getProperty(key);
    }

    public static String get(String key, String defaultValue) {
        return PROPS.getProperty(key, defaultValue);
    }

    public static int getInt(String key, int defaultValue) {
        String val = PROPS.getProperty(key);
        return val != null ? Integer.parseInt(val.trim()) : defaultValue;
    }
    
    // 測試
    public static void main(String[] args) {
        System.out.println("URL: " + get("jdbc.url"));
        System.out.println("Driver: " + get("jdbc.driver"));
        System.out.println("Cache: " + get("app.feature.cache.enabled"));
    }
}

關鍵點

• getClassLoader().getResourceAsStream()：從 classpath 根路徑加載，不加前導斜槓
• ClassName.class.getResourceAsStream("/path")：從 classpath 根路徑加載，需加前導斜槓
• 靜態代碼塊初始化，全程只讀取一次，線程安全
• 提供類型轉換輔助方法（int/boolean/long）

方法二：ResourceBundle（專為 i18n 設計，也可用於配置）

package com.example.config;

import java.util.ResourceBundle;

public class ConfigLoaderRB {
    private static final ResourceBundle BUNDLE = 
        ResourceBundle.getBundle("application"); // 不加 .properties，不加路徑

    public static String get(String key) {
        return BUNDLE.getString(key); // 找不到拋 MissingResourceException
    }

    public static String getOrDefault(String key, String defaultValue) {
        try { return BUNDLE.getString(key); }
        catch (Exception e) { return defaultValue; }
    }

    public static void main(String[] args) {
        System.out.println("URL: " + get("jdbc.url"));
        System.out.println("Driver: " + get("jdbc.driver"));
    }
}

ResourceBundle 特性與限制

兩種方法對比選型指南

進階：Spring @Value / @ConfigurationProperties 註解注入

實際項目中極少手寫加載代碼，直接用 Spring 注解：

@Configuration
@ConfigurationProperties(prefix = "jdbc")
public class JdbcConfig {
    private String url;
    private String driver;
    private String username;
    private String password;
    // getter/setter
}

// 或單值注入
@Service
public class MyService {
    @Value("${app.max.connections:10}")
    private int maxConnections;
}

總結

• 通用配置讀取：Properties + ClassLoader 最靈活、編碼友好
• 國際化文本：ResourceBundle 原生支持 Locale
• Spring 項目：直接用 @ConfigurationProperties / @Value，零樣板代碼
• 文件放在 src/main/resources，打包進 JAR 根目錄，ClassLoader 即可訪問