Springdoc-OpenAPI 通用控制器类型参数支持

Question

我有以下控制器代码：

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+ 个特定的控制器，有什么方法可以让 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>