@4a/koa-api-router

$3

router.append(resolver, {

// ROOT表示根路由，等同于 /
async get_ROOT(ctx, next) {
const params = ctx.query

// 参数合法性检查
// 此处不通过会直接抛出ResultMessage关联异常
// Response响应结果类似 { code: 400000, message: 'error message' }
// 如果ctx.ResponseId有值，则Response响应结果类似：
// { code: 400000, message: 'error message', ResponseId: '...' }
assert.ok(params.token, ResultMessage.PermissionDenied)

// 此处assert是@4a/enum模块下定制版的断言模块
// @4a/enum/assert断言模块仅支持由@4a/Enum创建的静态枚举类型创建的EnumError异常
// 当然也可以使用Nodejs官方提供的assert断言库，after方法稍加处理即可兼容
assert.ok(params.token.length >= 6, ResultMessage.ErrorToken)

assert.ok(params.email, ResultMessage.LossEmail)

// 参数检查通过之后，暂存到ctx.state属性之下
// 下游resolver会用到它
ctx.state.params = params

// 当然不仅仅是参数检查
// 任何你需要预处理程式都可以在这里定义
// 任意条件不通过，即可在此处抛出异常信息
// 所有预处理通过之后，即可执行await next() 交由下游resolver进一步处理

await next()
},

// 路由规则
// {Method}_{RoutePath}_{RouteResolverKey}
// 当 RoutePath == RouteResolverKey 时，RouteResolverKey可以省略
// 因为路由规则使用下划线作为分隔符，所以路由规则关键字中不能再使用额外的下划线
async 'get_app/:id_getApp'(ctx, next) {
const params = ctx.params

assert.ok(isNaN(params.id), ResultMessage.NotFound)

ctx.state.params = params

await next()

// 可根据需要在此执行某些收尾工作
// 接口响应异常收集、上报等通过程式建议放在after方法内
// after方法下文有介绍
},

// 当 RoutePath == RouteResolverKey 时，RouteResolverKey可以省略
async get_login(ctx, next) {
await next()
}
})