如何公开其他模型：从Springfox迁移到Springdoc

Question

我需要公开一些在REST API方法中不直接使用的模型。

对于springfox，我使用Docket的additionalModels方法以编程方式将模型添加到规范中：

docket.additionalModels(
  typeResolver.resolve(XModel1.class),
  typeResolver.resolve(XModel2.class)
)

如何使用springdoc？

我已经创建了一个带有dummy参数的dummy操作，其中包括所有必需的模型。但我觉得这种方法还有改进的空间。

Answer 1

在科特林

fun components(): Components {
    val components = Components()

    val converter = ModelConverters.getInstance()

    val schema1 = converter.readAllAsResolvedSchema(XModel1::class.java)
    val schema2 = converter.readAllAsResolvedSchema(XModel2::class.java)

    schema1.referencedSchemas.forEach { s -> components.addSchemas(s.key, s.value) }
    schema2.referencedSchemas.forEach { s -> components.addSchemas(s.key, s.value) }

    return components
}

此外，您可能需要在application.yml中指定属性：

springdoc:
    remove-broken-reference-definitions: false

Answer 2

使用OpenApiCustomiser，您可以访问OpenAPI对象。您可以添加任何想要的对象/操作，而无需在代码上添加注释。

您可以查看文档以了解更多详细信息：

• https://springdoc.github.io/springdoc-openapi-demos/faq.html#how-can-i-customize-the-openapi-object-