Swagger-Bootstrap-Ui 1.8.8 发布,Swagger 增强 UI 实现

八一菜刀
 八一菜刀
发布于 2018年12月17日
收藏 38

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

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

特性&优化

1、顶部标题可自定义,去除原默认显示swagger-bootstrap-ui的固定标题,title规则为获取分组对象apiInfo中的第一个title属性

2、个性化配置中新增是否开启请求参数缓存策略,默认为true,当设置为false时,请求的参数不会再本地产生缓存,下次打开接口调试时需要自己重新输入相关接口参数

3、分组加载由同步改为异步加载

4、新增接口高亮显示,当后端新增接口后,UI会自动标识该接口为新接口,直到该接口被点击为止.

5、当服务器正在重启或者宕机时,接口发生异常,给出友好提示,告知接口对接人员.

6、请求参数必填排序,require=true排最前

7、后端接口方法上针对@Deprecated标注的接口,UI以中横线标注区分

8、针对不同状态响应码,返回内容均有Schema的情况下,UI以tab方式将所有状态码的schema内容呈现

9、优化接口数量过多的情况下,离线文档会导致文档页假死

Bug修复

1、修复针对Delete请求,使用@RequestBody注解出现400错误 issue IPLJT @Gitee

2、修复响应状态码HTML标签非转义输出 issue #47 @GitHub

3、不能正确解析response内非$ref的schema内容 issue #43 @Github

UI效果展示

项目地址

Maven坐标

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

Star & Issue

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

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:Swagger-Bootstrap-Ui 1.8.8 发布,Swagger 增强 UI 实现
加载中

最新评论(12

调戏上帝
swagger还是挺好用的,开启参数缓存机制。。之前一直没注意到呢。。
WunHwan
WunHwan
很好,新接口想尝试下
伊超
干脆全部用layui算了,目前好像跟bootstrap混用。
八一菜刀
八一菜刀

引用来自“伊超”的评论

好东西,能不能再改进一下,凡是@RequestMapping的只默认显示post一个,不要其它都显示出来

引用来自“八一菜刀”的评论

其他人又会说只显示get一个呢,这时候就没法弄了,这个需要自己在代码里面规范,这个也是api规范啊

引用来自“伊超”的评论

get也行哦,或者提供选项功能
提issue吧
伊超

引用来自“伊超”的评论

好东西,能不能再改进一下,凡是@RequestMapping的只默认显示post一个,不要其它都显示出来

引用来自“八一菜刀”的评论

其他人又会说只显示get一个呢,这时候就没法弄了,这个需要自己在代码里面规范,这个也是api规范啊
get也行哦,或者提供选项功能
八一菜刀
八一菜刀

引用来自“OSC程序猿收容所长”的评论

swagger-bootstrap-ui很棒~~~!!!
😄
八一菜刀
八一菜刀

引用来自“Anotherjueyue”的评论

支持下确实比较好用
感谢:)
八一菜刀
八一菜刀

引用来自“伊超”的评论

好东西,能不能再改进一下,凡是@RequestMapping的只默认显示post一个,不要其它都显示出来
其他人又会说只显示get一个呢,这时候就没法弄了,这个需要自己在代码里面规范,这个也是api规范啊
伊超
好东西,能不能再改进一下,凡是@RequestMapping的只默认显示post一个,不要其它都显示出来
白菜粉条炖猪蹄儿
的确挺好的。。。。
返回顶部
顶部