微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

如何解决在Java / Kotlin中的Swagger / Micronaut API中重用@Parameter文档

很难弄清楚这样做的“正确”方法。我正在使用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 举报,一经查实,本站将立刻删除。