swagger-bootstrap-ui 1.6 发布,前端 UI 实现 - 开源中国社区
swagger-bootstrap-ui 1.6 发布,前端 UI 实现
八一菜刀 2017年09月06日

swagger-bootstrap-ui 1.6 发布,前端 UI 实现

八一菜刀 八一菜刀 发布于2017年09月06日 收藏 83

有免费的MySQL,为什么还要买? >>>  

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

swagger-bootstrap-ui 1.6更新如下:

1、支持文件上传,需要指定dataType=MultipartFile,如下:

 @ApiOperation(value = "文件素材上传接口")
 @ApiImplicitParams({@ApiImplicitParam(name = "file", value = "文件流对象,接收数组格式", required = true,dataType = "MultipartFile"),
            @ApiImplicitParam(name = "title", value = "title", required = true)}
    )
 @RequestMapping(value="/uploadMaterial",method = RequestMethod.POST)
 @ResponseBody
 public RestMessage uploadMaterial(@RequestParam(value="file") MultipartFile[] files,@RequestParam(value = "title") String title, HttpServletRequest request) throws IOException {
        //int mul=1*1024*1024;
        String realPath=request.getSession().getServletContext().getRealPath("/upload");
  //......
}

2、ResponseBody<String>类型的string展示

3、布局溢出的问题.bycdao-main样式调整,修改margin-left:270px;

4、ApiImplicitParam注解defaultValue属性支持

5、菜单名称调整,展示接口方法类型、接口地址、接口说明三个参数

maven坐标:

<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>swagger-bootstrap-ui</artifactId>
   <version>1.6</version>
</dependency>
本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:swagger-bootstrap-ui 1.6 发布,前端 UI 实现
分享
评论(36)
最新评论
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!

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

这个具体是怎样的?显示了那些内容?

引用来自“tl2327”的评论

显示了@ApiOperation里面的value的值加上@RequestMapping里面的value的值和method的方式,弄不了照片太抽象了!!
带个类似这样 吧:
/api/xxx GET
获取公众号

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

你issue里面发个图吧。。。
方法都在前的额:disappointed_relieved:
sorry~~~~看错了,看了一遍你发的内容才发现你弄的就那样!!!是我看错。so sorry!!!
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!

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

这个具体是怎样的?显示了那些内容?

引用来自“tl2327”的评论

显示了@ApiOperation里面的value的值加上@RequestMapping里面的value的值和method的方式,弄不了照片太抽象了!!
带个类似这样 吧:
/api/xxx GET
获取公众号
你issue里面发个图吧。。。
方法都在前的额:disappointed_relieved:
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!

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

这个具体是怎样的?显示了那些内容?
显示了@ApiOperation里面的value的值加上@RequestMapping里面的value的值和method的方式,弄不了照片太抽象了!!
带个类似这样 吧:
/api/xxx GET
获取公众号
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!

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

swagger2的2.7.0版本,menu不会显示@Api的注释,而是以controller默认显示

这个是这个issue里面的情况吗?https://gitee.com/xiaoym/swagger-bootstrap-ui/issues/IDW0D
感觉不太一样~~~
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!
swagger2的2.7.0版本,menu不会显示@Api的注释,而是以controller默认显示

这个是这个issue里面的情况吗?https://gitee.com/xiaoym/swagger-bootstrap-ui/issues/IDW0D
0

引用来自“tl2327”的评论

1.发现在那个“在线调试”的“请求参数”改了参数名称之后点“发送”,还是传参原来的参数名称,这样的话,参数名称那里是否就一个不是文本框呢?避免引起歧义!
2.请求返回结果之后是否应该显示完整的URL给用户看呢?原始原来的swagger-ui里面显示的crul一样呢?
嗯,感谢建议~~curl这个我把加出来
0

引用来自“tl2327”的评论

springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!
这个具体是怎样的?显示了那些内容?
0
1.发现在那个“在线调试”的“请求参数”改了参数名称之后点“发送”,还是传参原来的参数名称,这样的话,参数名称那里是否就一个不是文本框呢?避免引起歧义!
2.请求返回结果之后是否应该显示完整的URL给用户看呢?原始原来的swagger-ui里面显示的crul一样呢?
0
springfox-swagger2 2.7.0的版本的话,菜单的内容不单是显示@ApiOperation注解的内容,还显示了@RequestMapping里面的内容,这个有发现么?作者老大!
0

引用来自“null_zhou”的评论

还有请求参数那一栏有个叫in的一栏,那一栏对应哪个参数
这个 对应的是@ApiImplicitParam的paramType属性,有几种的,body、path、header、query、form 对应发送请求 数据在哪里
0
还有请求参数那一栏有个叫in的一栏,那一栏对应哪个参数
0

引用来自“null_zhou”的评论

响应状态码的描述,自定义code?还是说是写死的

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

这个 是写死的
ok,自定义最好了,这样统一code,就有描述的地方了
0

引用来自“null_zhou”的评论

响应状态码的描述,自定义code?还是说是写死的
这个 是写死的
0
响应状态码的描述,自定义code?还是说是写死的
0
最下面的那个code列表怎么自定义?
0

引用来自“寂寞不痛”的评论

为什么我用了swagger 然后直接集成这个ui 会不显示接口内容呢

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

@寂寞不痛 你默认的ui出来么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 出来···

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

那js报错了 应该是,报什么错?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : /v2/api-docs 请求404

引用来自“寂寞不痛”的评论

回复@寂寞不痛 : 那不知道我为什么没有这个url,我访问/swagger-ui.html是可以正常使用的

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

swagger-ui.html里面访问的接口地址是什么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 我的是/v2/api-docs?group=XXX,没有后面的group参数会404

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

group的我还没实现 。。

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 嗯,group的问题,你可以抓一下那个url而不是写死,给你点建议哈,如果你会vue的可以尝试一下用docsify,作为文档要好看的多
感谢~~~
0

引用来自“寂寞不痛”的评论

为什么我用了swagger 然后直接集成这个ui 会不显示接口内容呢

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

@寂寞不痛 你默认的ui出来么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 出来···

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

那js报错了 应该是,报什么错?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : /v2/api-docs 请求404

引用来自“寂寞不痛”的评论

回复@寂寞不痛 : 那不知道我为什么没有这个url,我访问/swagger-ui.html是可以正常使用的

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

swagger-ui.html里面访问的接口地址是什么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 我的是/v2/api-docs?group=XXX,没有后面的group参数会404

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

group的我还没实现 。。
回复@八一菜刀 : 嗯,group的问题,你可以抓一下那个url而不是写死,给你点建议哈,如果你会vue的可以尝试一下用docsify,作为文档要好看的多
0

引用来自“寂寞不痛”的评论

为什么我用了swagger 然后直接集成这个ui 会不显示接口内容呢

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

@寂寞不痛 你默认的ui出来么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 出来···

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

那js报错了 应该是,报什么错?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : /v2/api-docs 请求404

引用来自“寂寞不痛”的评论

回复@寂寞不痛 : 那不知道我为什么没有这个url,我访问/swagger-ui.html是可以正常使用的

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

swagger-ui.html里面访问的接口地址是什么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 我的是/v2/api-docs?group=XXX,没有后面的group参数会404
group的我还没实现 。。
0

引用来自“寂寞不痛”的评论

为什么我用了swagger 然后直接集成这个ui 会不显示接口内容呢

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

@寂寞不痛 你默认的ui出来么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 出来···

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

那js报错了 应该是,报什么错?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : /v2/api-docs 请求404

引用来自“寂寞不痛”的评论

回复@寂寞不痛 : 那不知道我为什么没有这个url,我访问/swagger-ui.html是可以正常使用的

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

swagger-ui.html里面访问的接口地址是什么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 我的是/v2/api-docs?group=XXX,没有后面的group参数会404
那你要对这个地址做一个单独处理了。。。。。
0

引用来自“寂寞不痛”的评论

为什么我用了swagger 然后直接集成这个ui 会不显示接口内容呢

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

@寂寞不痛 你默认的ui出来么?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : 出来···

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

那js报错了 应该是,报什么错?

引用来自“寂寞不痛”的评论

回复@八一菜刀 : /v2/api-docs 请求404

引用来自“寂寞不痛”的评论

回复@寂寞不痛 : 那不知道我为什么没有这个url,我访问/swagger-ui.html是可以正常使用的

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

swagger-ui.html里面访问的接口地址是什么?
回复@八一菜刀 : 我的是/v2/api-docs?group=XXX,没有后面的group参数会404
顶部