如何在 swagger @Operation 中描述 multipart-form-data？

Question

有一个请求正文类型为MULTIPART-FORM-DATA 的端点，包含三个字段：

1. “我的附件”-required 类型为 File 的字段
2. “选项” - required 任何类型的字段（File 或 Text）
3. "note" - optional 类型为 Text 的字段

使用 java 注释在 Springdoc（或 Swagger v3）中描述此请求正文的正确方法是什么？

我认为@Operation 有资格使用它，但找不到任何合适的方式来使用它。

io.swagger.core.v3 - version 2.1.3

Answer 1

这里是一个示例工作代码：

@PostMapping(value = "/upload2", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public String upload2(@RequestPart("my-attachment") MultipartFile myAttachment, @RequestPart("options") options options, Optional<Text> note) {
    return "Ok";
}