使用Springfox和Swagger ui上传多部分文件

Question

我使用Spring MVC作为Rest控制器，我已经使用Springfox将Swagger用户界面与我的控制器集成在一起。我希望有一个能够通过Swagger用户界面上传文件的方法。我只需要两个参数，一个对象id的长代理和要上传的文件。

@RestController
public class controller{
    @RequestMapping(value="/upload", method=RequestMethod.POST)
    public void uploadFile(@RequestParam Long id,
                           @RequestParam MultipartFile file){
          //do some stuff
    }
}

我几乎什么都试过了，但我无法显示文件上传按钮。但是，如果我这样做：

@RestController
public class Controller{
    @RequestMapping(value="/upload", method=RequestMethod.POST)
    public void uploadFile(@RequestParam Long id,
                           @RequestPart File file){
         //do some stuff
    }
}

文件上载按钮出现，但在尝试上载文件时，它总是抛出http代码415。此外，我需要输入一个多部分文件，而不是常规文件。即使我对多部分文件使用@RequestPart注释，也不会出现选择要上载的文件按钮。我怎样才能让它工作？？？？偶数：

@RestController
public class Controller{
    @RequestMapping(value="/upload", method=RequestMethod.POST)
    public void uploadFile(@RequestPart String metaData,
                           @RequestPart MultipartFile file){
        //do some stuff
    }
}

行不通。如果有人能介绍一下如何在MultipartFile中显示此按钮？我将永远感激你。

Answer 1

在我的情况下，我需要做两件事

1. 我的MultipartFile请求参数必须命名为“file”，否则，swagger ui将不会显示文件上载输入控件

@RequestParam("file") MultipartFile file

@Bean(name = "multipartResolver")
public CommonsMultipartResolver commonsMultipartResolver(){
    return new CommonsMultipartResolver();
}

Answer 2

使用

@Request estPart（必需=true）MultipartFile文件

并且使用2.1.0或最新版本，以前的版本有一个bug。

https://github.com/springfox/springfox/issues/786

Answer 3

我认为您在第二个代码片段中缺少了@RequestMapping的consumes属性。请参见以下示例

@RequestMapping(
    path = "/upload", 
    method = RequestMethod.POST, 
    consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<String> handleUpload(
        @RequestPart("file") MultipartFile file, 
        @RequestParam("someId") Long someId,         
        @RequestParam("someOtherId") Long someOtherId) { 
    return new ResponseEntity<>();
}