第一步是将应用程序的现有 REST API 调用转换为 GraphQL API 调用。通过切换到 GraphQL，客户端应用程序只需知道如何进行 GraphQL 调用并仅需请求所需的数据；它不必知道数据的来源。在 GraphQL 上对该应用程序实施标准化，这样可以使公司能够在不影响应用程序的情况下添加新数据源和切换数据源；GraphQL 查询保持不变。

然而，通常这意味着编写 GraphQL 服务器和大量解析器代码来将 API 映射到数据。需要编写和维护的代码越少越好。作为声明式、配置驱动的托管 GraphQL 服务器，StepZen 可以轻松配置解析器，从而消除了对大部分代码的需求。

Work & Co 总经理兼工程主管 Nemanja Niciforovic 解释道：“通过在 Mavenlink 上使用 GraphQL API，我们可以在数周内构建一个内部应用程序，让我们能够快速、准确且轻松地了解和规划我们的资源管理。此应用程序的性能至关重要，因为它将许多信息汇集在一起。StepZen 的自动并行功能有很大帮助。当我们添加后端服务并在单个 GraphQL API 上构建新应用程序时，它还帮助我们适应未来需求并进行扩展。”

Mavenlink 拥有全面的 REST API，用于管理对各种人力资源和资源管理数据的访问。通过使用 StepZen 的 GraphQL 指令 @rest，Work & Co 能够微调员工目录应用程序可用的数据。举一个简单的例子，该团队可以轻松地重命名 Mavenlink API 中的字段以匹配其应用程序中使用的名称，从而消除前端开发人员的认知负担，减少应用程序中所需的代码更改数量。

此外，该团队还能够通过使用 StepZen 的 @materializer 指令来简化 Mavenlink API。这使他们能够定义包含来自多个 API 调用的数据的类型。例如，他们在“用户”类型中添加“项目”类型，这使得应用程序开发人员可以在检索个人资料照片和电子邮件地址等用户详细信息的同时检索用户的活动项目。

分页：Mavenlink API 可以限制任何单个调用返回的记录数量，进行强制分页。Work & Co 应用程序并不是为了支持以这种方式处理数据而构建的，并且为了利用分页功能而对其重新设计也不是其作业范围。使用 StepZen 的 @sequence 指令，团队能够对 Mavenlink API 的许多 REST API 调用实施并行化处理，并使用单个 GraphQL 查询请求检索结果集的所有页面。

性能调优：这种方法的一个意想不到的好处是性能调优。使用 REST API 检索尺寸较小的页面可以缩短响应时间。因此，10 个并行请求（每个请求 200 条记录）比 20 个并行请求（每个请求 100 条记录）需要更长的时间。通过适当定义 StepZen 查询，Work & Co 应用程序开发人员能够微调其 GraphQL 查询的性能。

安全性和缓存：除了所有这些具体的实施细节外，Work & Co 还受益于 StepZen 的整体安全和缓存方法。灵活的安全配置使他们能够定义使用全应用程序安全上下文的查询，以及使用特定用户安全上下文的查询。在直接使用 REST API 时，这种细粒度控制很难管理；通常只能二选一。StepZen 的自动缓存功能意味着用户只需花费很少的开发时间就能提高应用程序的性能。

在将其内部应用程序转换为使用在 StepZen 上运行的 GraphQL 而不是特定的 REST API 调用后，更有利于 Work & Co 团队充分利用 Mavenlink 内的新功能，因为他们可以发掘该平台的更多优势。他们还能够轻松地将新服务引入其 GraphQL API，对由 StepZen 所提供数据提供支持的应用程序具有最小影响。

Work & Co（ibm.com 外部链接）是一家屡获殊荣的机构，致力于设计和交付能够推动公司转型的数字产品。该公司帮助客户制定数字战略，并将数字产品推向市场并实现大规模运营。每天都有数百万人使用 Work & Co 网站、应用程序和数字体验。