yii

基于 koa2 和 typescript 的业务框架，设计上有参考了 Egg.js，与 Egg.js 一样奉行 『约定优于配置』。名字来源于之前经常使用的一款PHP框架 —— Yii。

快速开始

npm i -S yii
npm i -D ts-node typescript

启动项目很简单，新建文件app.ts，输入如下代码。

import Yii from 'yii'

// 使用run启动项目，参数表示监听的端口
new Yii().run(3000)

然后运行下面的命令启动项目。

npx ts-node ./app.ts

目录结构

├── app # 项目文件夹
│   ├── controller # 控制器
│   ├── service # 服务
│   ├── public # 静态资源
│   ├── middleware # 中间件
│   ├── config # 配置文件
│   │   └── index.ts # 默认配置文件
│   │   └── dev.ts # 开发环境配置文件
│   │   └── prod.ts # 正式环境配置文件
│   ├── component # 组件
├── app.ts # 项目启动文件

伴随启动文件的是一个文件目录，这个目录名是可以自定义的，可以在启动文件中配置，默认为app。

new Yii({
  name: 'demo'
}).run(3000)

下面一一介绍各个目录的作用。

控制器 Controller

所有的控制器都放在app/controller文件夹下，且名字必须以Controller结尾，控制器文件属于应用的核心，因为路由也是基于控制器的，下面是一个控制器模版。

// app/controller/SiteController.ts
import { BaseController, Action } from 'yii'

export default class Site extends BaseController {

  async before() {
    console.log('Site Controller before')
  }

  async after() {
    console.log('Site Controller after')
  }

  @Action.get
  async info(ctx: any) {
    ctx.body = 'hello site info'
  }

  @Action.post
  async getSiteInfo(ctx: any) {
    ctx.body = 'site info'
  }

}

所有的控制器需要继承BaseController，且两个方法before和after，请求到来时，每次先经过before方法，然后请求处理完毕后，再经过after方法。

控制器中的方法如果被Action装饰器修饰后，就会变成一个对外暴露的路由，比如上面的info方法。请求的路由为对应的控制器名 + 方法名，如果我要请求SiteController的info方法，如下：

curl http://localhost:3000/site/info

如果方法名或者控制器名使用了驼峰方式，会自动转成横杠连接，比如请求getSiteInfo方法，如下：

curl http://localhost:3000/site/get-site-info

Action装饰器

Action装饰器下面对应了常用的http方法：

const Methods = [
  'HEAD',
  'OPTIONS',
  'GET',
  'PUT',
  'PATCH',
  'POST',
  'DELETE'
]
Methods.push('ALL')

如果使用 @Action.all 修饰方法，表示能使用任意方法进行访问。

服务 Service

所有的服务都放在app/service文件夹下，且名字必须以Service结尾，服务表示业务逻辑的进一步抽象，如果有多个控制器调用某个逻辑，那么就可以考虑把这段逻辑抽象到服务中。

// app/service/UserService.ts
import { BaseService } from '../../lib'

export default class User extends BaseService {
  getName() {
    return 'shenfq'
  }
}

所用的控制器都可以在ctx中访问服务的实例。

@Action.get
async useService(ctx: any) {
  const userService = ctx.service.user
  ctx.body = userService.getName()
}

中间件 Middleware

app/middleware文件夹下，存放中间件，每个文件都会暴露一个方法，该方法会传入koa的use方法。所有middleware的优先级都高于控制器的方法调用。

// app/middleware/log.ts
import { BaseContext } from 'koa'
export default async function (ctx: BaseContext, next: Function) {
  console.log('调用中间件')
  next()
}

框架默认使用了两个中间件koa-static 和 koa-bodyparser。

koa-static会设置一个静态资源的文件夹，默认是public文件夹，但是也可以在启动应该的时候进行自定义。

new Yii({
  name: 'app',
  static: 'static'
}).run(3000)

配置 Config

├── config # 配置文件
│   └── index.ts # 默认配置文件
│   └── dev.ts # 开发环境配置文件
│   └── prod.ts # 正式环境配置文件
│   └── other.ts # 其他配置文件

在config文件夹下编写配置文件，一般会有是三个默认的配置文件，分别是index.ts、dev.ts、prod.ts。index.ts每次都会加载，而另外两个文件，如果process.env.NODE_ENV 为 development 则加载dev.ts，其他情况加载prod.ts。

其他配置文件会根据文件名，合并成一个对象。

//a.ts
export default{
  name: 'a'
}
//b.ts
export default{
  name: 'b'
}
// merge
{
  a: { name: 'a' },
  b: { name: 'b' }
}

最后会将默认配置、环境变量配置以及其他配置通过Object.assign()方法合并成一个对象，挂载到框架对象下。

想要在控制器或者服务中调用，只需要使用 this.config 即可获得该对象。

TODO

• 发布脚本
• 完善组件
• 测试用例
• cli工具