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
默认保存到 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;
}