app后端开发一:swagger-ui教程-构建api接口文档工具

声明


之前写过关于app后端开发的一系列文章,那是我第一次做app后端开发,存在很多不足,本想好好修改一下,想想还是重新写吧,这样子也能让我博客文章看起来多一点嘛,万一以后找工作,别人一看我博客这么多内容,是不是很屌?
这次文章先从构建resetful风格的api文档工具开始。没有一个好的文档工具,在app前端人员开发过程中会导致开发效率极低,而且时不时的,他们就来找你跟他们断点一下。

我的文档经历

这里先不讨论我的数据传输是否合理,仅仅以这些数据作为一个演示。后面会有专门的章节进行app数据传输加密的讲解。


  1. 在我第一次开发app后端的时候,使用的word文档,就是我先将所有数据格式定义好,会返回什么样的数据写好。前端人员照这个来进行开发。贴一张图吧:
    这里写图片描述
    PS:存在的问题:①接口改动时,不易被识别。②维护困难,不便于查找。③前端开发不能进行测试。(如果还要写缺点,有5K+字可以写出来,就省略了哈)
  2. 在我开发第二个APP的后端时,先自己写了一个简易的app接口管理系统,用来后端发布接口,以及前端人员查看。效果如图:
    这里写图片描述
    PS:优点:①如果有多个前端人员,可以保证大家看到的是同一份文档。②通过接口的版本标识,方便大家查看是否修改,优点等等省略。缺点:①不能够进行在线接口测试,需要借助poster插件。
  3. 现在给大家要推荐下我利用一天时间改造的swagger-ui的中文版了。本来英文就非常好了,只是为了了解一下这个东东,顺手给他改成中文版了,也做为自己第一个github的项目吧。还是先上效果图吧:
    接口模块界面:
    这里写图片描述
    接口列表界面:
    这里写图片描述
    某个接口界面:
    这里写图片描述

OK,贴图到此为止啦,如果还没有看够的同学,给你们一个连接,自己去试试:
swagger-ui中文版地址:http://helei112g.github.io/swagger-ui/


相信经过刚刚的体验,不需要我说它的强大与便利了吧?不仅仅可以通过它立即进行在线测试,还可以根据返回的json它自动构建成model。便于你做决策。好处我就不说了,反正自从用了它,我们的前端腰不酸,腿也不痛了。写起代码来也精神了。

哦,最重要的,下载地址:
https://github.com/helei112g/swagger-ui
如果觉得不错,麻烦给个start吧,给我的鼓励一下下,谢谢!

app后端开发系列文章目录

已标记关键词 清除标记
相关推荐
<p> <strong><span style="color:#E53333;">【课程介绍】</span></strong><br /> Swagger视频培训教程,该课程详细讲解Swagger如何使用,其中包括<span>Swagger </span>、<span>Swagger UI</span>、<span> Springfox</span>简介,三者之间的联系;Spring Boot 中快速集成<span>Swagger</span>;<span>Spring MVC </span>中快速集成<span>Swagger</span>;<span>Swagger + Springfox</span>快速入门;<span>Swagger UI</span>国际化 中文<span>API</span>接口的实现。 </p> <p> </p><p> <strong><span style="color:#E53333;">【课程收益】</span></strong><br /> 掌握<span>Swagger </span>、<span>Swagger UI</span>、<span> Springfox</span>简介,三者之间的联系。 Spring Boot 中快速集成<span>Swagger</span>。<span> Spring MVC </span>中快速集成<span>Swagger</span>。<span> Swagger + Springfox</span>快速入门。<span> Swagger UI</span>国际化 中文<span>API</span>接口的实现。  </p> <p> <strong><span style="color:#E53333;">【讲师介绍】</span></strong><span></span> </p> <p> 姚海陆讲师是国产开源框架jeesite联合创始人,jeesite论坛创始人,8年<span>java</span>领域技术研发经验,擅长于互联网信息化应用平台建设研发,代表作品:掌中递、贝赚联盟、百家网、侯思HIS系统等。<span></span> </p> <p> 【课程大纲】<span><a><span>课</span><span>件打包下</span><span>载</span></a></span> </p> <p> 第一章:<span>Swagger </span>教程录制计划、自学整理方式 </p> <ul><li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204896">1. Swagger <span>教程</span><span>录</span><span>制</span><span>计</span><span>划、自学整理方式</span></a> </li> <li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204897">2. Swagger <span>、Swagger UI</span><span>、 Springfox</span><span>简</span><span>介,三者之</span><span>间</span><span>的</span><span>联</span><span>系</span></a> </li> <li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204898">3. Spring Boot <span>中快速集成Swagger</span></a> </li> <li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204899">4. Spring MVC <span>中快速集成Swagger</span></a> </li> <li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204900">5. Swagger + Springfox<span>快速入门</span></a> </li> <li style="color:#3D3D3D;text-align:left;"> <a href="https://edu.csdn.net/course/play/9615/204901">6. Swagger UI<span>国</span><span>际</span><span>化</span><span> </span><span>中文API</span><span>接口的</span><span>实现</span></a> </li> </ul>
©️2020 CSDN 皮肤主题: 猿与汪的秘密 设计师:白松林 返回首页