配置管理

nstarter 框架提供了统一的配置管理组件 nstarter-config，通过安装相关包可以提供标准化的配置管理能力。

基本功能

• 支持从 json/yaml 加载配置文件生成配置对象
• 支持配置热更新
• 支持通过 includes 配置项引用注入配置文件

使用说明

import { ConfigLoader, IConfig, ConfigLoadEvents } from 'nstarter-config';

/**
 * 示例配置对象
 */
class Config implements IConfig {
    system: {
        locale: string,
        timezone: string
    };
    includes?: string[];

    public fromJSON(obj: any): void {
        Object.assign(this, obj);
    }
}

/**
 * 生成配置单例
 */
const loader = new ConfigLoader(Config, {
    files: [
        // 直接指定文件类型
        './conf.d/config.override.yaml',
        // 支持自动按照 json/yaml 格式发现目标目录下的文件执行加载
        './conf.d/config.base'
    ],
    useEnv: true,
    useHotReload: true,
    useIncludes: true, 
    extra: {
        env: 'test'
    }
});
loader.on(ConfigLoadEvents.init_failed, (err) => {
    process.exit(1);
});

loader.initialize();
const config = loader.getConfig();

• 用法说明：

  • 首先声明用于构造配置单例的对象定义。

    • 要求提供 fromJSON 方法，并建议方法执行过程中，有预校验入参，中断注入对象属性的逻辑。
    • 推荐配合 nstarter-entity 使用

  • 配合 ConfigLoader 在提供合适配置参数后，初始化并装载配置对象。

• 参数说明：

  • files - 默认配置文件列表
  • useEnv - 是否加载环境变量参数，默认 false
  • useHotReload - 是否启用配置热加载，默认 false
  • useIncludes - 是否启用配置引用注入，默认 false
  • extra - 额外静态配置项

• 事件定义

  • ConfigLoadEvents.init_failed - 配置初始化失败，参数 err: Error
  • ConfigLoadEvents.reload_failed - 配置重载失败，参数 err: Error
  • ConfigLoadEvents.reload - 配置重新初始化完成，参数 config