J2SE 實用技巧：Properties 屬性配置檔案完整讀寫指南

Java 應用程式常透過 .properties 檔案外部化配置（資料庫連線、系統參數等）。本文示範標準 java.util.Properties API 載入、讀取、寫入與路徑解析的完整範例，並說明相對路徑陷阱與最佳實踐。

範例配置檔：jdbc.properties

jdbc.driver=com.microsoft.jdbc.sqlserver.SQLServerDriver
jdbc.url=jdbc:microsoft:sqlserver://10.0.0.168:1433;
jdbc.username=sa
jdbc.password=sa
jndi.databaseName=northwind

核心程式碼：PropertiesDemo

package zy.pro.wd.demo;

import java.io.FileInputStream;
import java.util.Properties;

public class PropertiesDemo {
    public void testPropertiesFile() {
        try {
            Properties props = new Properties();
            // 載入配置檔
            props.load(new FileInputStream("src/jdbc.properties"));
            // 讀取屬性
            System.out.println(props.getProperty("jdbc.driver"));
            System.out.println(props.getProperty("jdbc.url"));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        new PropertiesDemo().testPropertiesFile();
    }
}

關鍵 API 說明

相對路徑解析陷阱與解決方案

new FileInputStream("src/jdbc.properties") 的相對基準是程式啟動的工作目錄，非專案根目錄。常見情境：

• Eclipse 執行：工作目錄 = 專案根目錄 → src/... 正確。
• 打包 JAR 執行：工作目錄 = JAR 所在目錄 → 找不到 src/。
• Web 應用：工作目錄 = 伺服器啟動目錄 → 路徑失效。

最佳實踐：類別路徑載入

// 相對於 classpath 根目錄（src 編譯後輸出位置）
InputStream is = PropertiesDemo.class.getResourceAsStream("/jdbc.properties");
// 或
InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("jdbc.properties");
props.load(is);

• 將 jdbc.properties 放入 src/（Maven 則為 src/main/resources），編譯後自動複製到 classes/ 根目錄。
• 打包 JAR/WAR 時自動包含，部署無憂。

進階：寫入配置檔範例

public void saveConfig(String filename, Properties props) {
    try (FileOutputStream fos = new FileOutputStream(filename)) {
        props.setProperty("last.update", new java.util.Date().toString());
        props.store(fos, "Application Configuration - Auto Generated");
    } catch (IOException e) {
        e.printStackTrace();
    }
}

執行結果驗證

com.microsoft.jdbc.sqlserver.SQLServerDriver
jdbc:microsoft:sqlserver://10.0.0.168:1433;

環境：Eclipse 3.0 測試通過。

結語

掌握 Properties 載入/存取核心 API，並改用 Class.getResourceAsStream() 透過類別路徑存取配置檔，是 Java 應用從開發到部署各環境通用的穩健做法。避免硬編碼相對路徑，讓配置真正外部化、可維護。