构建 Web API 的两种流行选择：REST vs GraphQL

简介

RESTful 和 GraphQL API 是构建 Web API 的两种流行选择，各有其优势和劣势。让我们更近距离地了解一下 RESTful 和 GraphQL API，它们的区别，以及在何时选择其中一种。

RESTful API 已经存在了一段时间，并且通常被广泛使用，而 GraphQL 是近年来变得流行的较新技术。

第一部分：什么是 RESTful API？

RESTful API 遵循一组规则和约束，规定了 API 应该如何设计。

1.使用标准的 HTTP 方法

它们使用标准的 HTTP 方法，例如 GET、POST、PUT、PATCH 和 DELETE，对资源执行操作，数据通常以 JSON 格式 返回。

2.是无状态的

RESTful API 是无状态的，这意味着服务器不会在请求之间存储任何客户端上下文。相反，每个请求都包含服务器处理所需的所有信息。这使得 RESTful Web 服务高度可伸缩，因为它们可以处理大量请求而无需为会话管理负担。

3.具有 URL 约定

RESTful URL 命名约定 的主要原则之一是在 URL 路径中使用名词而不是动词。例如，不适合使用 /get-user-profile 这样的 URL，更适合使用 /users/{user_id}/profile。该 URL 使用名词 users 表示用户资源的集合，并使用路径参数 user_id 来标识要访问的特定用户资源。

第二部分：什么是 GraphQL？

GraphQL 是一个用于 API 的 查询语言，允许客户端定义其需要的数据的形状和结构。使用 GraphQL，客户端可以向服务器发出单个请求，并准确获取它们要求的数据，而没有其他多余的数据。

1.提供单个端点

与 RESTful API 不同，GraphQL 提供一个 单个端点，通常是 /graphql，它始终接受 POST 请求。客户端向此端点发送单个请求，服务器将根据通过请求体发送的查询或变更响应请求的数据。

这种方法使得管理和版本化 API 变得容易，因为所有更改都可以在一个地方进行。

2.是无状态的

GraphQL API 也是无状态的，服务器不存储任何客户端数据，每个请求都包含请求查询中的所有信息。

第三部分：比较 RESTful 和 GraphQL API

RESTful 和 GraphQL API 在设计和查询 API 方面采用不同的方法。让我们根据一些关键因素进行比较：

1.数据获取

RESTful API 遵循严格的请求-响应循环，其中来自客户端的每个请求都导致服务器的单个响应。这意味着客户端通常需要进行多个请求，从服务器获取相关数据，从而导致过度获取或不足获取数据。

GraphQL 相反，允许客户端仅请求他们需要的数据，而不是其他多余的数据。客户端可以指定他们需要的数据的结构，服务器会准确返回该数据，减少 过度获取 和 不足获取 数据。

2.模式定义

在 RESTful APIs 中，服务器定义数据模式，客户端需要解析返回的数据以理解模式。这可能导致客户端和服务器之间的耦合，因为服务器上的模式更改需要在客户端上进行相应的更改。

GraphQL 相反，具有强类型模式，定义了 API 中可用的数据。客户端可以使用此模式验证其查询并理解它们接收到的数据，减少客户端和服务器之间的耦合。

3.缓存

RESTful API 使用 HTTP 缓存头 具有 内建的缓存机制。这允许客户端缓存响应并避免向服务器发出不必要的请求。

GraphQL 没有内建的缓存机制，但 客户端可以使用第三方库实现缓存策略。

4.性能

RESTful API 在客户端需要多次请求相关数据时可能遇到性能问题。这可能导致增加的延迟和网络流量。

GraphQL 通过**在单个：

请求中仅获取所需数据**，可以提高性能并减少网络流量。但是，如果不小心，优化不良的查询可能会导致更多性能问题，并严重影响服务器。从这个角度来看，GraphQL 的最大优势也可能是它的最大劣势。

第四部分：你应该选择哪个？

在 RESTful 和 GraphQL API 之间的选择取决于您的具体用例。RESTful API 适用于需要高可伸缩性的简单应用程序，而 GraphQL 则适用于具有不同数据需求的复杂应用程序。

RESTful 和 GraphQL API 都有各自的优势和劣势。请记住，在两者之间进行选择并不总是二选一的情况，有时混合使用可能是最佳选择。

资源

• GraphQL 文档：https://graphql.org/
• 什么是 RESTful API：https://aws.amazon.com/what-is/restful-api/