皇上,还记得我吗?我就是1999年那个Linux伊甸园啊-----24小时滚动更新开源资讯,全年无休!

swagger-bootstrap-ui 1.9.4 发布,扩展支持动态字段注释

swagger-bootstrap-ui 1.9.4 发布了。swagger-bootstrap-ui 是 Swagger 的增强 UI 实现,使文档更友好一点儿

文档http://doc.xiaominfo.com

效果http://swagger-bootstrap-ui.xiaominfo.com/doc.html

Gitee:https://gitee.com/xiaoym/swagger-bootstrap-ui

GitHub:https://github.com/xiaoymin/swagger-bootstrap-ui

示例:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo

特性& 优化

1、最低需要 JDK 1.8 支持

2、单独接口通过 hash 地址访问, 方便开发人员之间快速复制传递接口信息, 能准确定位到接口

3、优化下载参数名称问题, 忽略 filename 大小写敏感 #IXA5C @Gitee

4、优化 BasicFilter 过滤器正则匹配频率问题,decode 函数调用替换为 JDK 1.8 版本中的 java.util.Base64

5、tab 操作项修改为点击事件显示, 避免同调试按钮冲突导致误关选项卡 #IXA5I @Gitee

6、增加调试接口响应类型为 Xml、Html、Text 的支持 #IWP49 @Gitee

7、优化调试后 header、raw、curl 等选项卡高度太低的问题 #IWLSU @Gitee

8、主页简介 description 字段支持 markdown 格式 #IVVRX @Gitee

9、针对枚举类型的集合类型 (List), 在字段描述中显示枚举可用列表值 #100 @GitHub

10、重构原接口排序、tag 排序规则, 新增接口作者属性, 可写每个接口的作者, 方便开发者调试.参考文档

11、针对 Authorize 授权的相关属性, 不同分组相同的请求参数只需授权一次即可则全局通用 #IXHBL @Gitee

12、针对 Map、JSONObject 等动态类型可通过自定义注解 @ApiOperationSupport 或者 @DynamicParameters 来增加参数的字段说明, 解决不想写实体类的烦恼, 但是又无文档的困扰.参考文档

13、优化自定义文档 (markdown) 界面效果, 增加相关 markdown 语法样式 (引用 editormd.css)

UI 效果展示

项目地址

Maven 坐标

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

Star & Issue

感谢各位朋友的支持, 前往 https://gitee.com/xiaoym/swagger-bootstrap-ui 点个 Star 吧~~ :)

源码分析

距离上一个版本也有挺长时间了, 这段时间主要是对 springfox 的源码进行了一些研究和学习,并且记录了一些博客, 该版本 (1.9.4) 的一些功能也在看源码的过程中对我有一些启发, 对于 Swagger 的规范也多了一些了解

对 springfox 源码有兴趣的朋友可以去我的博客查看, 点击前往

转自 https://www.oschina.net/news/107336/swagger-bootstrap-ui-1-9-4-released

分享到:更多 ()