openapi - 如何在 Springdoc Open API 中对单个服务项目中的公共响应类进行建模

Question

我正在尝试使用 Spring doc api 为我的服务项目生成打开的 api 文档。

我在另一个库中定义了一个公共类 Response 类，我们无权添加/修改这个类。

例如

public class RestResponse implements Serializable {
    protected MetadataType metadata;
    protected List any;
    ......

}

此类将在多个服务（多个项目）中使用以生成响应，RestResponse 类中的“任何”字段将填充单个服务业务对象。

如何使用@Schema 为每个单独的服务建模响应类。

提前致谢。

Answer 1

你可以看看答案：对于同一个类定义不同模式的能力

• https://github.com/springdoc/springdoc-openapi/issues/685

您的问题与springdoc没有直接关系，而是与大摇大摆的使用有关。