在Java / Kotlin中的Swagger / Micronaut API中重用@Parameter文档

编程问答 2022-06-06

问题描述

很难弄清楚这样做的“正确”方法。我正在使用Micronaut通过将我的API注释转换为开放的API规范来创建使用OpenAPI / Swagger的REST服务。我正在尝试消除采用相同参数的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有一个“组件”概念，但是我不确定我的特定框架要在哪里定义组件。任何指针将不胜感激。

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

micronautmicronaut-openapiopenapiswaggerswagger