koa大型web项目中使用路由装饰器的方法示例

一、关于重复造*解释下

在npmjs上搜索关于koa路由装饰器的已经有那么几个包了,但是我从几个包中发现作者的思维仅仅限制于前端开发的思想,项目分层不明确,我们开发kow-web项目可以根据java-web中项目分层的思想来写项目,项目结构清晰明了,本人封装这个包也是参考了java-web开发过程中把项目分为四层架构。

1、controllers:路由的控制
2、servers:常用于一些业务逻辑的判断
3、dao:操作数据库的
4、models:关于建表的数据模型

二、关于koa2-router-decors包的使用步骤

1、构建一个项目,并创建分层目录

2、安装

npm install koa2-router-decors
// or
yarn add koa2-router-decors

3、在中间件中使用我们安装的包

import { resolve } from 'path';
import route from 'koa2-router-decors';
// 可以写到config中统一配置
const api_version = '/api/v1';
/**
 * @description: 反转路径的方法
 * @param {string} 
 * @return: 
 */
const dir = path => resolve(__dirname, path);

/**
 * @description: 路由中间件读取controllers中的装饰器配置
 * @param {type} 
 * @return: 
 */
export default (app) => {
 // 这个地方是要读取的文件夹目录
 const apipath = dir('../controllers/*');
 // 实例化类并调用方法
 const route = new route(app, apipath, api_version);
 route.init();
};

4、使用中间件

5、在controllers的文件夹中使用装饰器

@controller('/user')
export class usercontroller extends basecontroller {
 constructor() {
  super();
 }
 /**
  * 
  * @api {post} /api/v1/user/create/ 添加用户
  * @apidescription 创建用户的接口
  * @apiname createuser
  * @apigroup users
  * @apiversion 0.1.0
  * @apiparam {string} username="张三" 用户名
  * @apiparam {string} mobile 手机号码
  * @apiparam {string} email 邮箱
  * @apiparam {string} password 密码
  */
 @post('/create')
 @required({ body: ['username', 'mobile', 'password'] })
 async createuser(ctx) {
  const result = await userserver.createuser(ctx.request.body);
  ctx.success(result);
 }
 ....
}

6、具体代码可以参考example中写的

三、关于example代码跑起来的说明

1、使用的是mysql

2、mysql建表sql

create table `user` (
 `id` int(11) not null auto_increment,
 `username` varchar(30) not null,
 `mobile` varchar(11) default null,
 `email` varchar(20) default null,
 `password` varchar(255) not null,
 `created_at` datetime default current_timestamp,
 `updated_at` datetime default current_timestamp on update current_timestamp,
 primary key (`id`)
) engine=innodb auto_increment=12 default charset=utf8

3、在example的根目录下创建一个.env的文件

db_host=数据库地址
db_username=数据库连接名
db_password=数据库连接密码
db_database=数据库名

四、,欢迎小伙伴提出问题，方便点赞一个

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。