Skip to content

模块Scope

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

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

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

this.scope: 获取本模块Scope实例

所有 bean 都继承自基类BeanBase,因此可以直接获取到当前 bean 所属模块的Scope实例。

typescript
class ControllerTest extends BeanBase {
  async test() {
    console.log(this.scope);
  }
}
  • 通过this.scope即可访问到当前 bean 所属模块的Scope实例

Scope对象的成员

名称说明
config模块的Config配置
constant模块的常量定义
locale模块的I18n国际化
error模块的错误异常
api模块的Api资源
apiSchema模块的ApiSchema资源

跨模块访问Scope实例

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

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

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

class ControllerTest {
  @UseScope()
  $$scopeHomeBase: ScopeModuleHomeBase;

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

INFO

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

基于 MIT 许可发布