跳到內容

匯入 gRPC(.proto 或反射)

在 Restorm 中要得到一棵 gRPC 樹,有兩條路徑。

檔案 ▸ 匯入Ctrl+I),然後選擇 .proto 檔案。貼上內容同樣能被辨識 (存在 syntax = "proto…",或存在含有 rpcservice)。

項目Restorm 的處理方式
每個 service一個資料夾
每個 rpc一個 gRPC 請求
串流指示標記呼叫的類型(unaryserver-streamclient-streambidirectional-stream
輸入訊息依訊息結構建構出的預填範例訊息
描述與型別API 文件與列舉

在 gRPC 匯入對話框中,填入一台執行中伺服器的 host:port 位址。Restorm 會查詢它 的反射服務,並建構出與從 .proto 匯入完全相同的樹狀結構。

「gRPC 伺服器(反射)」對話框:host 位址欄位、「使用 TLS」選項,以及選用的身分驗證中介資料表格

有兩個值得一提的好處:

  1. 之後離線也能用。 取得的描述元集合會儲存在每個所建立的請求上:即使反射 伺服器已無法連線,呼叫依然可以運作。
  2. 可以重新同步。 重新連線到同一個位址會被視為對既有樹狀結構的更新,而不是 一次新的匯入。請求分頁上也有一個從反射重新整理按鈕。

如果伺服器沒有實作反射,Restorm 會明確告知:此時請改為匯入 .proto

gRPC 屬於可重新同步的格式,兩種模式皆然。請參閱 從來源更新