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

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

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

t
tl2327

引用来自“tl2327”的评论

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

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

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

引用来自“tl2327”的评论

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

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

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

引用来自“tl2327”的评论

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

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

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

引用来自“tl2327”的评论

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

引用来自“tl2327”的评论

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

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

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

引用来自“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
感觉不太一样~~~
八一菜刀
八一菜刀

引用来自“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
八一菜刀
八一菜刀

引用来自“tl2327”的评论

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

引用来自“tl2327”的评论

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

引用来自“null_zhou”的评论

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