gRPC 是什麼？

gRPC（gRPC Remote Procedure Call）是一個高性能的開源框架，它通過遠程過程調用（RPC）機制促進應用程序之間的通信。

gRPC 框架使客户端應用程序能夠調用不同機器上的服務器應用程序的方法，就好像它是本地對象一樣。因此，該框架通過抽象網絡通信的複雜性，簡化了分佈式系統的開發。

gRPC 的關鍵特性

語言中立性

RPC 是平台無關的，並支持多種編程語言，促進了不同開發環境之間的互操作性。這意味着用一種語言編寫的 gRPC 服務可以被另一種語言的客户端調用，只要這兩種語言都有 gRPC 庫。

協議緩衝區

它利用協議緩衝區（Protocol Buffers），這是一種用於定義數據結構和遠程服務接口的語言中立機制。這確保了客户端和服務器之間高效的數據序列化和反序列化。協議緩衝區定義了服務之間交換的數據結構。

在通過網絡發送之前，數據被序列化成緊湊的二進制格式，然後在接收端反序列化回原始格式。這種二進制格式比如 JSON 或 XML 的文本格式更高效，可以提升 gRPC 應用的性能。

高性能

gRPC 利用 HTTP/2 進行高效的數據傳輸，與傳統的 RPC 框架相比，通信更快。HTTP/2 是對今天大多數網絡流量基礎上的 HTTP/1.1 協議的重大改進。HTTP/2 允許通過單一連接發送多個請求，這可以顯著減少延遲。此外，HTTP/2 支持頭部壓縮，進一步提升性能。

豐富的功能

它提供了內置的功能，如認證、授權、負載均衡和健康檢查，簡化了開發過程。這些功能有助於確保 gRPC 應用的安全性、可靠性和可擴展性。

自動代碼生成

gRPC 利用協議緩衝區定義自動生成客户端和服務器代碼，這可以節省開發人員的時間和精力，同時有助於確保客户端和服務器代碼的兼容性。

支持流式傳輸

gRPC 支持不同的流式傳輸模式，包擁有單次請求/單次響應（Unary）、客户端流式（多次請求/單次響應）、服務器端流式（單次請求/多次響應）和雙向流式（多次請求/多次響應）。這種靈活性使 gRPC 適用於廣泛的用例，包括實時數據流和文件傳輸。

gRPC 狀態碼是什麼？

gRPC 框架依賴於 gRPC 狀態碼來傳達 RPC（遠程過程調用）的結果，為用户提供操作是成功還是失敗的信息。

gRPC 狀態碼的類型

gRPC 定義了一組狀態碼來傳達 RPC 的結果。這些代碼比簡單的成功/失敗消息提供更具體的信息，使客户能夠了解可能發生的任何錯誤的性質。以下是不同類型的分解：

成功（OK）

• 代碼：0
• 描述：RPC 成功完成。這是理想的結果，表明服務器無問題地處理了請求。

錯誤代碼（用户生成）

這些代碼通常由服務器端的應用邏輯生成，並指示在 RPC 過程中遇到的特定問題。

CANCELLED（代碼：1）

• 描述：操作被取消，通常是應客户的請求。這可能是由於超時、用户交互或其他原因。

UNKNOWN（代碼：2）

• 描述：服務器上發生了意外錯誤，且沒有更具體的問題細節。這是一個未預見問題的集合。

INVALID_ARGUMENT（代碼：3）

• 描述：客户在請求中提供了無效參數。這可能是因為缺少必需字段、數據類型錯誤或超出預期範圍的值。

DEADLINE_EXCEEDED（代碼：4）

• 描述：請求完成耗時過長，超過了設定的截止時間。這可能是因為服務器處理慢、網絡問題或傳輸的數據量過大。

NOT_FOUND（代碼：5）

• 描述：服務器上未找到請求的資源（例如文件、數據庫條目）。

ALREADY_EXISTS（代碼：6）

• 描述：嘗試創建已經存在的資源。這可能是在嘗試插入重複數據或創建具有衝突名稱的內容時發生的。

PERMISSION_DENIED（代碼：7）

• 描述：客户端缺乏執行請求操作的必要權限。這可能是由於訪問控制不足或安全設置問題。

RESOURCE_EXHAUSTED（代碼：8）

• 描述：服務器耗盡了完成請求所需的資源（例如內存、磁盤空間）。

FAILED_PRECONDITION（代碼：9）

• 描述：由於服務器處於意外狀態，請求無法處理。這可能是由於與參數本身無直接相關的請求中的無效數據，或服務器處於不一致狀態。

ABORTED（代碼：10）

• 描述：服務器端中止了操作。這可能是由於服務器實現特定的各種原因。

OUT_OF_RANGE（代碼：11）

• 描述：請求包含在預期範圍之外的值。這可能是一組有效數字之外的數字或不符合允許時間範圍的日期。

UNIMPLEMENTED（代碼：12）

• 描述：服務器不支持請求的 RPC 方法。這可能是因為服務器缺少實現或過時的客户端嘗試使用較新功能。

INTERNAL（代碼：13）

• 描述：發生內部服務器錯誤。這是在服務器遇到意外問題且無法更具體分類時使用的通用錯誤代碼。

庫生成的代碼（gRPC 核心）

這些代碼不是直接由用户代碼生成的，而是在特定情況下由 gRPC 庫自身生成的。

DATA_LOSS（代碼：15）

• 描述：在 RPC 中發生了數據丟失。這可能是由於網絡問題或存儲系統問題。

gRPC 調試和管理

下面使用 Apifox 做演示，用户可以訪問到對所有gRPC調用方法的控制，包括：

• Unary（一對一）
• Server Streaming（服務器端流）
• Client Streaming（客户端流）
• Bidirectional Streaming（雙向流）

1. 創建一個新的 gRPC 項目

首先，在控制枱中點擊“創建新項目”的按鈕。在項目類型中選擇gRPC，輸入你的項目名稱然後點擊“創建”按鈕開始一個新項目。

2. 上傳.proto文件

通過導入用於定義 gRPC 服務，方法和消息的.proto文件來配置你的接口。這個文件可以通過拖放到上傳區域或者通過提供一個在線的URL來進行上傳。

3. 開始調試你的 gRPC 接口

一旦.proto文件被上傳，Apifox會根據文件內容自動生成所需的接口信息。此時，你可以開始進行接口調試。通過模擬請求和查看響應來測試和優化你的應用。

結論

gRPC 狀態代碼在確保計算機應用程序之間高效且信息豐富的通信方面起着至關重要的作用。通過利用標準化的代碼系統，開發人員可以簡化錯誤處理並有效地傳達交互過程中出現的問題的原因。