Alain 配置管理

Alain 配置管理

app/assets/tmp/app-data.json 中保存了默认的一些应用配置

• app 应用配置
• user 默认用户配置
• menu 菜单配置信息

在 App.Module 中，使用 APP_INITIALIZER 进行提前加载。

StartupServiceFactory 工厂函数通过调用 StartupService 来实现数据加载。See：https://github.com/ng-alain/delon/blob/master/schematics/application/files/src/app/core/startup/startup.service.tsls

加载的时候，使用 zip 加载了 2 个部分的数据。

const defaultLang = 'en-US';
    return zip(this.i18n.loadLangData(defaultLang), this.httpClient.get('assets/tmp/app-data.json'))

之后，映射出来两个对象 langData, appData

map(([langData, appData]: [Record<string, string>, NzSafeAny]) => {

保存到 SettingsService 对象实例中。

// 应用信息：包括站点名、描述、年份
this.settingService.setApp(appData.app);

SettingsService 中保存应用的配置信息
见： https://ng-alain.com/theme/settings/zh 包括：

• app
• user
• layout

它定义在：https://github.com/ng-alain/delon/blob/master/packages/theme/src/services/settings/settings.service.ts

默认保存到 localStorage 中，所使用的键值

export interface SettingsKeys {
  /** Layout data specifies the stored key,  default: `layout` */
  layout: string;
  /** User data specifies the stored key,  default: `user` */
  user: string;
  /** App data specifies the stored key,  default: `app` */
  app: string;
}

然后，尝试加载 JWTTokenModel

let token: any = this.tokenService.get(JWTTokenModel);
        if (token) {
          user.name = token.name;
          user.email = token.email;
        }
        this.settingService.setUser(user);
        // ACL：设置权限为全量
        this.aclService.setFull(true);
        // 初始化菜单
        this.menuService.add(appData.menu);
        // 设置页面标题的后缀
        this.titleService.default = '';
        this.titleService.suffix = appData.app.name;

i18n.service.cs 中注入了 SettingsService 来获得语言配置信息

if (this.settings.layout.lang) {
      return this.settings.layout.lang;
}

在 callback.componet.cs 中，当用户登录之后的回调中，重新设置当前用户信息。

this.settingsSrv.setUser({
      ...this.settingsSrv.user,
      ...info
    });

需要注意的是，SettingsService 提供了一个 notify 的属性，用来返回一个 Observable 的可观察对象。

get notify(): Observable<SettingsNotify> {
    return this.notify$.asObservable();
  }

当重新设置用户的时候，会发射一个通知出来。

setUser(value: U): void {
    this._user = value;
    this.setData(this.KEYS.user, value);
    this.notify$.next({ type: 'user', value });
  }

当访问 user 属性的时候，如果还没有设置用户，会从默认的 localStorage 中读取出来当前用户的数据

get user(): U {
    if (!this._user) {
      this._user = { ...this.getData(this.KEYS.user) };
      this.setData(this.KEYS.user, this._user);
    }
    return this._user as U;
  }

使用的键值如下：

export interface SettingsKeys {
  /** Layout data specifies the stored key,  default: `layout` */
  layout: string;
  /** User data specifies the stored key,  default: `user` */
  user: string;
  /** App data specifies the stored key,  default: `app` */
  app: string;
}

冠军