我正在生成 Rest 端点,包括向生成的代码添加Openapi/Swagger注释。
虽然它适用于基本类型,但我对自定义类有一些问题。
现在我有很多自定义类的重复模式条目(使用@Schema(implementation = MyClass.class)),但至少需要的信息在那里。但是,我想找到一种方法来删除重复的架构条目,同时保留其他信息。
在讨论$ref和缺少兄弟属性的 github 问题上,我找到了一个示例,您将如何在 yaml 中手动编写它以获得我正在寻找的结果,但是我不知道如何设置注释生产它。
如果我遵循示例,我认为注释应该是这样的(为了安全起见,它被添加到 getter 和 setter 中):
import io.swagger.v3.oas.annotations.media.Schema;
...
public class SepaPaymentRequest {
...
@Schema(name = "w307BetrBeg", description = "BETRAG BEGUENSTIGTER ", allOf = { com.diesoftware.services.utils.Betrag.class }, required = true)
public void setW307BetrBeg(final Betrag w307BetrBeg) {
this.w307BetrBeg = w307BetrBeg;
}
...
}
Run Code Online (Sandbox Code Playgroud)
但是,当我获取 openapi.yaml(代码段)时我得到了什么:
w307BetrBeg:
$ref: '#/components/schemas/Betrag'
Run Code Online (Sandbox Code Playgroud)
我想要什么:
w307BetrBeg:
title: 'Betrag'
description: 'BETRAG …Run Code Online (Sandbox Code Playgroud)