跳到主要内容
版本:3.0.0

服务和注入

在业务中,只有控制器(Controller)的代码是不够的,一般来说会有一些业务逻辑被抽象到一个特定的逻辑单元中,我们一般称为服务(Service)。

image.png

提供这个抽象有以下几个好处:

  • 保持 Controller 中的逻辑更加简洁。
  • 保持业务逻辑的独立性,抽象出来的 Service 可以被多个 Controller 重复调用。
  • 将逻辑和展现分离,更容易编写测试用例。

创建服务

在 Midway 中,普通的服务就是一个 Class,比如我们之前创建了一个接受 user 请求的 Controller,我们来新增一个处理这些数据的服务。

对于服务的文件,我们一般会存放到 src/service 目录中。我们来添加一个 user 服务。

➜  my_midway_app tree
.
├── src
│ ├── controller
│ │ ├── user.ts
│ │ └── home.ts
│ ├── interface.ts
│ └── service
│ └── user.ts
├── test
├── package.json
└── tsconfig.json

内容为:

// src/service/user.ts
import { Provide } from '@midwayjs/core';

@Provide()
export class UserService {

async getUser(id: number) {
return {
id,
name: 'Harry',
age: 18,
};
}
}

除了一个 @Provide 装饰器外,整个服务的结构和普通的 Class 一模一样,这样就行了。

之前我们还增加了一个 User 定义,这里也可以直接使用。

import { Provide } from '@midwayjs/core';
import { User } from '../interface';

@Provide()
export class UserService {

async getUser(id: number): Promise<User> {
return {
id,
name: 'Harry',
age: 18',
};
}
}

使用服务

在 Controller 处,我们需要来调用这个服务。传统的代码写法,我们需要初始化这个 Class(new),然后将实例放在需要调用的地方。在 Midway 中,你不需要这么做,只需要编写我们提供的 "依赖注入" 的代码写法。

import { Inject, Controller, Get, Provide, Query } from '@midwayjs/core';
import { UserService } from '../service/user';

@Controller('/api/user')
export class APIController {

@Inject()
userService: UserService;

@Get('/')
async getUser(@Query('id') uid) {
const user = await this.userService.getUser(uid);
return {success: true, message: 'OK', data: user};
}
}

使用服务的过程分为几部分:

  • 1、使用 @Provide 装饰器暴露你的服务
  • 2、在调用的代码处,使用 @Inject 装饰器注入你的服务
  • 3、调用注入服务,执行对应的方法

Midway 的核心 “依赖注入” 容器会自动关联你的控制器(Controller) 和服务(Service),在运行过程中会自动初始化所有的代码,你无需手动初始化这些 Class。

注入行为描述

看到这里,你会有一些疑惑,为什么服务(Service)上有一个 @Provide 装饰器,但是控制器(Controller) 上没有。

事实上,控制器(Controller) 上也有这个装饰器,只是在新版本中,Controller 包含了 Provide 的功能。如果你不确定什么时候可以隐藏,可以都写上。

你如果不写,默认等价于下面的代码。

@Provide()
@Controller('/api/user')
export class APIController {

@Provide 装饰器的作用:

  • 1、这个 Class,被依赖注入容器托管,会自动被实例化(new)
  • 2、这个 Class,可以被其他在容器中的 Class 注入

而对应的 @Inject 装饰器,作用为:

  • 1、在依赖注入容器中,找到对应的属性名,并赋值为对应的实例化对象
信息

@Inject 的类中,必须有对应的 @Provide 才会生效。

@Provide@Inject 装饰器是成对出现的,两者通过冒号后的类名进行关联。

// service
@Provide()
export class UserService {
//...
}

// controller
@Provide() // <------ 由于有 Controller 包含了 Provide 的能力,这里展示的更加完整
@Controller('/api/user')
export class APIController {

@Inject()
userService: UserService; // <------ 这里的类型是 Class,即会注入一个该类型的实例

//...
}

这样的组合之后会用到很多地方,请务必记住这个用法

依赖注入还有更为复杂的情况,可以阅读 依赖注入 参考。