今日視點：GraphQL全解析，你學(xué)會了嗎？

您可能已經(jīng)看過很多關(guān)于GraphQL的內(nèi)容，在這個過程中是不是有時會感到困惑和不知所措。本文讓我嘗試用更簡單易懂的語言回答關(guān)于GraphQL的三個主要問題：GraphQL是什么，如何工作，何時使用？希望對您更好地理解GraphQL有所裨益。

1 什么是GraphQL

“Graph”指的是數(shù)據(jù)以類似圖形的結(jié)構(gòu)表示和連接。在GraphQL中，數(shù)據(jù)表示為具有節(jié)點和邊的圖形，允許不同數(shù)據(jù)實體之間的靈活關(guān)系。

“QL”代表“查詢語言”，因為GraphQL提供了一種精確和可控的查詢或請求數(shù)據(jù)的語言。

(資料圖)

示例：書和作者的關(guān)系可以用圖來表示，可以很容易地使用GraphQL進(jìn)行查詢：

深入研究GraphQL，我們發(fā)現(xiàn)它是：

類型系統(tǒng)：定義數(shù)據(jù)的外觀以及事物之間的關(guān)系。類型系統(tǒng)定義各種數(shù)據(jù)類型和架構(gòu)，這是客戶端和服務(wù)器之間的合同。查詢語言：查詢數(shù)據(jù)的語言，它知道從哪里獲取數(shù)據(jù)并包含驗證或執(zhí)行查詢的規(guī)則。

簡而言之，GraphQL能讓客戶端精確指定它需要從API獲取的數(shù)據(jù)。

Facebook在2012年開始開發(fā)GraphQL，并于2015年將其發(fā)布為開源。2018年，GraphQL被移至新成立的GraphQL基金會，由非營利組織Linux基金會托管。

GraphQL支持讀取、寫入（變異）和訂閱數(shù)據(jù)的更改，讓我們可以實時更新。

2 GraphQL如何工作

GraphQL有兩個部分：請求數(shù)據(jù)的客戶端和提供數(shù)據(jù)的服務(wù)器，以下是解釋其工作原理的步驟：

i）定義模式：服務(wù)器定義GraphQL模式，這類似于描述可用數(shù)據(jù)和操作的藍(lán)圖。例如，如果我們有一個帶有字段（id、name和pageCount）的Book實體，并且有一個查詢是按id查詢書籍，則其模式將如下所示：

type Query {    bookById(id: ID): Book}type Book {    id: ID    name: String    pageCount: Int}

ii）發(fā)送查詢：客戶端向服務(wù)器發(fā)送GraphQL查詢，指定所需數(shù)據(jù)和所需結(jié)構(gòu)。

query bookDetails {  bookById(id: "book-1") {    id    name    pageCount  }}

iii）解決查詢：服務(wù)器的GraphQL引擎接收查詢并開始解決查詢。它根據(jù)查詢確定需要哪些數(shù)據(jù)，以及應(yīng)執(zhí)行哪些解析器函數(shù)來獲取該數(shù)據(jù)。

iv）獲取數(shù)據(jù)：解析器函數(shù)根據(jù)查詢要求從各種數(shù)據(jù)源（例如數(shù)據(jù)庫、API）檢索數(shù)據(jù)。

v）組裝響應(yīng)：GraphQL引擎收集檢索到的數(shù)據(jù)，并按客戶端請求的格式組裝響應(yīng)。它僅包括查詢中請求的確切數(shù)據(jù)字段，減少不必要的數(shù)據(jù)傳輸。

vi）返回響應(yīng)：服務(wù)器將響應(yīng)發(fā)送回客戶端，提供查詢中精確請求的數(shù)據(jù)。

3 何時可以使用GraphQL

GraphQL適用于處理復(fù)雜或經(jīng)常變化的數(shù)據(jù)需求，因為它可以將數(shù)據(jù)請求的控制權(quán)交給客戶端，讓客戶端在任何時間請求任何數(shù)據(jù)。這讓在每次API變更迭代或從這些API請求的數(shù)據(jù)發(fā)生變化時更容易進(jìn)行更新。與REST API相比，GraphQL允許客戶端精確指定所需數(shù)據(jù)的結(jié)構(gòu)和字段，從而避免了獲取過度或獲取不足的問題。因此，GraphQL可以提高數(shù)據(jù)傳輸?shù)木_性和效率，使應(yīng)用程序更加靈活和可擴(kuò)展。

如果應(yīng)用程序需要從多個來源聚合數(shù)據(jù)，GraphQL可以幫助把這些來源統(tǒng)一到單個API中。它提供了一個抽象層，可從各種服務(wù)中獲取和組合數(shù)據(jù)，使數(shù)據(jù)的獲取和整合更加簡單和高效。

當(dāng)應(yīng)用程序需要實時更新和訂閱時，GraphQL提供內(nèi)置功能。這些功能允許客戶端訂閱特定數(shù)據(jù)的變化，并在數(shù)據(jù)更改時實時推送通知，從而提高應(yīng)用程序的實時性和響應(yīng)性。

總之，如果您需要更好地控制和定制API響應(yīng)，并希望有效地處理復(fù)雜或不斷變化的數(shù)據(jù)需求，那么GraphQL是一個非常有用的工具。

4 使用Spring實現(xiàn)GraphQL

隨著spring-boot-starter-graphql框架的到來，使用Spring實現(xiàn)GraphQL變得更加容易。

在Spring項目中集成GraphQL的步驟如下：

i）向項目添加gradle/maven graphql starter依賴：

//Gradleimplementation "org.springframework.boot:spring-boot-starter-graphql"http://Maven    org.springframework.boot    spring-boot-starter-graphql

ii）創(chuàng)建一個目錄src/main/resources/graphql，并在該目錄下添加一個名為schema.graphqls的文件，包含以下內(nèi)容：

type Query {    bookById(id: ID): Book}type Book {    id: ID    name: String    pageCount: Int}

在這里，我們創(chuàng)建了一個Book的schema。每個schema都有一個頂級查詢類型，這里的schema定義了一個名為bookById的查詢，用于返回特定書籍的詳細(xì)信息。

iii）GraphQL服務(wù)器中的每個復(fù)雜類型都由Java bean表示，并且Java bean中的字段將直接映射到GraphQL響應(yīng)中的字段，其名稱基于字段名稱。

public record Book (String id, String name, int pageCount) {    private static List books = Arrays.asList(            new Book("book-1", "Effective Java", 416),            new Book("book-2", "Hitchhiker"s Guide to the Galaxy", 208),            new Book("book-3", "Down Under", 436)    );    public static Book getById(String id) {        return books.stream()    .filter(book -> book.id().equals(id))    .findFirst()    .orElse(null);    }}

iv) Spring的GraphQL提供了基于注解的編程模型。通過控制器注釋方法，我們可以聲明如何獲取特定GraphQL字段的數(shù)據(jù)?，F(xiàn)在讓我們添加BookController.java

@Controllerpublic class BookController {    @QueryMapping    public Book bookById(@Argument String id) {        return Book.getById(id);    }}

通過定義一個名為bookById的方法并用@QuerMapping注釋，此控制器聲明了如何獲取Query類型下定義的Book。查詢字段從方法名稱確定，但也可以在注釋本身上聲明。

v) Spring的GraphQL還為我們提供了一個用于編寫和執(zhí)行查詢的可視界面，名為GraphiQL。通過將以下配置添加到application.yaml文件中啟用GraphiQL:

spring  graphql    graphiql      enabled: true

啟動Spring應(yīng)用程序并導(dǎo)航到http://localhost:8080/graphiql.

vi）在窗口頂部鍵入查詢并單擊播放按鈕。

query bookDetails {  bookById(id: "book-1") {    id    name    pageCount  }}

您將看到以下響應(yīng)：

這樣您已經(jīng)構(gòu)建了一個GraphQL服務(wù)并成功查詢了數(shù)據(jù)！您的數(shù)據(jù)之旅從此開始！快動手試試吧~

關(guān)鍵詞：