服务(Service)

使用

cli 工具在初始化会自动生成 service 目录,可直接在 service 目录中编写 service

app
|- src
  |-middleware
  |-config
  |-controller
  |-service
    |-demo.service.ts
1
2
3
4
5
6
7

命名规范: *.service.ts

编写 service 时需继承默认 baseService 以便我们将 service 挂载到 ctx 中

import { BaseService } from '@umajs/core'

export default class demo extends BaseService {
  demoService() {
    return 'this is demo service'
  }
}
1
2
3
4
5
6
7

controller 中使用

  • 引入 service
  • 依赖注入 @Service('demo')
  • 注入之后可直接使用无需再进行实例
// controller
import DemoService from '../service/demo.service'

export default class Index extends BaseController {
  @Service(DemoService)
  demoService: DemoService

  @Path('/demo')
  demoService() {
    // return this.demoService.loadAll();
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
// service
import { BaseService } from '@umajs/core'

export default class Demp extends BaseService {
  loadAll() {
    // return
  }
}
1
2
3
4
5
6
7
8

在非 Controller 中使用 Service 时,必须传入 ctx 进行实例化才能使用。

  • 在插件中使用
// plugin
import DemoService from '../service/demo.service';

export default (uma: Uma, options: any = {}): Koa.Middleware => {
    return (ctx, next) = > {
        const demoService: DemoService = new DemoService(ctx);
        // ...
    };
};
1
2
3
4
5
6
7
8
9
  • 在 Aspect 切面中使用
// Aspect
import DemoService from '../service/demo.service'

export default class Method implements IAspect {
  async around(proceedPoint: IProceedJoinPoint) {
    const { target, proceed, args } = proceedPoint

    const demoService: DemoService = new DemoService(target.ctx)

    const result = await proceed(...args)

    return result
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

此外,框架还提供了@Resource 和@Inject 装饰器来实现IOC容器依赖注入

IOC 参考文档