1

很难弄清楚这样做的“正确”方式。我正在使用 Micronaut 创建一个 REST 服务,该服务通过将我的 API 注释转换为开放 API 规范来使用 OpenAPI/Swagger。我正在尝试消除采用相同参数的 API 之间的注释重复。

@Operation(
    operationId = "...",
    summary = "..",
    description = "...",
)
@Post(uri = "something/{object_type}")
fun apiA(@Parameter(name = "", description = "") object_type: String) {
}

@Post(uri = "something-else/{object_type}")
// This should have the same @Parameter as the above api but I don't want to copy/paste
fun apiB(object_type: String) {}

我试图创建我自己的注释,@Parameter但它似乎没有继承。我知道 OpenAPI 有一个“组件”概念,但我不确定我的特定框架希望我在哪里定义组件。任何指针将不胜感激。

4

0 回答 0