开发中间件插件

ThinkKoa团队欢迎用户贡献自己开发的中间件。具体的开发规范和流程。

创建中间件插件工程

目录结构

• lib/ 存放源代码
• test/ 单元测试目录
• .eslintrc eslint 检查配置文件
• .gitignore git忽略的文件
• .npmignore npm 发布时忽略的文件
• .travis.yml travis 持续集成配置文件
• package.json npm 配置文件
• README.md 说明文件

开发

代码格式

中间件代码模板格式：

//引入依赖包
const xxx = require('xxx'); 
module.exports = function(options, app) {
    return  function (ctx, next) {
        ......
    }
}

app 为 thinkkoa的实例, options为中间件默认配置

中间件包含异步，使用async/await:

//引入依赖包
const xxx = require('xxx'); 
module.exports = function(options, app) {
    return  async function (ctx, next) {
        ......
        await ......
    }
}

扩展规范

• 1、处理http输入输出(request及response)相关功能函数扩展，设置为ctx的属性，例如：

const lib = require('think_lib');
//ctx.test is getter
lib.define(ctx, 'test', function(arg) {
    ...
});
ctx.test = 111; //Error Cannot set property test of #<Object> which has only a getter
//ctx.aaa is writable
lib.define(ctx, 'aaa', function(arg){
    ...
}, 1);
ctx.aaa = 222; 
console.log(ctx.aaa); //222

• 2、其他通用功能函数扩展，设置为app的属性，例如：

const lib = require('think_lib');
//app.test is getter
lib.define(app, 'test', function(arg) {
    ...
});

• 3、在扩展功能的时候，为了保持对koa原生中间件的兼容性，不管是ctx还是app都不能重载已有的属性；且扩展属性或函数名不能以_开头命名。具体属性列表见API

• 4、为保持中间件之间解耦，尽量使用koa原生属性来实现中间件

单元测试

在 test/index.js 文件书写相关的单元测试，测试框架使用 mocha， 需要配置下面的命令进行单元测试并输出结果：

npm run test-cov

可以参考我们已经发布的中间件源码(github)进行具体的中间件开发: 中间件列表

说明文档

代码开发和单元测试完成后，需要在README.md 里书写详细的说明文档。

发布

代码版本库托管到github.com， 并且使用 npm publish 发布到 npm仓库（如果之前没发布过，会提示创建帐号和密码）。

发布完成后，请给我们发邮件或者 issuse，经确认后，即可添加到到插件列表中。会有奖励哦。