使用 ts 的最佳境界：化类型于无形

在项目中使用 ts 可以带来类型智能提示与校验的诸多好处。同时，为了减少类型标注，达到化类型于无形的效果，CabloyJS 引入了 ioc 和依赖查找的机制。在上一篇文章中，我们创建了一个业务模块 test-home ，并且采用依赖查找的机制演示了如何优雅的定义和使用资源，包括：Service 服务、Config 配置、国际化语言资源、Error 错误异常

在实际的项目当中，经常会遇到跨模块访问资源的场景，那么，CabloyJS 的依赖查找机制是否仍然可以优雅的实现跨模块访问呢？让我们一睹为快

模块化体系与任务说明

CabloyJS 全栈框架的前后端均采用模块化体系。一个 CabloyJS 项目由多个业务模块组成，每个业务模块都可以包含与自身业务相关的资源，比如：Service 服务、Config 配置、国际化语言资源、Error 错误异常、中间件、定时任务、消息队列、系统启动项，等等

在这里，我们创建一个新的业务模块 test-work ，在 test-work 中访问 test-home 提供的资源

1. 新建业务模块

cabloy api:create:module test-work

2. 新建 API

通过一个命令同时创建一组文件：Route 、Controller 、Service

cabloy api:create:controller work

3. 跨模块访问 Service 服务

接下来，我们在刚才新建的 Service 当中，访问模块 test-home 的 Service 服务

import { BeanBase, Local } from '@cabloy/core';
import { ScopeModule } from '../resource/this.js';

@Local()
export class LocalWork extends BeanBase<ScopeModule> {
  async action({ user }) {
+   const scopeHome = this.getScope('test-home');
+   return scopeHome.local.home.action({ user });
    // return user;
  }
}

通过 getScope 方法获取模块 test-home 的 scope 对象
通过 scope 对象直接访问 Service 服务: home

看一下动画演示，提供了完整的类型智能提示：

4. 跨模块访问 Config 配置

访问模块 test-home 的 Config 配置

import { BeanBase, Local } from '@cabloy/core';
import { ScopeModule } from '../resource/this.js';

@Local()
export class LocalWork extends BeanBase<ScopeModule> {
  async action({ user }) {
    const scopeHome = this.getScope('test-home');
+   const prompt = scopeHome.config.prompt;
    return scopeHome.local.home.action({ user });
    // return user;
  }
}

直接通过 scopeHome 取得 config 中的 prompt 属性值

看一下动画演示，提供了完整的类型智能提示：

5. 跨模块访问国际化语言资源

访问模块 test-home 的国际化语言资源

import { BeanBase, Local } from '@cabloy/core';
import { ScopeModule } from '../resource/this.js';

@Local()
export class LocalWork extends BeanBase<ScopeModule> {
  async action({ user }) {
    const scopeHome = this.getScope('test-home');
+   const message = scopeHome.locale.HelloWorld();
+   const message1 = scopeHome.locale.HelloWorld.locale('en-us');
+   const message2 = scopeHome.locale.HelloWorld.locale('zh-cn');
    return scopeHome.local.home.action({ user });
    // return user;
  }
}

看一下动画演示，提供了完整的类型智能提示：

6. 跨模块访问 Error 错误异常

抛出模块 test-home 提供的 Error 错误异常

import { BeanBase, Local } from '@cabloy/core';
import { ScopeModule } from '../resource/this.js';

@Local()
export class LocalWork extends BeanBase<ScopeModule> {
  async action({ user }) {
    const scopeHome = this.getScope('test-home');
+   scopeHome.error.Error001.throw();
    return scopeHome.local.home.action({ user });
    // return user;
  }
}

直接通过 scopeHome 抛出错误异常 Error001

看一下动画演示，提供了完整的类型智能提示：

后记

CabloyJS 采用 ioc 和依赖查找的机制，让 ts 的使用达到了化类型于无形的最佳境界，从而让我们的代码保持优雅和简洁，进而也能显著提升开发效率，保证代码质量

欲了解更多，请关注每晚 8 点 B 站直播：濮水代码