GraphQL 是一种新型的 API 查询语言，它可以帮助前端开发者更加高效地查询和获取数据，因此在前端开发中应用越来越广泛。而利用现有 API 基于 GraphQL 生成服务，则是将 GraphQL 引入到现有 API 中的一种方式，可以让我们更加方便地管理和查询数据。那么在本文中，我们将详细介绍如何利用现有 API 基于 GraphQL 生成服务，并提供示例代码，帮助读者更好地理解和应用。
什么是 GraphQL？
GraphQL 是一种由 Facebook 开发的 API 查询语言，它可以让客户端明确地指定需要获取的数据，从而避免了 REST API 中常见的多次请求和响应数据冗余的问题。GraphQL 的核心思想是将数据视为一个图形，客户端可以根据自己的需求从这个图形中获取所需数据，而不必获取整个数据集合。
为什么要基于现有 API 生成 GraphQL 服务？
在实际开发中，我们往往需要通过 API 获取数据，但是这些 API 往往是由多个不同的服务提供的，因此我们需要在客户端进行多次请求，从而获取所需数据。而基于现有 API 生成 GraphQL 服务，则可以将这些 API 统一管理，从而方便客户端进行查询和获取数据。
如何基于现有 API 生成 GraphQL 服务？
下面我们将介绍如何基于现有 API 生成 GraphQL 服务，具体步骤如下：
- 安装相关依赖
首先，我们需要安装相关依赖，包括 express、express-graphql 和 graphql。可以使用以下命令进行安装：
npm install express express-graphql graphql
- 创建 Express 应用
接下来，我们需要创建 Express 应用，并配置路由。具体代码如下：
-- -------------------- ---- -------
----- ------- - -------------------
----- ----------- - ---------------------------
----- - ----------- - - -------------------
----- --- - ----------
-- -- ------- ------
----- ------ - -------------
---- ----- -
------ ------
-
---
-- -- ------- --------
----- ---- - -
------ -- -- ------ -------
--
-- -- ------- ---
------------------- -------------
------- -------
---------- -----
--------- ----
----
-- ----
---------------- -- -- -
-------------------- - ------- --- ------ -- -------------------------
---在上面的代码中，我们首先定义了一个 GraphQL schema，包括一个 hello 字段，然后定义了一个 GraphQL resolver，用于处理 hello 字段的查询请求。接着，我们使用 express-graphql 中间件，将 GraphQL 配置到 Express 应用中，并启动应用。
- 集成现有 API
接下来，我们需要集成现有 API 到 GraphQL 中。假设我们有一个 REST API，用于获取用户信息，其 URL 为 https://example.com/api/users，返回的数据格式为 JSON。我们需要将这个 API 集成到 GraphQL 中，以便客户端通过 GraphQL 查询获取用户信息。
首先，我们需要修改 GraphQL schema，增加一个 User 类型和一个 users 字段，具体代码如下：
-- -------------------- ---- -------
----- ------ - -------------
---- ---- -
--- --
----- ------
------ ------
-
---- ----- -
------ ------
------ ------
-
---在上面的代码中，我们定义了一个 User 类型，包括 id、name 和 email 三个字段，然后定义了一个 users 字段，用于查询用户信息。
接下来，我们需要修改 GraphQL resolver，以便从现有 API 中获取用户信息。具体代码如下：
-- -------------------- ---- -------
----- ---- - -
------ -- -- ------ --------
------ -- -- -
------ --------------------------------------
--------- -- -----------
---------- -- ------------- -- --
--- --------
----- ----------
------ ----------
-----
-
--在上面的代码中，我们首先使用 fetch 函数获取现有 API 返回的数据，然后将数据转换为 GraphQL 可识别的格式，并返回给客户端。
最后，我们需要重新启动应用，访问 http://localhost:4000/graphql，在 GraphiQL 中输入以下查询语句，即可获取用户信息：
{
users {
id
name
email
}
}总结
通过本文的介绍，我们了解了如何基于现有 API 生成 GraphQL 服务。通过将现有 API 集成到 GraphQL 中，我们可以更加方便地管理和查询数据，提高前端开发效率。当然，在实际应用中，我们可能需要更加复杂的 API 集成方案，但是基本的思路和操作流程都是类似的。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/663d2484d3423812e4b22910