V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
Rickyes
V2EX  ›  分享创造

造轮子系列 --- 注解、插件式 node.js web / restful api 框架

  •  
  •   Rickyes ·
    rickyes · 2018-07-22 17:35:53 +08:00 · 1807 次点击
    这是一个创建于 2076 天前的主题,其中的信息可能已经有所发展或是发生改变。

    先放地址:polix.js

    polix是基于koa v2.5.0IOC、插件式开发框架,和平常的Node.js Web Framework相比,它无需另外绑定路由集合、可拓展、开发简单,依照java的著名依赖注入框架spring来制作,让开发者专注于逻辑。polix采用多服务多进程架构来保证服务的稳定和快速响应能力。polix的中间件和koa v2.x的中间件保持兼容。默认使用的ORMsequelize(后续会提供polix-orm)。开发者可以选择 ES6/7/8 或者 TypeScript 来进行开发。

    $ npm i polix --save
    

    Getting Started

    使用polix-cli初始化应用

    $ npm i polix-cli -g
    $ pol init example && cd example
    $ make build && make dev
    

    Service

    service文件夹下添加user.js

    const { Service } = require('polix');
    
    class UserService extends Service {
      constructor(){
        super();
        this._name = {};
      }
    
      async addUser(userId,name){
        this._name[userId] = name;
        return this;
      }
    
      async getUser(userId){
        return this._name[userId];
      }
    }
    
    module.exports = UserService;
    

    Controller

    controller文件夹下添加user.js

    const { Controller, GET, POST, DEL, PUT  } = require('polix');
    
    class UserController extends Controller {
      
      // POST /user/add User
      @POST
      async addUser(param, ctx){
        await this.service.user.addUser(param.userId,param.name);
        ctx.body = {
          result: 'ok'
        };
      }
    
      // GET /user/getUser
      @GET
      async getUser(param, ctx){
        let user = await this.service.user.getUser(param.userId);
        ctx.body = {
          user
        };
      }
    
      // GET /user/info
      @GET('info')
      async getInfo(param, ctx){
        ctx.body = {
          v: 'v1.0'
        }
      }
    
      // PUT /user/updateUser
      @PUT
      async updateUser(param, ctx){
        ctx.body = {
          status: true
        }
      }
    
      // DEL /user/delUser
      @DEL
      async delUser(param, ctx){
        ctx.body = {
          status: true
        };
      }
    
      // GET /user/status/:userId
      @GET('status/:userId')
      async getStatus(param, ctx){
        ctx.body = {
          status: true,
          userId: param.userId
        };
      }
    
    }
    
    module.exports = UserController;
    

    Middware

    polix的中间件与 koa 2.x 的中间件保持兼容
    框架默认加载koa-body中间件,如需另外添加中间件则新建middware文件夹(与controller文件夹平级)
    添加跨域中间件 ,新建cors.js:

    # cors.js
    
    const cors = require('koa2-cors');
    module.exports = function(){
      return cors({
        origin: function(ctx) {
          return '*';
        },
        exposeHeaders: ['WWW-Authenticate', 'Server-Authorization'],
        maxAge: 5,
        credentials: true,
        allowMethods: ['GET', 'POST', 'DELETE'],
        allowHeaders: ['Content-Type', 'Authorization', 'Accept']
      });
    }
    

    该文件夹下必须存在index.js文件作为总输出中间件文件,加载时根据导出对象的顺序进行绑定中间件

    # index.js
    
    const cors = require('./cors');
    
    module.exports = {
        cors // 必须是函数 ,绑定方式为:app.use(cors())
    }
    

    Plugin

    $ npm i --save polix-request
    

    在项目根目录下的config文件夹下的plugin.default.js中添加以下代码

    // `curl`最终会挂载到`this.app`下
    exports.curl = {
      // 表示是否启用该插件
      enable: true,
      // 插件`npm`包名
      package: 'polix-request'
    };
    

    controller里用polix-request

      @GET
      async getWebInfo(param, ctx){
        let result = await this.app.curl.get('https://www.baidu.com');
        ctx.body = {
          data: result
        }
      }
    

    polix已经内置polix-request插件了,这里只是个演示

    Start

    $ make dev
    

    觉得好的可以给个 star~

    地址:polix.js

    目前尚无回复
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   2795 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 15:27 · PVG 23:27 · LAX 08:27 · JFK 11:27
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.