Java OpenApi 生成器使用对象作为查询参数

Question

我有以下 Controller :

public interface GetScoreController {
  @GetMapping(value = "/score", produces = MediaType.APPLICATION_JSON_VALUE)
  @Operation(parameters = {@Parameter(in = ParameterIn.QUERY, name = "request")})
  Score getScore(ScoreRequest request);
}

我希望 OpenApi 显示 ScoreRequest 中的所有属性作为生成 Swagger 文档时的查询参数，因为这是请求是 POJO 时的结果:

我不知道实际上 OpenApi 是否允许这样做，但是如果我有太多的请求参数，将它们收集到一个独特的 POJO 中会更有用。

Answer 1

添加 @ParameterObject方法签名的注释。

Score getScore(@ParameterObject ScoreRequest request);
}