Apicurio-studio: 编辑器:支持allOf(数据类型继承)

创建于 2018-07-18  ·  20评论  ·  资料来源: Apicurio/apicurio-studio

enhancement

最有用的评论

希望能实现这个功能!

所有20条评论

@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):

4mkbz35931av

不,我会等到这个发布,然后我会声称侵犯版权! :D

ps 除此之外 - 你们构建了一个很棒的工具! 恭喜!

哈哈! 🤣

希望能实现这个功能!

现在(最终)致力于此。 :)

我知道这花了很长时间,但是基本的 allOf、oneOf 和 anyOf 支持的初始实现(显然对于 OpenAPI 2.0 文档,它只是“allOf”)。

这只是支持的测试版实现。 我很想得到一些反馈。 我认为可以进行很多改进,但我对其他人首先想到的内容很感兴趣。

我今天将发布一个版本,以便每个人都可以使用 Apicurio Studio 的立即试用(云)版本测试这些功能。

修正者: https :

值得注意的是,这些更改还包括对可重用简单类型的改进。 希望这对某些用户也有帮助。

不幸的是,我不再担任使用 apicurio 的角色,但这听起来很棒@EricWittmann

此页面是否有帮助?
0 / 5 - 0 等级