特别需要注意的是:不管是文件下载或者是需要图片预览,都需要在接口中指定接口的produces
,否则不能达到预期效果,接口的produces可参考上面表格中列出项.
关于文件下载的支持
SwaggerBootstrapUi
在1.8.9
版本中添加了application/octet-stream
下载类型的支持,并在版本中完善,只需要配置相应接口的produces,即可在doc.html
页面中查看效果,如下图:
点击下载文件即可下载当前接口响应的二进制流.示例代码可参考
特别说明,需要指定相应的produces
关于图片预览的支持
图片预览一般用在验证码等场景中,很多时候,需要直接展示出验证码的情况,如下图:
验证码预览的后端代码可参考
特别说明,需要指定相应的produces
@Api(value = "图片预览",tags = "图片预览")
@RestController
@GetMapping(value = "/preview",produces = "image/jpeg")
//more....
}