Skip to content

模块Scope

在 Zova 中,实际的业务代码开发都是在模块中进行。模块作为一个相对独立的业务单元,包含各种类型的资源:Config配置Constant常量Locale国际化Error错误异常Api服务,等等。为了统一管理这些资源,方便资源的定义和使用,Zova 提供了Scope对象

Zova 的 IOC 容器为何代码更简洁?

原因就是优先使用依赖查找策略,从而使用更少的装饰器函数,使用更少的类型标注。通过Scope对象访问模块提供的资源,就是践行依赖查找策略的机制之一

如何获取Scope实例

所有 bean 都继承自基类BeanBaseBeanBase支持传入范型参数ScopeModule。当传入范型参数ScopeModule之后就可以直接获取到当前 bean 所属模块的Scope实例

testA.ts为例:

typescript
import { BeanBase, Local } from 'zova';
import { ScopeModule } from '../.metadata/this.js';

@Local()
export class TestA extends BeanBase<ScopeModule> {
  protected async __init__() {
    console.log(this.scope);
  }
}
  • 通过this.scope即可访问到当前 bean 所属模块的Scope实例

Scope对象的成员

名称说明
config模块的Config配置
constant模块的常量定义
locale模块的I18n国际化
error模块的错误异常
service模块的Api服务

跨模块访问Scope实例

那么,如何访问其他模块的Scope实例呢?

Scope对象本身也是一个 bean,因此可以直接采用依赖注入的方式获取到其他模块的Scope实例

仍以testA.ts为例,获取模块home-baseScope实例:

typescript
import { ScopeModuleHomeBase } from 'zova-module-home-base';

export class TestA {
  @UseScope()
  $$scopeModuleHomeBase: ScopeModuleHomeBase;

  protected async __init__() {
    console.log(this.$$scopeModuleHomeBase);
  }
}
  • 导入模块home-baseScope对象的类型
  • 使用UseScope装饰器函数
  • 系统会自动找到模块home-baseScope实例,并且注入给变量$$scopeModuleHomeBase

INFO

基于编译器的加持,UseScope 会自动转为异步加载模式,具体而言就是:系统会异步加载模块home-base,然后取得 home-base 的 Scope 实例,从而完成注入

基于 MIT 许可发布