java - 如何在 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";
}