一种提升 OpenAPI 到 GraphQL 转换效用的链接生成器
分布式、并行与集群计算
2020-05-20 v1 数据库
软件工程
摘要
标准化接口是当今分布式系统的连接纽带,便利了对云中数据服务的访问。尽管存在资源过度获取与获取不足等问题,REST API 在过去几年中仍十分盛行。GraphQL 凭借静态类型查询解决了这些问题,正快速被采用。然而,将服务重新开发以适配新范式成本高昂。因此,人们提出了多种从 REST 逐步迁移到 GraphQL 的方法,其中许多利用了 OpenAPI 服务描述。在本文中,我们展示了针对 APIs.guru 目录的实证评估结果,并识别出若干模式转换挑战。这些挑战包括 GraphQL 中表现力较弱的模式类型,以及 OpenAPI 中缺失关于相关资源的元信息。为此,我们开发了开源的 Link Generator,其分析 OpenAPI 文档并自动添加链接以提升转换效用。这从根本上惠及 APIs.guru 目录中约 34% 的 API。我们的发现与工具支持有助于正在进行的关于 REST API 向 GraphQL 迁移的讨论,并为开发者提供关于常见陷阱的宝贵见解,以减少 API 转换过程中的摩擦。
引用
@article{arxiv.2005.08708,
title = {A Link Generator for Increasing the Utility of OpenAPI-to-GraphQL Translations},
author = {Dominik Adam Kus and István Koren and Ralf Klamma},
journal= {arXiv preprint arXiv:2005.08708},
year = {2020}
}
备注
WWW2020 Developer Track