0.0.2 • Published 6 years ago

kappneirpc v0.0.2

Weekly downloads
-
License
ISC
Repository
-
Last release
6 years ago

neirpc

  • 利用nei内部查询数据接口,获取数据
  • 生成node层的controller、service、router,以及client的api (参考KAPP)

tips

  • 后端nei上定义的rpc接口入参可为对象,也可为参数平铺,注意参数平铺则强依赖后端参数顺序
  • nei接口的标签,标注.neirpc.json中的TAG值的为get请求,不标注默认生成post请求
  • get请求参数会转换为string,所以controller有个转换,只处理number类型

config 参数说明

{
    HOSTNAME: 'nei.netease.com',
    PLATFORM_ID: XXX, //找杭研 nei后端 @包勇明 获取 platformId 
    SALT: "", //找杭研 nei后端 @包勇明 获取 salt 
    PROJECT_ID: 0, //nei 页面url 即可获取
    TAG: "get",//标志 怎么区分get or post请求,如果不满足一律为post请求
    SERVER_TS: true, //server 层是否使用ts
    CLIENT_TS: true, //client 层是否使用ts
    TPL_DIST: "./neiRpcTpl",//配置模版防止文件
    API_DIST: "./client/src/api", // api 存放的目录位置
    SERVICE_DIST: "./server/app/service", //node 的service层
    CONTROLLER_DIST: "./server/app/controller", //node 的controller层
    ROUTER_DIST: "./server/app", //node 的 存放 router的目录
    GROUP_NAME: [],//业务分组,只拉取该分组下的接口数据
    TYPE_SWITCH: ['Number'],//入参需要做强制转换的数据类型,跟NEI类型一致
}

Usage

npm install neirpc -g (最好全局安装)

第一种用法:

创建项目的 .neirpc.json文件
{
    HOSTNAME: 'nei.netease.com',
    PLATFORM_ID: XXX, //找杭研 nei后端 @包勇明 获取 platformId 
    SALT: "", //找杭研 nei后端 @包勇明 获取 salt 
    PROJECT_ID: 0, //nei 页面url 即可获取
    TAG: "get",//标志 怎么区分get or post请求,如果不满足一律为post请求
    SERVER_TS: true, //server 层是否使用ts
    CLIENT_TS: true, //client 层是否使用ts
    TPL_DIST: "./neiRpcTpl",//配置模版防止文件
    API_DIST: "./client/src/api", // api 存放的目录位置
    SERVICE_DIST: "./server/app/service", //node 的service层
    CONTROLLER_DIST: "./server/app/controller", //node 的controller层
    ROUTER_DIST: "./server/app", //node 的 存放 router的目录
    GROUP_NAME: [],//业务分组,只拉取该分组下的接口数据
    TYPE_SWITCH: ['Number'],//入参需要做强制转换的数据类型,跟NEI类型一致
}

执行 neirpc -c .neirpc.json 命令,自动更新接口文件 // 每次nei定义的接口声明变更都需要运行此命令哦

第二种用法

在gulpfile.js中配置任务

let neirpc = require('neirpc');
let config = require('./.neiRpc.json')

gulp.task('rpc', () => {
    neirpc(config)
});

gulp rpc //生成node层的controller、service、router,以及client的api