在 Web 应用的现代化开发中，REST 和 GraphQL 是两种广泛使用的 API 设计模式。虽然两者都有优点和缺点，但它们的差异还是明显的，下面将详细介绍它们的优缺点以及如何在实际项目中选用适当的方案。
REST API
REST 是 Representational State Transfer 的缩写，它是基于 HTTP 协议的架构风格，是一种轻量级的 API 设计模式。REST 将资源的状态和操作封装在 HTTP 方法（GET，POST，PUT，DELETE 等）中，这些操作在请求路径和请求体中的资源上进行。
REST API 的优点：
遵循 HTTP 标准，使得 API 风格和结构清晰简单易懂。
容易缓存和缩放，因为它使用 URL 和 HTTP 动词来访问资源，任意 Web 服务器都可以应用它。
跨平台和语言支持广泛。
REST API 的缺点：
充斥着大量的请求，特别是要从多个资源获取数据时，需要进行多次 REST 请求，这种情况会导致过度加载或者性能瓶颈。
对于不必要的数据，也会一并传输到客户端，增加网络负载，造成传输带宽浪费。
客户端和服务端之前的耦合度很高，一旦服务端 API 发生变更，那么客户端也需要相应的跟着改变。
GraphQL API
GraphQL 是一种用于 API 的查询语言和运行时，它是由 Facebook 开发的一种新的 API 设计语言和新的 API 架构模式。GraphQL 通过一种自定义架构，允许客户端精确地定义需要返回的数据，并将它们聚合为一个单一的请求。
GraphQL API 的优点：
可以按照需要精确请求数据，并仅仅获取所需的数据，减少了中间针对 REST 的解释层的额外负担。
可以快速地开发迭代，因为客户端决定了需要的参数，不会因为 API 的变化造成很大的影响。
对于支持 GraphQL 的前端框架，如 React Native，Vue.js 和 Angular 等，使用起来更加方便。
GraphQL API 的缺点：
缺乏机制来告知客户端所有可用 API 的细节，这使得 API 变更管理变得特别困难，一个错误的查询可能会影响整个应用。
要求开发人员精通 GraphQL 的查询语言，如果没有精通相应的技能，上手可能较为困难。
REST 和 GraphQL 如何选择
在实际项目中，选用 REST API 还是 GraphQL API 取决于不同的情况。
如果你是在开发轻量的应用，那么 REST API 可能是更适合的选择。 REST API 是简单的，容易理解和学习，这将简化数据处理的过程，特别在文档化和支持性方面已经有了很好的支持。
在大型应用程序的情况下，你可能需要依靠更复杂的数据查询和批处理操作，这时候 GraphQL 可以派上用场。 GraphQL API 可以使客户端在单一 HTTP 请求中获取服务数据，减少了大量的资源请求和请求带宽，提供了更高效的数据查询和操作支持。
示例代码
下面是一个使用 GraphQL 和 REST 的简单示例：
GraphQL
-- -------------------- ---- ------- ---- ---- - --- ---- ----- -------- ---- ----- ------ -------- -------- -------- - ---- ------- - ------- -------- ----- -------- -------- ------- - ---- ----- - ------ ------- -------- ----- ---- -
REST
-- -------------------- ---- -------
-------------------- ----- ---- -- -
--------------------------------------------- ------ -- -
-- ----- ----- ----
----------------
---
---
------------------------ ----- ---- -- -
----- -- - --- ------------------------
---------------------------------------- ----- ----- -- -
-- ----- ----- ----
---------------
---
---总结
REST 和 GraphQL 都有自己的优点和缺点，选用适当的 API 设计取决于你的项目中的需求和业务实现。始终要记住，从用户（客户端）的角度出发，提供优化和可用性的 API 设计将影响应用程序性能以及长期成功的关键。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64a3e4d448841e9894052860