Java 配置加載機制設計與實現：多源策略模式、Provider 抽象、泛型 Loader 與 Spring 整合最佳實踐

三、實戰：MarketConfig 多源加載

1. 領域模型

public class MarketConfig {
    private AppleConfig appleConfig;
    private EggConfig eggConfig;
    private OwnerConfig ownerConfig;
    // getter/setter
}

public class AppleConfig { private int price; private String color; /* getter/setter */ }
public class EggConfig { private int weight; /* getter/setter */ }
public class OwnerConfig {
    private Map owners = new HashMap<>();
    public void addOwner(String port, String owner) { owners.put(port, owner); }
    public String getOwner(String port) { return owners.get(port); }
    public Map getAll() { return Collections.unmodifiableMap(owners); }
}

2. XML 來源加載器

public class MarketConfigLoader extends AbstractConfigLoader {
    public MarketConfigLoader(IConfigProvider provider) { super(provider); }

    @Override
    protected MarketConfig load(Document doc) throws ConfigException {
        MarketConfig config = new MarketConfig();
        // XPath 或 DOM 遍歷解析
        Element root = doc.getDocumentElement();
        config.setAppleConfig(parseApple(root));
        config.setEggConfig(parseEgg(root));
        // OwnerConfig 來自 Properties，委託給專用 Loader
        OwnerConfigLoader ownerLoader = new OwnerConfigLoader(
            ConfigProviderFactory.createPropertiesProvider("config/owner.properties"));
        config.setOwnerConfig(ownerLoader.load());
        return config;
    }
    // parseApple, parseEgg 省略...
}

3. Properties 來源加載器

public class OwnerConfigLoader extends AbstractConfigLoader {
    public OwnerConfigLoader(IConfigProvider provider) { super(provider); }

    @Override
    protected OwnerConfig load(Properties props) throws ConfigException {
        OwnerConfig config = new OwnerConfig();
        props.forEach((k, v) -> config.addOwner((String) k, (String) v));
        return config;
    }
}

4. 應用層調用

public class ConfigBootstrap {
    public static void main(String[] args) {
        // XML 來源
        IConfigProvider xmlProvider = ConfigProviderFactory.createDocumentProvider("config/market.xml");
        MarketConfigLoader marketLoader = new MarketConfigLoader(xmlProvider);
        MarketConfig marketConfig = marketLoader.load(); // 類型安全獲取

        System.out.println("Apple price: " + marketConfig.getAppleConfig().getPrice());
        System.out.println("Owner port1: " + marketConfig.getOwnerConfig().getOwner("port1"));
    }
}

四、進階擴展：多源融合、熱加載、Spring 整合

1. 合併加載器 (優先級覆蓋)

public class MergedConfigLoader implements IConfigLoader {
    private final List> loaders; // 按優先級排序
    private final Merger merger; // 合併策略

    public MergedConfigLoader(List> loaders, Merger merger) {
        this.loaders = loaders; this.merger = merger;
    }

    @Override
    public T load() throws ConfigException {
        T result = null;
        for (IConfigLoader loader : loaders) {
            T partial = loader.load();
            result = (result == null) ? partial : merger.merge(result, partial);
        }
        return result;
    }
}

// 合併策略接口
public interface Merger { T merge(T base, T override); }

2. 熱加載與監聽

public interface ConfigChangeListener {
    void onChange(T oldConfig, T newConfig);
}

public class HotReloadConfigLoader implements IConfigLoader, Runnable {
    private final IConfigLoader delegate;
    private final long intervalMs;
    private final List> listeners = new CopyOnWriteArrayList<>();
    private T currentConfig;
    private volatile boolean running = true;

    public HotReloadConfigLoader(IConfigLoader delegate, long intervalMs) {
        this.delegate = delegate; this.intervalMs = intervalMs;
        this.currentConfig = delegate.load();
    }

    @Override public T load() { return currentConfig; }

    @Override public void run() {
        while (running) {
            try { Thread.sleep(intervalMs); }
            catch (InterruptedException e) { Thread.currentThread().interrupt(); break; }
            try {
                T newConfig = delegate.load();
                if (!Objects.equals(currentConfig, newConfig)) {
                    T old = currentConfig;
                    currentConfig = newConfig;
                    listeners.forEach(l -> l.onChange(old, newConfig));
                }
            } catch (Exception e) { log.error("Hot reload failed", e); }
        }
    }
    public void addListener(ConfigChangeListener l) { listeners.add(l); }
    public void stop() { running = false; }
}

3. Spring Boot 整合

@Configuration
@EnableConfigurationProperties
public class ConfigLoaderAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public ConfigProviderFactory configProviderFactory() {
        return new ConfigProviderFactory(); // 無狀態工廠
    }

    @Bean
    public MarketConfig marketConfig(ConfigProviderFactory factory) throws ConfigException {
        return new MarketConfigLoader(factory.createDocumentProvider("config/market.xml")).load();
    }

    @Bean
    public HotReloadConfigLoader hotMarketConfig(MarketConfig initial) {
        HotReloadConfigLoader loader = new HotReloadConfigLoader<>(
            new MarketConfigLoader(ConfigProviderFactory.createDocumentProvider("config/market.xml")),
            30_000); // 30s 輪詢
        loader.addListener((o, n) -> log.info("MarketConfig reloaded"));
        new Thread(loader, "config-hot-reload").start();
        return loader;
    }
}

五、最佳實踐清單

1. 接口分層：IConfigProvider (源) → IConfigLoader (轉換) → 業務對象，單一職責。
2. 泛型類型安全：編譯期鎖定配置對象類型，消除強轉。
3. 模板方法：AbstractConfigLoader 統一異常、日誌、監控。
4. 來源解耦：新增來源 (YAML、Nacos、Consul、DB) 僅需實現 IConfigProvider，不動加載器。
5. 合併策略外部化：Merger 接口支援覆蓋、深度合併、數組追加等多種語義。
6. 熱加載可選：HotReloadConfigLoader 裝飾器模式無侵入增強。
7. 失敗快速：啟動階段加載失敗直接拋出異常，避免帶病運行。
8. 敏感信息脫敏：加載後自動掩碼密鑰、密碼字段 (toString、日誌)。

六、總結

配置加載機制的核心價值在於：**屏蔽來源差異、提供類型安全視圖、支援多源融合與動態更新**。本文設計的 Provider-Loader-Factory 三層架構，配合泛型、模板方法、裝飾器模式，實現了高內聚、低耦合、易擴展的配置加載體系，可直接應用於框架開發、微服務配置中心客戶端、複雜應用啟動器等場景。