簡介

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/