zoukankan      html  css  js  c++  java
  • 【工具】根据后端提供的swagger生成前端的axios请求配置文件/api

    根据后端提供的swagger生成配置文件(JavaScript文件)【简单的说,就是生成api目录】

    github地址在这里:github.com/littleHiuma…

    用法

    假设后端提供的swagger地址是http:255.255.255.255:3000/swagger-ui.html ,只需要取前面部分就可以了(ip加端口)

    一个ip的情况下: node generateIt.js --ip=http:255.255.255.255:3000

    多个ip的情况下(使用,来分割): node generateIt.js --ip=http:255.255.255.255:3000,http:255.255.255.254:1000


    说几句

    (重要的事情说三遍)

    生成之前会先删掉文件夹里面的内容,受影响的话,请把内容移动到其他文件夹!!!

    生成之前会先删掉文件夹里面的内容,受影响的话,请把内容移动到其他文件夹!!!

    生成之前会先删掉文件夹里面的内容,受影响的话,请把内容移动到其他文件夹!!!


    生成之后会有一句提示:某个域名一共n个模块(2020-11-30补充)

    这个模块是按请求url来划分的,比如:

    /adminUser/test、/adminUser/jest 这两个就属于一个模块(adminUser模块)

    /adminUser/test、/test/adminUser 这两个就属于两个模块(adminUser模块,test模块)


    生成的文件夹是【不一定】有顺序的,【因为请求返回的顺序无法控制,先返回的先处理】,文件夹名称暂定是api加索引(api0、api1、…apin)(2020-11-30补充)

    执行完的提示语添加了域名

    生成的文件夹是和generateIt.js在同一目录下的(我加到下面的问题里了)


    因为是根据swagger来生成的配置文件,后端对接口描述越详细越好

    我们这里的后端提供的swagger对接口描述的不是特别详细(比如图中有的字段没有描述),所以这个工具的提升空间很大(哈哈哈)

    下面的图中的请求参数的类型使用的是后端定的类型,我没有去处理…(我加到下面的问题里了)

    还有就是!如图,import request from '@/utils/request'这一句我暂时是写死的(我加到下面的问题里了)


    已发现的问题/可优化的问题:

    1. 如果后端对参数类型描述不准确,得人力去改…(哭

    2. 请求参数的类型使用的是后端定的类型

    3. request文件的引入和命名,暂时是写死的(import request from '@/utils/request'

    4. 导出文件这种类型的接口(返回值是文件),需要自己添加responseType: 'blob'

    5. 函数的方法名可能会出现JavaScript的关键字(2020-11-30补充)【已修复:如果有关键字,拼接url中倒数第二段字符串,否则拼接时间戳】

    6. 函数的方法名可能会重复(2020-11-30补充)

      增加了两个提示语:(2020-11-30补充)

      1.“计算url后缺失n个【原因:url重复】”

      2.“处理函数名后,还有重复!!”(但是依然会写入js文件中)

    7. 生成的文件夹和generateIt.js在同一目录(2020-11-30补充)


    对您有帮助的话,麻烦帮我点个star呀!

    欢迎大家来完善这个工具或者提问题反馈一下呀!

    这个工具仅作学习和辅助使用哦。


    作者:hiuman
    链接:https://juejin.cn/post/6900093883309686797/
    来源:掘金
    著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
  • 相关阅读:
    AIBigKaldi(二)| Kaldi的I/O机制(源码解析)
    OfficialKaldi(十四)| 从命令行角度来看Kaldi的 I / O
    GNU Make函数、变量、指令
    C/C++编码规范(google)
    [English]precede, be preceded by
    视频压缩技术、I帧、P帧、B帧
    SMB
    printf占位符
    使用 Yocto Project 构建自定义嵌入式 Linux 发行版
    gcc fpic fPIC
  • 原文地址:https://www.cnblogs.com/hiuman/p/14060435.html
Copyright © 2011-2022 走看看