swagger-bootstrap-ui 1.7.5,Swagger前端 UI 实现

八一菜刀
 八一菜刀
发布于 2018年07月16日
收藏 55

swagger-bootstrap-ui 1.7.5 发布了。swagger-bootstrap-ui 是 Swagger 的前端 UI 实现,目的是替换 Swagger 默认的 UI 实现 Swagger-UI,使文档更友好一点儿 

本版本,swagger-bootstrap-ui核心JS组件进行重构,新版本中,文档呈现将剔除原table的展现方式,以markdown格式展现

swagger-bootstrap-ui 1.7.5 主要更新如下: 

- 重构DApiUI.js功能,新版本使用SwaggerBootstrapUi.js,方便后期扩展,同时删除无效js、css、html文件,新版本jar包由原760kb缩小至295kb

- 重构文档页面,剔除原来table展现方式,新版本使用markdown格式展现文档,单个文档页可复制
  
 
  

- 新增全局参数配置功能,针对请求参数有全局参数情况下,方便在线调试

 

- 支持离线文档格式,生成markdown格式文档,供开发者对外生成静态文档

通过markdown转换工具Typora预览效果

Typora导出pdf预览效果

- 添加clipboard插件,离线文档可复制功能

- 正式发布版去除console打印调试信息

- fixed 调试页面去除url根路径/,项目名称非ROOT,或分布式情况下路径不对,多一个"/"的问题  

- fixed RequestBody 接收实体对象,对象属性中有List属性时,参数显示array,需解析对象属性显示,方便查看

- fixed 对象属性展示为string,属性未显示

- tip:推荐使用chrome浏览器,别的浏览器可能有js、css兼容问题,文档效果未到最佳

Maven坐标

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

还未给swagger-bootstrap-ui点过赞的朋友,前往https://gitee.com/xiaoym/swagger-bootstrap-ui给个Star吧~~   :)

本站文章除注明转载外,均为本站原创或编译?;队魏涡问降淖?,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 排列5的开奖号码
本文标题:swagger-bootstrap-ui 1.7.5,Swagger前端 UI 实现
加载中

最新评论(36

C
CRongL

引用来自“CRongL”的评论

楼主,有个小问题,
@Bean
public Docket docketEnterprise() {
return applySecurity(new Docket(DocumentationType.SWAGGER_2)
.apiInfo(new ApiInfoBuilder()
.title("企业??槲牡?quot;)
.description("企业??槲牡?quot;)
.contact(new Contact("test", "", "[email protected]"))
.version("1.0.0")
.build())
//.groupName("企业???quot;)
.select().apis(RequestHandlerSelectors.basePackage("com.test.b2b.modules.shop.controller")).paths(PathSelectors.any())
.build());
}



, //.groupName("企业???quot;) 定义的时候 如果设置了 groupName , 无法获取 到 json数据源 ,swagger 的json数据是这样来的, //xxxxx/v2/api-doc?group="企业???quot; , 所以页面就直接取不到了 ! 如果不设置group,只加载一个???br/>,//xxxxx/v2/api-doc 是可以加载接口到页面 ,但是如果 我把 扫描的包设置到??槎ゲ?com.test.b2b.modules 项目的接口 返回的数据量很大, 页面就渲染不出来了, F12 可以看到 network 有数据返回 , 数据量有400k 左右 , 如果方便可以联系我 qq:517129102

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

可以加群 讨论一下:608374991
好的
八一菜刀
八一菜刀

引用来自“CRongL”的评论

楼主,有个小问题,
@Bean
public Docket docketEnterprise() {
return applySecurity(new Docket(DocumentationType.SWAGGER_2)
.apiInfo(new ApiInfoBuilder()
.title("企业??槲牡?quot;)
.description("企业??槲牡?quot;)
.contact(new Contact("test", "", "[email protected]"))
.version("1.0.0")
.build())
//.groupName("企业???quot;)
.select().apis(RequestHandlerSelectors.basePackage("com.test.b2b.modules.shop.controller")).paths(PathSelectors.any())
.build());
}



, //.groupName("企业???quot;) 定义的时候 如果设置了 groupName , 无法获取 到 json数据源 ,swagger 的json数据是这样来的, //xxxxx/v2/api-doc?group="企业???quot; , 所以页面就直接取不到了 ! 如果不设置group,只加载一个???br/>,//xxxxx/v2/api-doc 是可以加载接口到页面 ,但是如果 我把 扫描的包设置到??槎ゲ?com.test.b2b.modules 项目的接口 返回的数据量很大, 页面就渲染不出来了, F12 可以看到 network 有数据返回 , 数据量有400k 左右 , 如果方便可以联系我 qq:517129102
可以加群 讨论一下:608374991
C
CRongL
楼主,有个小问题,
@Bean
public Docket docketEnterprise() {
return applySecurity(new Docket(DocumentationType.SWAGGER_2)
.apiInfo(new ApiInfoBuilder()
.title("企业??槲牡?quot;)
.description("企业??槲牡?quot;)
.contact(new Contact("test", "", "[email protected]"))
.version("1.0.0")
.build())
//.groupName("企业???quot;)
.select().apis(RequestHandlerSelectors.basePackage("com.test.b2b.modules.shop.controller")).paths(PathSelectors.any())
.build());
}



, //.groupName("企业???quot;) 定义的时候 如果设置了 groupName , 无法获取 到 json数据源 ,swagger 的json数据是这样来的, //xxxxx/v2/api-doc?group="企业???quot; , 所以页面就直接取不到了 ! 如果不设置group,只加载一个???br/>,//xxxxx/v2/api-doc 是可以加载接口到页面 ,但是如果 我把 扫描的包设置到??槎ゲ?com.test.b2b.modules 项目的接口 返回的数据量很大, 页面就渲染不出来了, F12 可以看到 network 有数据返回 , 数据量有400k 左右 , 如果方便可以联系我 qq:517129102
八一菜刀
八一菜刀

引用来自“bako”的评论

参数是否必须设置无效。
ApiModelProperty.required属性设置为true,页面是否必须还是false
swagger_version='2.9.2'
提个issue给我吧 截图说明下~~tks
八一菜刀
八一菜刀

引用来自“anxinxx”的评论

赞一个
??
八一菜刀
八一菜刀

引用来自“anxinxx”的评论

要是侧边接口栏大小可以拖动就更加完美了。@八一菜刀
不错的建议,会考虑加上
anxinxx
anxinxx
要是侧边接口栏大小可以拖动就更加完美了。@八一菜刀
anxinxx
anxinxx
赞一个
bako
bako
参数是否必须设置无效。
ApiModelProperty.required属性设置为true,页面是否必须还是false
swagger_version='2.9.2'
八一菜刀
八一菜刀

引用来自“ifu25”的评论

有C#版吗?
这个目前没有,不知道Swagger在C#中的解析结构是否和Java中的一致,如果一致的话,这套js你可以copy过去使用
返回顶部
顶部
  • 享受激情世界杯 远离心脑血管疾病 2019-04-18
  • 海淀区:“采”绘金秋美景,享受田园“嗨”淀 2019-04-18
  • 2018年新疆兵团面向社会招聘4000余名事业单位工作人员 2019-04-18
  • 享受激情世界杯 远离心脑血管疾病 2019-04-17
  • 世界杯的远和近(绿茵走笔) 2019-04-17
  • 牙膏-热门标签-华商生活 2019-04-16
  • 世界3D打印技术产业 大会会址永久落户佛山 2019-04-16
  • 湖州德清义务教育标准化学校创建率达97.4% 2019-04-16
  • 普林斯顿校长的演讲|上大学的意义是什么? 2019-04-16
  • 因监管趋严等多方承压 车贷行业不断涌现清盘潮 2019-04-15
  • 第529期:辅助降压、缓解便秘……薯类食物好处多多,怎样吃更健康? 2019-04-15
  • 光明网举报受理和处置管理办法 2019-04-15
  • 企业养老保险基金中央调剂制度下月起实施 2019-04-14
  • 一笔“农”墨绘山川——重庆市万州区国家农业公园速写 2019-04-14
  • 疾风加骤雨 铁军在行动 2019-04-13
  • 457| 699| 796| 347| 733| 754| 560| 529| 262| 583|