内容简介:swagger-bootstrap-ui 1.8.5 发布了。swagger-bootstrap-ui 是 Swagger 的增强UI 实现,目的是替换 Swagger 默认的 UI 实现 Swagger-UI,使文档更友好一点儿swagger-bootstrap-ui在1.8.5以后,她不在是一个纯webjar的UI工具了,她增强了swagger的一些功能支持,例如tags、接口的排序,一些个性化的支持,目前只增强接口排序后续更多关于swagger的增强功能需求非常欢迎大家提
swagger-bootstrap-ui 1.8.5 发布了。swagger-bootstrap-ui 是 Swagger 的增强UI 实现,目的是替换 Swagger 默认的 UI 实现 Swagger-UI,使文档更友好一点儿
swagger-bootstrap-ui在1.8.5以后,她不在是一个纯webjar的UI工具了,她增强了swagger的一些功能支持,例如tags、接口的排序,一些个性化的支持,目前只增强接口排序
后续更多关于swagger的增强功能需求非常欢迎大家提 issue 反馈,让这款UI更加丰富强大.
swagger-bootstrap-ui 1.8.5 主要更新如下:
1、fixed formdata类型参数针对array数组类型无增加按钮
2、fixed 响应内容高度占比,参数过多的情况无法显示
3、多选项卡文档介绍、在线调试position位置引起的不适改动,由竖变横.
4、增强 排序 功能,添加个性化配置管理功能,可开启个性化配置
5、关于个性化增强功能,目前已经实现了tags、和接口api方法的排序,使用方式:
在原 EnableSwagger2
注解上增加 @EnableSwaggerBootstrapUi
注解
@Configuration @EnableSwagger2 @EnableSwaggerBootstrapUI public class SwaggerConfiguration { //more... }
针对tags分组排序,UI的排序规则是顺序排序,最小值1,最大值也是默认值Integer.Max_VALUE;
如果不使用SwaggerBootstrapUi的增强功能,则无需开启 @EnableSwaggerBootstrapUi
注解
tags的排序规则分两种:
a、一种是判断Swagger的 @Api
注解的position属性是否不等于0(默认值为0),如果该值不为空,则获取此值,根据该值排序
b、如果postion=0(不写的情况下),判断是否存在注解 @ApiSort
的值,如果有值,则获取此值,根据该值排序
c、所以排序的取值规则是:position>@ApiSort
接口api的排序规则:
a、判断 @ApiOperation
注解上的postion属性是否不等于0(默认值为0),如果该值不为空,则获取此值,根据该值排序
//postion属性赋值 @ApiOperation(httpMethod = "POST",position = 2,value = "Test2Model测试数组参数,多个",response=Test2Model.class) @ApiResponses({ @ApiResponse(code = 200, message = "非HTTP状态码,返回值JSON code字段值,描述:成功") }) @ApiImplicitParams({ @ApiImplicitParam(name = "ids",paramType ="form",value = "参数",allowMultiple = true, required = true) })
b、如果postion=0(不写的情况下),判断是否存在注解 @ApiOperationSort
的值,如果有值,则获取此值,根据该值排序
c、所以排序的取值规则是:position>@ApiOperationSort
注意:
注解 @EnableSwaggerBootstrapUi
、 @ApiSort
、 @ApiOperationSort
是本UI工具包提供的 Java 注解,排序功能的使用需要在启用原 EnableSwagger2
注解上增加 @EnableSwaggerBootstrapUi
注解方可生效
6、默认去除接口api地址的线上,默认只显示方法类型、方法说明两个属性,当然,新版本增加的个性化的配置功能,如果你觉得api地址显示任然有需要,可在个性化配置中开启该功能,个性化配置属性存储在localStorage对象中.只需要配置一次接口.
7、fixed 构建curl功能中写死http,根据 window.location.href
动态判断(http|https)的情况
8、如果请求参数是json参数body类型,文档说明中添加 请求示例 json展示,方便查看
9、请求示例、响应示例json自动适配高度
10、选中接口api菜单时,菜单显示激活色,显示背景颜色background-color: #eee;
11、fixed 离线文档markdown格式错乱问题(table标题换行导致显示异常)
12、离线文档已预览html的方式展现,复制文档功能依然是复制markdown语法
13、请求参数及响应参数说明改为多行显示,超出长度不以省略号显示,防止出现浮层一直显示的bug
Maven坐标
<dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>swagger-bootstrap-ui</artifactId> <version>1.8.5</version> </dependency>
码云: https://gitee.com/xiaoym/swagger-bootstrap-ui
GITHUB: https://github.com/xiaoymin/Swagger-Bootstrap-UI
在线体验: http://swagger-bootstrap-ui.xiaominfo.com/doc.html
欢迎提BUG、Pull Request给我,共同来完善这个小工具~~~~
还未给swagger-bootstrap-ui点过赞的朋友,前往 https://gitee.com/xiaoym/swagger-bootstrap-ui 给个Star吧~~ :)
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网
猜你喜欢:- kafka可插拔增强如何实现?
- 150行JavaScript代码实现增强现实
- Python+OpenCV实现增强现实!OpenCV真的牛逼!学会太受用了!
- swagger-bootstrap-ui 1.8.5 发布,Swagger增强UI实现
- Swagger-bootstrap-ui 1.8.6 发布,Swagger增强UI 实现
- Swagger-bootstrap-ui 1.8.6 发布,Swagger增强UI 实现
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
Spring实战(第4版)
Craig Walls 沃尔斯 / 张卫滨 / 人民邮电出版社 / 2016-4-1 / CNY 89.00
《Spring实战(第4版)》是经典的、畅销的Spring学习和实践指南。 第4版针对Spring 4进行了全面更新。全书分为四部分。第1部分介绍Spring框架的核心知识。第二部分在此基础上介绍了如何使用Spring构建Web应用程序。第三部分告别前端,介绍了如何在应用程序的后端使用Spring。第四部分描述了如何使用Spring与其他的应用和服务进行集成。 《Spring实战(第4......一起来看看 《Spring实战(第4版)》 这本书的介绍吧!