关于Springboot同时上传文件与其他参数

Springboot同时上传文件与其他参数

• http请求数据传递分为请求体和请求参数。
• 跟在url后面的为请求参数，文件上传和json数据放在请求体中。
• 请求参数格式固定，后台可直接解析；请求体中的数据后台需要根据content-type字段按照特定格式解析。content-type只能有一种。
• 文件上传的content-type是form-data，json数据的content-type为application-json。

根据以上几点，一旦我们需要上传文件，只能有两种参数传递方式。

1. 全部放在请求体中，格式为form-data。
2. 文件放在请求体中， 一部分放在请求参数中。

以下是几种写法

支持Swagger接口文档

@RestController
@Validated
@RequestMapping("/group")
public class GroupInfoController {
    @PutMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
    public ApiResponse<Void> create(@Valid GroupCreateParam param,
                                    @RequestPart @NotNull MultipartFile cover,
                                    @RequestPart @NotNull MultipartFile avatar) {
        System.out.println(param.getGroupName());
        return ApiResponse.success();
    }
}
// GroupCreateParam.java
@Data
public class GroupCreateParam {
    @NotBlank
    private String groupName;
    @NotNull
    private Integer joinType;
    private String groupNotice;
}

这种写法可以在Swagger接口文档中测试。

封装为一个参数

@RestController
@Validated
@RequestMapping("/group")
public class GroupInfoController {
    @PutMapping
    public ApiResponse<Void> create(@Valid GroupCreateParam param) {
        return ApiResponse.success();
    }
}

// GroupCreateParam.java
@Data
public class GroupCreateParam {
    @NotBlank
    private String groupName;
    @NotNull
    private Integer joinType;
    private String groupNotice;
    @NotNull
    private MultipartFile avatar;
    @NotNull
    private MultipartFile cover;
}

这种写法不支持在Swagger接口文档中测试。