SpringMVC 后端处理多文件上传如何保持最大的灵活性

## 官方文档

1. [spring-framework 官方文档中心](https://docs.spring.io/spring-framework/docs/)
2. 选择需要的版本
3. 点击 “spring-framework-reference”
![](/media/202312/2023-12-07_1111250.7525489739826218.png)
4. 具体内容按板块点进去
![](/media/202312/2023-12-07_1111250.6686392338990877.png)

## Spring MVC 如何接收多文件

5.2.15 版本 [官方介绍了几种写法](https://docs.spring.io/spring-framework/docs/5.2.15.RELEASE/spring-framework-reference/web.html#mvc-multipart)。

### 方式一

> Declaring the argument type as a List allows for resolving multiple files for the same parameter name.

- 言下之意是以下 Controller 可以接收多个文件

```java
@PostMapping("/form")
public String handleFormUpload(@RequestParam("files") List files) {

}
```

![](/media/202312/2023-12-07_1111250.3964337926494673.png)

### 方式二

> When the @RequestParam annotation is declared as a Map or MultiValueMap, without a parameter name specified in the annotation, then the map is populated with the multipart files for each given parameter name.

言下之意是 `@RequestParam("files")` 改成 `@RequestParam` 后，可以使用以下参数来接收上传的文件

- `Map`
	- 对应的调用为：
	![](/media/202312/2023-12-07_1111250.55466305750846.png)
	![](/media/202312/2023-12-07_1111250.47880143329508573.png)

- `MultiValueMap` （这种方式一个 key 可以传多个文件）
	- 对应的调用方式为：
	![](/media/202312/2023-12-07_1111250.4240097875183011.png)
	![](/media/202312/2023-12-07_1111250.09100266749051877.png)

## formdata同时接收文件和参数

### 携带普通参数

类似 orderId 这种业务 key 也可以通过 formdata 传参
![](/media/202312/2023-12-07_1111250.81511920114453.png)

![](/media/202312/2023-12-07_1111250.309592794666677.png)

### 携带json参数

```
@PostMapping("/verified/personal/id-card/verify")
    public R<AppPersonalIdCheckVo> personalIdCardVerify(AppPersonalIdCheckBo appPersonalIdCheckBo,
                                                        @RequestParam(value = "file", required = false) MultipartFile file) {
        return R.ok(verifiedService.personalIdCardVerify(appPersonalIdCheckBo, file, LoginHelper.getUserId()));
    }
```

## 结论

后端处理多文件上传，如果有可拓展性的要求，可以使用如下的方法声明 Controller。对应的 key 可以发展为策略模式的 key

```java
@PostMapping("upload4MultiKeyAndValue")
@ResponseBody
public String upload4MultiKeyAndValue(@RequestParam MultiValueMap files, @RequestParam("orderId") String orderId) throws IOException {
    for (Map.Entry> entry : files.entrySet()) {
        List fileList = entry.getValue();
        for (MultipartFile multipartFile : fileList) {
            log.info("key : {} filename : {}", entry.getKey(), multipartFile.getOriginalFilename());
            // TODO 可以根据 key 实现策略模式, 每个 key 还可以对应多个文件
        }
    }
    return "success";
}
```