@ModelAttribute 在 Swagger 中像 body 一样显示

Question

我用

org.springdoc:springdoc-openapi-ui:1.6.9

我有控制器：

@GetMapping
public ResponseEntity<String> getApplications(@ModelAttribute ApplicationFilter applicationFilter){return null;}

并且有类参数：

@Getter
@Setter
@NoArgsConstructor
public class ApplicationFilter {

  @Parameter(name = "ids", required = true)
  private List<Long> ids;
}

我需要在 Swagger 中将 ModelAttribute 显示为 参数字段。

但是是以身体

的形式真实展现的

如果在字段上添加

@Schema(name = "This is  field")

- 结果

请告诉我。我需要做什么才能让我的 @ModelAttribute 显示为参数字段？

Answer 1

找到了适合我的解决方案：

@GetMapping
public ResponseEntity<String> getApplications(@ParameterObject @ModelAttribute ApplicationFilter applicationFilter){return null;}

添加注解@ParameterObject

Answer 2

请注意，您还使用

@ParameterObject

注释您的类，无需在控制器的参数中指定该注释。