java - springdoc-openapi 通用 Controller 类型参数支持

Question

我有以下 Controller 代码:

    public abstract class BaseController<TClientModel extents BaseClientModel> {
       @Operation
       @GetMapping
       Page<TClientModel> get()
    }

    @Data
    public abstract class BaseClientModel {
       int id;
    }

    @RestController
    public class SpecificController extends BaseController<SpecificClientModel> {}

    @Data
    public class SpecificClientModel extends BaseClientModel {
        String name;
    }

问题: 当在 Swagger 中为 SpecificController 生成 open-api 标记时，响应中的客户端模型是 BaseClientModel，而不是 SpecificClientModel，并且只有 id 字段，而不是 id+name。

实际:

{
  "id": 0,
}

预期:

{
  "id": 0,
  "name": "string",
}

鉴于我有 40 多个特定 Controller ，有什么方法可以让 springdoc open-api 根据特定通用参数生成正确的标记？

Answer 1

该支持现已成为 springdoc-openapi v1.2.33 的一部分。 例如，如果您使用的是 spring-mvc，您可以声明:

   <dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-ui</artifactId>
      <version>1.2.33</version>
   </dependency>