一款vue编写的功能强大的swagger-ui，有点秀（附开源地址）

prtyaa 2024-01-01 22:02:35  50822 赞同 0 反对 0

分类：资源

swagger-ui有非常多的版本，觉得不太好用，用postman，每个接口都要自己进行录入。所以在基于think-vuele进行了swagger格式json的解析，自己实现了一套swaggerui界面。 swagger分为后端数据提供方方和前端页面展示请求方。从一定角度来看，swagger是一种标准的数据格式的定义，对于不同语言进行实现一些注解API式的东西，能快速生成这种描述restful格式的api信息的json串。此项目模块依赖于think-vuele

demo：

http://sw.tennetcn.com

github：

https://github.com/chfree/think-swagger-ui-vuele

使用方式

自行下载编译

// 下载代码
git clone https://github.com/chfree/think-swagger-ui-vuele

// 安装依赖
npm install

// 直接运行
npm run dev

// 打包
npm run build

java项目 maven直接依赖

<dependency>
  <groupId>com.tennetcn.free</groupId>
  <artifactId>think-swagger-ui-starter</artifactId>
  <version>0.0.4</version>
</dependency>

此jar包的开源项目为think-free-base中的子项目模块

登陆

登陆界面分为json模式和swagger请求地址访问，没多大区别，只有拿到标准的swagger的json数据即可。Java知音公众号内回复“后端面试”，送你一份Java面试题宝典。

支持两种主题，一种是后端管理系统模式的主题。另外一种也是类似，中间1024px进行居中，两边留白。

主页

对于我使用过的一个版本的swagger来说，当接口数量在1000+以上，会等的时间非常长，原因是他一次将所有接口数据进行解析渲染，这个就是慢的原因。推荐阅读：设计模式入门

所以我将此进行优化，改为先解析出api摘要信息，然后在点击摘要的时候进行请求头、请求体的渲染；基本可以做到秒开

可以自动填充非json请求体的数据，采用的是mock.Random。

对于json请求体的数据，可以进行json格式化编辑，也是非常方便。json在线格式化编辑使用的是josdejong大神的jsoneditor

对于响应数据直接采用json格式化组件进行格式化展示，支持展开层级。再也不用将返回的数据在去找相关的json格式化工具进行格式化了。格式化控件采用的是chenfengjw163大神的vue-json-viewer

设置

在后端api请求的时候，一般都会在请求头中带一些token的验证，来进行用户标识，所以在设置中，进行了自定义请求头的设置，可以方便的设置相关的请求头,在任何一个请求都会自动带上设置的请求信息。

swagger 信息展示

来源于后端swagger配置的相关信息在此处进行展示

另

琐碎时间想看一些技术文章，可以去公众号菜单栏翻一翻我分类好的内容，应该对部分童鞋有帮助。同时看的过程中发现问题欢迎留言指出，不胜感谢~。另外，有想多了解哪些方面内容的可以留言（什么时候，哪篇文章下留言都行），附菜单栏截图（PS：很多人不知道公众号菜单栏是什么）

如果您发现该资源为电子书等存在侵权的资源或对该资源描述不正确等，可点击“私信”按钮向作者进行反馈；如作者无回复可进行平台仲裁，我们会在第一时间进行处理！

评价 0 条

相关资源

移动开发：推荐10个不错的Flutter开源项目 2023-12-23 53286 浏览
Flutter作为跨平台应用开发的最热门技术，Flutter从已发布就受到广大开发者的追捧。使用Flutter技术开发的应用不仅体验上无限接近原生应用，在开发效率上也是其他技术无法比拟的。随着其开发者社区的不断壮大，Flutter生态系统已经相当强大，并且众多开源应用程序也相继诞生。这些开源应用不仅展示了Flutter的多功能性，而且还为开发者提供了宝贵的资源和灵感。今天给大家分享10个不错的Flutter开源项目，希望对大家实际移动开发的朋友提供一些帮助！
开源技术：国内常见的低代码平台介绍 2023-12-23 51634 浏览
今天给大家分享国内常见的13款低代码平台，欢迎收藏！
前端：分享7 个常用的 Vue.js 开源组件库，你都用过吗？ 2023-12-25 51292 浏览
目前主流的前端开发框架当中Vue.js 应该是热度最高的，现在国内许多互联网公司都采用了Vue作为前端框架，今天就来给大家分享7个非常常用的vue.js 开源组件库，可以大大节省我们实际开发的工作量，每天上班早九晚六又近了一大步！
开源操作系统CentOS停服倒计时，迪普科技应对之策一键速递 2024-06-28 32078 浏览
开源操作系统CentOS停服倒计时，迪普科技应对之策一键速递
国产最强开源 API 数据库，没有之一，不接受任何反驳！ 2023-12-31 50478 浏览
前言经过小编这几天的学习理解，对TiDB数据库有了一定理解，所以现在回来总结。
7个开源的 Spring Boot 前后端分离项目，一定要收藏！ 2023-12-28 52533 浏览
前后端分离已经在慢慢走进各公司的技术栈，根据松哥了解到的消息，不少公司都已经切换到这个技术栈上面了。即使贵司目前没有切换到这个技术栈上面，松哥也非常建议大家学习一下前后端分离开发，以免在公司干了两三年，SSH 框架用的滚瓜烂熟，出来却发现自己依然没有任何优势！其实前后端分离本身并不难，后段提供接口，前端做数据展示，关键是这种思想。很多人做惯了前后端不分的开发，在做前后端分离的时候，很容易带进来一些前后端不分时候的开发思路，结果做出来的产品不伦不类，因此松哥这里给大家整理了几个开源的前后端分离项目，帮助大家快速掌握前后端分离开发技术栈。
GitHub协作：深入开源世界 2023-12-29 51609 浏览
用GitHub最有趣的一部分就是与其他开发者的协作。GitHub提供了一套完整的工具和流程，让你能够轻松地参与到开源项目中，与全世界的开发者一起工作。
贡献开源项目 2023-12-29 51624 浏览
贡献开源项目不仅是提升编程技能的一个好方法，也是参与到全球开发者社区的一种方式。在GitHub上，有很多开源项目都非常欢迎新的贡献者。
基于ZKWeb + Angular 4.0的开源管理后台Demo 2023-12-31 53572 浏览
这是一套基于ZKWeb网页框架和Angular 4.0编写的开源管理后台Demo，实现了前后端分离和模块化开发
又一款开源的数据库管理神器，简约大气，非常好用！ 2023-12-30 52194 浏览
有一款非常简约大气的数据库管理工具，刚刚开源不久，但收获了不少用户，目前 github 上的 star 已经超过1000，并且热度还在增加，今天介绍给大家！