REST（Representational State Transfer）是一种基于 HTTP 协议的 Web API 设计风格，已经成为现代 Web 开发的标准之一。然而，REST API 存在一些缺陷，如需要多次请求获取数据，API 文档不够清晰等等。GraphQL 作为一种新的 API 查询语言，它的出现解决了这些问题。本文将从 REST 到 GraphQL，讲述一个漫长的旅程。
REST 的优点和缺点
REST API 有以下优点：
- 适合大规模的 Web 应用程序。
- 与 HTTP 协议无缝集成。
- 具有良好的可缓存性，可以提高 Web 应用程序的性能。
- 使用标准 HTTP 方法进行操作，易于理解和学习。
REST API 也有以下缺点：
- 无法精确控制数据的返回，需要多次请求获取数据。
- API 文档不够清晰，需要开发人员猜测 API 的工作方式。
- 难以支持复杂的查询。
GraphQL 的优点和缺点
GraphQL 是一种新的 API 查询语言，它的出现解决了 REST API 的一些缺陷。GraphQL 有以下优点：
- 可以精确控制数据的返回，避免多次请求获取数据。
- API 文档清晰易懂，开发人员可以快速理解 API 的工作方式。
- 支持复杂的查询，可以从多个数据源获取数据。
GraphQL 也有以下缺点：
- 学习成本高，需要开发人员学习新的查询语言。
- 需要更多的服务器资源，因为 GraphQL 服务器需要处理更多的查询请求。
GraphQL 的使用
下面我们通过一个简单的示例来了解 GraphQL 的使用。首先我们需要安装 GraphQL：
npm install graphql --save
然后我们创建一个 GraphQL Schema：
-- -------------------- ---- -------
----- - -------- ----------- - - -------------------
----- ------ - -------------
---- ----- -
------ ------
-
---
----- ---- - -
------ -- -- ------ -------
--
--------------- -- ----- --- ------------------- -- -
----------------------
---在这个示例中，我们定义了一个 Query 类型，它有一个 hello 字段，返回一个字符串。然后我们创建了一个 root 对象，它有一个名为 hello 的方法，返回一个字符串。最后我们使用 graphql 函数执行查询，传入 schema、查询字符串和 root 对象，并输出结果。
REST 和 GraphQL 的比较
下面我们通过一个简单的查询来比较 REST 和 GraphQL 的差异。假设我们有一个博客应用程序，它有文章和作者两个资源。我们现在需要获取一个作者的所有文章标题和发布日期。
使用 REST API，我们需要发出两个请求：
// 获取作者信息
fetch('/authors/1').then(response => response.json()).then(author => {
// 获取作者的所有文章
fetch(`/authors/${author.id}/articles`).then(response => response.json()).then(articles => {
const titlesAndDates = articles.map(article => ({ title: article.title, date: article.date }));
console.log(titlesAndDates);
});
});使用 GraphQL API，我们只需要发出一个请求：
-- -------------------- ---- -------
----------------- -
------- -------
-------- - --------------- ------------------ --
----- ----------------
------ -
----- -
---------- -- -
-------- -
-----
----
-
-
-
-
--
---------------- -- -------------------------- -- -
---------------------------------------
---在这个查询中，我们使用了 GraphQL 的嵌套查询功能，可以一次获取多个资源的数据。这个查询会返回一个包含文章标题和发布日期的数组。
结论
从 REST 到 GraphQL，我们经历了一个漫长的旅程。GraphQL 的出现解决了 REST API 的一些缺陷，使得 API 查询更加灵活和高效。然而，GraphQL 也有一些缺点，需要开发人员学习新的查询语言，并且需要更多的服务器资源。在实际开发中，我们需要根据具体的需求选择合适的 API 设计风格。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6725e12f2e7021665e18fc81