# [v1.9.0-2019/02/25 提供Swagger资源保护]

SwaggerBootstrapUi 1.9.0 发布了。SwaggerBootstrapUi是 Swagger 的增强UI 实现,使文档更友好一点儿

GitHub (opens new window) Gitee (opens new window) 文档 (opens new window) 示例代码 (opens new window) 在线体验 (opens new window)

主要更新如下:

# 特性&优化

1、优化未给与tags分组时,Ui默认赋值default.

2、针对使用SwaggerBootstrapUi的增强排序功能时导致升级Springfox-Swagger必须升级到2.9.2引起的jar包冲突版本问题,Ui做向下兼容处理,Springfox-Swagger版本最低兼容2.7.0(相对稳定版本,亲测可用)

3、个性化新增配置,是否开启缓存已打开的api文档,感谢@web-xiaxia (opens new window)提交的pr

4、优化application/octet-stream下载出现的参数(header|query)问题

5、优化图片验证码显示问题,可参考文档文件下载及图片预览 (opens new window)

6、新增权限特性属性swagger.production,开启此属性后会屏蔽swagger所有访问资源,可用于生产环境中部署屏蔽文档输出.保护文档安全,可参考文档访问权限控制 (opens new window)

7、针对Swagger资源请求,提供Basic认证功能,可用于保护Swagger文档页面.可参考Basic详情 (opens new window)

8、优化文件上传参数类型File的支持.可参考文档文件上传 (opens new window)

9、优化响应数据右侧存在字段说明Span元素重叠,并增加Toggle开关显示关闭右侧字段说明

10、优化离线文档预览,超出UI默认接口数量(100个)时,自动显示markdown源文件代码,供开发者自动复制到第三方转换软件查看,不再提供预览效果

# Bug修复

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

2、修复SpringMvc启用增强失败的Bug

3、修改对象属性设置example导致解析Model失败的bugissue #IROVN @Gitee (opens new window)

4、修复搜索后,相关个性化状态设置不显示的bugissue #IRE8W @Gitee (opens new window)

5、修复 请求响应实体类内有Map类型参数无法正常显示 issue #IR61U @Gitee (opens new window)

# UI效果展示

header-json.png

# 项目地址

Maven坐标

<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>swagger-bootstrap-ui</artifactId>
   <version>1.9.0</version>
</dependency>

码云https://gitee.com/xiaoym/swagger-bootstrap-ui (opens new window)

GitHub:https://github.com/xiaoymin/Swagger-Bootstrap-UI (opens new window)

在线体验:http://swagger-bootstrap-ui.xiaominfo.com/doc.html (opens new window)

项目文档:http://www.xiaominfo.com/swagger-bootstrap-ui/

# 代码集成示例

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 (opens new window)点个Star吧~~ :)

相关链接

被围观 人次
上次更新: 2020/11/6 12:46:59
有任何问题请使用Knife4j的标签在OSC社区