Node-aid NPM | npm.io

AID Library (辅助库)

一个应用开发辅助库。提供搭建简易业务逻辑代码执行组件(中间件)，独立于外层其他框架(koa,express,socket等其他应用环境框架)，方便将逻辑代码接入不同的外层框架。也支持常用的函数方法，简化代码（如：数据集合处理）

获取库

npm install node-aid

使用

koa挂载组件：

const Koa = require('koa'),
    Path = require('path'),
    Aid = require('node-aid'),
    {join} = Path,
    {Koa:aid} = Aid;

const PORT = process.env.PORT || 80,
    app = new Koa(),
    ctrlPath = join(__dirname,'ctrl'),//业务代码目录
    viewPath = join(__dirname,'view');//视图代码目录

// 挂载组件
app.use(aid([ctrlPath],[viewPath,undefined]));
// 如下,只简单respond，不使用视图处理
// app.use(koa(ctrl));

app.listen(PORT);

业务逻辑：(.../ctrl/xxx.js)

const Schema = require('../schema/schema'),
    Model1 = require('../model/model1'),
    Model2 = require('../model/model2');

const {validateP1,validateP2} = Schema;

// 可以使用async,promise及普通函数
exports.post = async ({p1,p2})=>{

    const vp1 = await validateP1(p1),
        vp2 = await validateP2(p2);
    
    // 格式检查
    // status 400
    // body {p1:true,p2:fasle}
    if(!(vp1 && vp2))
        return [400,{p1:vp1,p2:vp2}]; 

    // 业务判断，返回给xxx视图代码处理
    // status 由xxx视图设置
    // body 由xxx视图设置
    const contain = await Model1.contain(p1);
    if(!contain)
        return [['xview','post'],{contain},{p1,p2}]
    
    const table = await Model2.query(p2);
    // 正常响应
    // status 200
    // body {table:...}
    return [200,{table}];
}

视图处理：(.../view/xview.js)

// 可以使用async,promise及普通函数
exports.post = (ctx,body,params)=>{
    ctx.status = 404;
    ctx.body = body;
    // 中止调用后续next
    return true;
}

请求

curl -H "Content-Type:application/json" -X POST --data '{"p1":123,"p2":"p2"}' http://host:port/xxx

API

Handle执行流程

aid.Koa(routes,views) 基于koa构建执行流程
- routes,views均为目录路径，views中undefind则创建默认处理视图
- view返回数组顺序为：status,body,headers,cookies
- view返回对象为：{status,body,headers,cookies}
aid.Handle(routes,views) 构建执行流程
- routes为功能路由模块数组
- views为视图处理模块数组
aid.Route(dirname) 目录下模块路由
aid.Context (mapping,...args) 参数构建
- mapping为参数映射，如将param1映射为param2或param3为{param1:["param2","param3"]}
- args为取值的对象
aid.View(route) 视图处理,route为undefined即默认处理（返回功能执行结果）
- route为功能路由模块