簡介

RESTful 和 GraphQL API 是構(gòu)建 Web API 的兩種流行選擇，各有其優(yōu)勢和劣勢。讓我們更近距離地了解一下 RESTful 和 GraphQL API，它們的區(qū)別，以及在何時選擇其中一種。

RESTful API 已經(jīng)存在了一段時間，并且通常被廣泛使用，而 GraphQL 是近年來變得流行的較新技術。

第一部分：什么是 RESTful API？

RESTful API 遵循一組規(guī)則和約束，規(guī)定了 API 應該如何設計。

1.使用標準的 HTTP 方法

它們使用標準的 HTTP 方法，例如 GET、POST、PUT、PATCH 和 DELETE，對資源執(zhí)行操作，數(shù)據(jù)通常以 JSON 格式 返回。

2.是無狀態(tài)的

RESTful API 是無狀態(tài)的，這意味著服務器不會在請求之間存儲任何客戶端上下文。相反，每個請求都包含服務器處理所需的所有信息。這使得 RESTful Web 服務高度可伸縮，因為它們可以處理大量請求而無需為會話管理負擔。

3.具有 URL 約定

RESTful URL 命名約定 的主要原則之一是在 URL 路徑中使用名詞而不是動詞。例如，不適合使用 /get-user-profile 這樣的 URL，更適合使用 /users/{user_id}/profile。該 URL 使用名詞 users 表示用戶資源的集合，并使用路徑參數(shù) user_id 來標識要訪問的特定用戶資源。

第二部分：什么是 GraphQL？

GraphQL 是一個用于 API 的 查詢語言，允許客戶端定義其需要的數(shù)據(jù)的形狀和結(jié)構(gòu)。使用 GraphQL，客戶端可以向服務器發(fā)出單個請求，并準確獲取它們要求的數(shù)據(jù)，而沒有其他多余的數(shù)據(jù)。

1.提供單個端點

與 RESTful API 不同，GraphQL 提供一個 單個端點，通常是 /graphql，它始終接受 POST 請求?？蛻舳讼虼硕它c發(fā)送單個請求，服務器將根據(jù)通過請求體發(fā)送的查詢或變更響應請求的數(shù)據(jù)。

這種方法使得管理和版本化 API 變得容易，因為所有更改都可以在一個地方進行。

2.是無狀態(tài)的

GraphQL API 也是無狀態(tài)的，服務器不存儲任何客戶端數(shù)據(jù)，每個請求都包含請求查詢中的所有信息。

第三部分：比較 RESTful 和 GraphQL API

RESTful 和 GraphQL API 在設計和查詢 API 方面采用不同的方法。讓我們根據(jù)一些關鍵因素進行比較：

1.數(shù)據(jù)獲取

RESTful API 遵循嚴格的請求-響應循環(huán)，其中來自客戶端的每個請求都導致服務器的單個響應。這意味著客戶端通常需要進行多個請求，從服務器獲取相關數(shù)據(jù)，從而導致過度獲取或不足獲取數(shù)據(jù)。

GraphQL 相反，允許客戶端僅請求他們需要的數(shù)據(jù)，而不是其他多余的數(shù)據(jù)。客戶端可以指定他們需要的數(shù)據(jù)的結(jié)構(gòu)，服務器會準確返回該數(shù)據(jù)，減少 過度獲取 和 不足獲取 數(shù)據(jù)。

2.模式定義

在 RESTful APIs 中，服務器定義數(shù)據(jù)模式，客戶端需要解析返回的數(shù)據(jù)以理解模式。這可能導致客戶端和服務器之間的耦合，因為服務器上的模式更改需要在客戶端上進行相應的更改。

GraphQL 相反，具有強類型模式，定義了 API 中可用的數(shù)據(jù)?？蛻舳丝梢允褂么四Ｊ津炞C其查詢并理解它們接收到的數(shù)據(jù)，減少客戶端和服務器之間的耦合。

3.緩存

RESTful API 使用 HTTP 緩存頭 具有 內(nèi)建的緩存機制。這允許客戶端緩存響應并避免向服務器發(fā)出不必要的請求。

GraphQL 沒有內(nèi)建的緩存機制，但 客戶端可以使用第三方庫實現(xiàn)緩存策略。

4.性能

RESTful API 在客戶端需要多次請求相關數(shù)據(jù)時可能遇到性能問題。這可能導致增加的延遲和網(wǎng)絡流量。

GraphQL 通過**在單個：

請求中僅獲取所需數(shù)據(jù)**，可以提高性能并減少網(wǎng)絡流量。但是，如果不小心，優(yōu)化不良的查詢可能會導致更多性能問題，并嚴重影響服務器。從這個角度來看，GraphQL 的最大優(yōu)勢也可能是它的最大劣勢。

第四部分：你應該選擇哪個？

在 RESTful 和 GraphQL API 之間的選擇取決于您的具體用例。RESTful API 適用于需要高可伸縮性的簡單應用程序，而 GraphQL 則適用于具有不同數(shù)據(jù)需求的復雜應用程序。

RESTful 和 GraphQL API 都有各自的優(yōu)勢和劣勢。請記住，在兩者之間進行選擇并不總是二選一的情況，有時混合使用可能是最佳選擇。

資源

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