匯入 gRPC(.proto 或反射)
在 Restorm 中要得到一棵 gRPC 樹,有兩條路徑。
從 .proto 檔案
Section titled “從 .proto 檔案”檔案 ▸ 匯入(Ctrl+I),然後選擇 .proto 檔案。貼上內容同樣能被辨識
(存在 syntax = "proto…",或存在含有 rpc 的 service)。
| 項目 | Restorm 的處理方式 |
|---|---|
每個 service | 一個資料夾 |
每個 rpc | 一個 gRPC 請求 |
| 串流指示標記 | 呼叫的類型(unary、server-stream、client-stream、bidirectional-stream) |
| 輸入訊息 | 依訊息結構建構出的預填範例訊息 |
| 描述與型別 | API 文件與列舉 |
透過伺服器反射
Section titled “透過伺服器反射”在 gRPC 匯入對話框中,填入一台執行中伺服器的 host:port 位址。Restorm 會查詢它
的反射服務,並建構出與從 .proto 匯入完全相同的樹狀結構。

有兩個值得一提的好處:
- 之後離線也能用。 取得的描述元集合會儲存在每個所建立的請求上:即使反射 伺服器已無法連線,呼叫依然可以運作。
- 可以重新同步。 重新連線到同一個位址會被視為對既有樹狀結構的更新,而不是 一次新的匯入。請求分頁上也有一個從反射重新整理按鈕。
如果伺服器沒有實作反射,Restorm 會明確告知:此時請改為匯入 .proto。
gRPC 屬於可重新同步的格式,兩種模式皆然。請參閱 從來源更新。