使用allOf
对https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism/ 中定义的继承进行建模会很好
@EricWittmann最近几天一直在使用该工具,这可能是阻止我与客户一起使用该工具的最大差距
好的。 将其添加到列表中!
对此还有什么想法吗? 我正在阅读以开始一些项目,我很想使用 apicruio 但这个问题是一个真正的障碍
我在这方面有一些想法,但还没有机会真正致力于它。 功能积压非常广泛,包括用户体验的相对广泛的翻新。
您有没有想过支持 allOf(大概是 oneOf 和 anyOf)的 UI 是什么样子的?
allOf 需要向我展示定义 foo 扩展了定义 bar,最好是作为 bar 一部分的字段的枚举。 foo 的视图应该超链接到 bar。 我在这里想象着各种分屏,但 UI 设计不是我的强项。
从用户体验的角度来看,oneOf 和 anyOf 是不同的用例。 在这些场景中,我需要简单地枚举在分配变量时可以使用的定义,但我不需要像 allOf 中需要的那样查看定义的详细信息。 我只需要知道定义名称的列表。
我会提出用户体验的问题,看看我们是否能想出一些办法。 不幸的是,它可能不是待办事项列表中最高的项目,但我会尽力而为。 :)
明白了,我只是想让你知道我们在实验室中使用这个东西需要什么。 这是现在的大事 - 我可以解决大多数其他事情。 但是我需要能够在现实世界的项目中进行继承。
完全明白。 :) 我会尽可能地提高这个要求——我当然希望 Apicurio 在现实世界的项目中尽可能有用。
如果您还有其他尚未提到的可以改进的问题 - 一定也让我知道这些问题。 (注意:我们正在设计 CRUD 功能,这将使为“资源”快速添加标准操作变得更加容易)
你好,有这方面的消息吗? 可惜这么好的工具不能处理继承……
不幸的是还没有,虽然不是因为缺乏支持继承的愿望。 只是一个优先级问题,真的。
如果有人拥有 UX 设计技能,那么会有很大帮助的是它如何工作的模型。 @sherl0cks已经提供了一些想法,但在这里使用 UX 设计实现一些东西会容易得多。 或者,如果您有一个以您喜欢的方式执行类似操作的工具,请随时指出!
我意识到这可能有很多问题要问。 :)
无论哪种方式,这都会完成,我只是不知道什么时候。
嘿,
如果 UX 部分仍然是一个障碍 - 为什么不重用现有的标签样式,如https://imagebin.ca/v/4mkbz35931av
替代方案 - 创建“复合”数据类型(在数组,字符串,浮点数,...旁边),一旦选择 - 在左侧呈现相同的表单(您可以在其中添加各种类型)和一些填充。
ps 继承是一个杀手级的 OpenApi 文档功能,因为它节省了大量的复制粘贴!
这不是一个糟糕的设计! 感谢您的贡献。 希望您对此没有意见,但我认为内联图像以简化操作会很有用(无需单击到 imagebin):
不,我会等到这个发布,然后我会声称侵犯版权! :D
ps 除此之外 - 你们构建了一个很棒的工具! 恭喜!
哈哈! 🤣
希望能实现这个功能!
现在(最终)致力于此。 :)
我知道这花了很长时间,但是基本的 allOf、oneOf 和 anyOf 支持的初始实现(显然对于 OpenAPI 2.0 文档,它只是“allOf”)。
这只是支持的测试版实现。 我很想得到一些反馈。 我认为可以进行很多改进,但我对其他人首先想到的内容很感兴趣。
我今天将发布一个版本,以便每个人都可以使用 Apicurio Studio 的立即试用(云)版本测试这些功能。
修正者: https :
值得注意的是,这些更改还包括对可重用简单类型的改进。 希望这对某些用户也有帮助。
不幸的是,我不再担任使用 apicurio 的角色,但这听起来很棒@EricWittmann !
最有用的评论
希望能实现这个功能!