版本：3.0.0

服务和注入

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

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

保持 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，即会注入一个该类型的实例

  //...
}

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

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

服务和注入

创建服务​

使用服务​

注入行为描述​

创建服务

使用服务

注入行为描述