跳到主要内容

[v1.8.9-2019/01/11 文件下载、增强优化]

Swagger-Bootstrap-Ui 1.8.9 发布了。Swagger-Bootstrap-Ui是 Swagger 的增强UI 实现,目的是替换 Swagger 默认的 UI 实现 Swagger-UI,使文档更友好一点儿

Swagger-Bootstrap-Ui 1.8.9 主要更新如下:

特性&优化

1、主页面添加页面不缓存元素,防止版本升级缓存造成新功能加载失败.

2、响应示例说明、调试响应内容行添加description说明字段,免去切换到文档说明看字段说明的麻烦,非常感谢@wanyaxing提交的PR

3、新增个性化配置-开启RequestMapping接口类型重复地址过滤,默认只显示POST类型的接口地址(针对RequestMapping的接口请求类型,在不指定参数类型的情况下,如果不过滤,默认会显示7个类型的接口地址参数,如果开启此配置,默认展示一个Post类型的接口地址)

4、针对application/octet-stream类型的接口提供下载调试.

Bug修复

1、启用UI增强时,获取不到WebApplicationContext对象造成空指针异常

2、修复list套list的返回值会不显示issue #55 @GitHub

3、接口请求参数同全局参数配置名称存在冲突的情况下,根据名称匹配导致参数丢失,匹配规则为参数名称、参数类型同时比较issue #IQV1U @Gitee

4、服务端响应HTML标签数据时,响应内容显示异常issue #IQ9LG @Gitee

5、修复参数格式问题issue #IPXX7 @Gitee

6、针对多响应码返回不同schema类型,离线文档(markdown)未展示完整的bugissue #IPPHJ @Gitee

UI效果展示

header-json.png

项目地址

Maven坐标

<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.8.9</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

代码集成示例

SpringBoot在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo

Spring Mvc在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo/tree/master/swagger-bootstrap-ui-demo-mvc

Star & Issue

前往https://gitee.com/xiaoym/swagger-bootstrap-ui点个Star吧~~ :)

相关链接