自动API调用代码工具（百家饭OpenAPI工具）最新进展

科技 07-15 来源：清新油腻男

本周关于自动将后台接口文档（OpenAPI文档）翻译成JS代码的工作进行了第一个迭代的开发，完成了基于axios的初步版本，同时，使用百家饭上面的公开API（浙里办SSO API)生成了示例代码，模板和示例已经上传到了gitee的开源仓库，详情点击查看

生成逻辑说明

主要的生成逻辑如下：

入口脚本

index.js 存储了类库的入口代码，示例生成内容如下：

const axios = require("axios");
const config = require("./config.js");
const instance = axios.create(config);

const sso_servlet_organduser = require("./api-sso_servlet_organduser.js");
sso_servlet_organduser.injure(instance);


module.exports = instance;

主要内容就是生成axios的instance，并将instance传给每个path的生成代码，进行函数的注入，最后作为统一的对象export，这样，使用方就可以直接require这个库，进行使用，使用示例如下：

const axios = require("./axios");

axios.getSsoServletOrganduser().then(res=>{
    console.log(res);
}).catch(err=>{
    console.log(err);
})

全局配置脚本

config.js存储全局的配置信息，包括服务器选择和参数设置，示例生成内容如下：

module.exports = {
  // 认证服务
  baseURL: 'https://puser.zjzwfw.gov.cn/',
  
  // 打开下一行，修改请求超时时间，当前例子为10s
  // timeout: 10 * 1000
}

在考虑代码生成的同时，在生成接口地址的地方，同时使用API文档中的地址描述信息生成了对应地址的描述，作为注释加到了地址的前方，方便用户在后期开发中进行选择和修改。

接口脚本

针对接口中定义的每一个接口，会自动生成对应的一个接口js文件，以api-xxx命名，示例内容如下：

const { verify, timestr,md5 } = require("./functions.js");

const injure = (instance)=>{
    var config = {params:{}};
    
    // 路径：sso/servlet/organduser， 调用方法GET
    
    //params要求传输以下属性，没有标注'有默认值'的参数由调用方传输
    //-method(有默认值)：调用方法
    //-servicecode：接入资源在SSO注册成功后的业务代码，由【SSO管理员】提供。
    //-time(有默认值)：时间戳，当前时间 年月日时分秒 例：2009年10月10日 12时12分12秒格式为20091010121212
    //-sign(有默认值)：MD5(servicecode+servicepwd+time)，将业务代码、业务密钥、发送时间按顺序连接并进行md5加密。注：1、参数servicepwd由【SSO管理员】提供；2、MD5算法是标准算法，可使用java内部实现；3、MD5后的值为32位并且小写。
    //-userid：用户在SSO的身份唯一标示
    //-datatype(有默认值)：数据格式  xml  json。默认xml
    //-servicepwd：分配的密码，注意，该参数仅用于sign计算
    instance.getSsoServletOrganduser = (params = {}) => {

        var verify_err = null ||
            verify(params.servicecode,"servicecode",{"required":true}) ||
            verify(params.userid,"userid",{"required":true}) ||
            verify(params.servicepwd,"servicepwd",{"required":true});
        if ( verify_err !=null){
           return verify_err;
        }
        
        var defaultParam = { 
            datatype: "json",
            method: "getUserInfoById",
        };

        params = Object.assign(defaultParam,params);
        if (params.time == undefined){ 
            params.time= timestr("YYYYMMDDHHmmss");
        }
        if (params.sign == undefined){ 
            params.sign= md5(params.servicecode+params.servicepwd+params.time);
        }
        
        return instance.get("sso/servlet/organduser",{params});
    }
    
}

module.exports = {
    injure
}

如果接口定义了get方法，则文件会在传入的axios instance中注入getXxx的方法，如果是post则为postXxx，其他方法类推。

该方法包括以下部分：

入参校验，对接口定义中定义为必传，但是不包含默认值的参数进行判断，如果检查有问题，直接返回reject的Promise。
默认值填充，对接口定义中包含了默认值，且默认值不是可计算属性的参数，构建一个默认参数对象，与传入参数进行合并。
对没有传入数值，但是参数定义中，定义为计算属性（就是默认值以‘=’开头的属性，例如timestr("YYYYMMDDHHmmss"))，将计算表达式翻译成实际js代码。
调用axios的原始函数，如get，post等。

辅助函数

生成结果中另包含辅助的支撑计算属性的函数，目前包括md5和timestr两个函数，以及校验参数使用的verify函数。

const dayjs = require("dayjs");
const md5 = require("md5");

module.exports = {
  timestr: (fmt) => {
    return dayjs().format(fmt);
  },
  md5: (str) => {
    return md5(str);
  },
  verify: (par, name, option) =>{
    if (option.required && par == undefined){
      return Promise.reject("参数"+name+"要求必传，但未传入");
    }
  }
}