模块Scope

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

Vona 的 IOC 容器为何代码更简洁？

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

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

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

src/suite/a-home/modules/home-base/src/service/menu.ts

@Service()
export class ServiceMenu extends BeanBase {
  retrieveMenus(publicPath?: string) {
    console.log(this.scope);
  }
}

• 通过this.scope即可访问到当前 bean 所属模块的Scope实例

this.$scope: 跨模块获取Scope实例

那么，如何获取其他模块的Scope实例呢？

比如，我们在模块 home-index 中获取模块 home-base 的 Scope 实例：

@Controller()
class ControllerHome extends BeanBase {
  index() {
    console.log(this.$scope.homeBase);
  }
}

• 通过this.$scope.homeBase即可获取模块 home-base 的Scope实例

@Controller()
class ControllerHome extends BeanBase {
  index() {
    console.log(this.$scope.user);
  }
}

• 如果模块名称的 providerId 为a，比如a-user，那么可以简化为user

app.scope: 获取Scope实例的一般方法

如果没有继承自基类BeanBase，无法使用this.scope和this.$scope，则可以使用一般方法：

src/backend/play/index.ts

export async function main(app: VonaApplication, _argv: IArgv) {
  await app.bean.executor.mockCtx(async () => {
+   const scopeHomeBase = app.scope('home-base');
+   const scopeUser = app.scope('a-user');
  });
}

Scope对象的成员

名称	说明
config	模块的Config配置
constant	模块的常量定义
locale	模块的I18n国际化
error	模块的错误异常
service	模块的Services
model	模块的Models
entity	模块的Entities