建站
咨詢
售后
建站咨詢
新聞中心
工具現(xiàn)狀
Postman
Postman作為API調(diào)試的老大哥，整體的功能時比較全的，WebSocket(也是BETA)之前就已經(jīng)支持了。而在最近的幾個版本中Postman也提供了gRPC功能的支持。截止本文時間點，Postman最新版本為v9.14.0，所以本文也是基于該版本進(jìn)行學(xué)習(xí)和功能使用介紹。
Release Notes
Postman在最近幾個版本中對grpc的功能進(jìn)行了beta測試。
Postman v9.7.1
在v9.7.1中Postman首次支持了gRPC功能的使用，在當(dāng)時版本中已經(jīng)基本支持了gRPC的單獨功能使用。主要支持了單次、單雙向流式的gRPC調(diào)用。同時也能使用Postman中的變量。
在這個版本中需要我們手動在Postman中定義Proto文件。
Postman v9.9.0
在v9.9.0中支持了直接加載服務(wù)器中暴露出來的gRPC方法來直接使用。
Postman v9.14.0
在v9.14.0中可以直接使用加載本地中的proto文件作為定義文件來使用。
使用流程
在Postman中的接口定義流程和v9.7.1中基本一致，通過新建Request以及選擇gRPC來建立一個gRPC。其中主要定義功能我分為了6塊，具體分割如下圖：
service URL
需要定義service URL地址，ip或域名，主要注意是要指定gRPC的接口。
服務(wù)方法組
比較重要的是服務(wù)方法的選擇。目前有四種添加途徑：
- 通過服務(wù)器掃描映射。
- 加載本地文件
- 通過URL加載定義文件
- 直接創(chuàng)建一個新的API定義
但需要注意，通過服務(wù)器映射的這個方法我自己實際測試并不能完全地掃描到所有的服務(wù)器接口，可能是有用法上的問題。
而導(dǎo)入本地文件、使用導(dǎo)入url以及直接定義新的鏈接本質(zhì)上都是在Postman的APIs管理中添加了一個Protobuf定義文件，所以在v9.14.0版本的更新中所添加的“本地文件導(dǎo)入功能”，僅僅是幫助用戶省去了在APIs中新建定義接口的功能，但是直接將用戶的功能使用路線全部聚焦到接口調(diào)試界面中，我認(rèn)為很大程度的提高了用戶使用體驗。
但是不一樣的是，在使用本地導(dǎo)入的時候，如果使用"import"關(guān)鍵字引入了其他的proto定義文件，postman暫時無法描述這種定義關(guān)系，在request中可以直接使用，但是無法保存，也無法記錄到APIs中。所以盡量按照規(guī)范將接口描述在一個proto文件中。
調(diào)用方法
選擇需要調(diào)用的具體方法，其中左側(cè)圖標(biāo)會標(biāo)記出方法的調(diào)用類型。
消息定義
消息定義區(qū)域中有有三個tab，message中使用JSON方式來定義消息結(jié)構(gòu)體，在使用JSON定義結(jié)構(gòu)體的時候字符串與數(shù)值類型會自動在發(fā)送的時候根據(jù)proto中定義的類型。其余兩個的使用方式與Http API基本一致。
便捷工具
目前提供了“美化”與“請求樣例生成”功能，值得注意的是，在早期版本中樣例生成是用""的圖標(biāo)，但是在目前版本中直接使用文字進(jìn)行提示了，我猜測是因為燈泡的圖標(biāo)在大眾的使用習(xí)慣中主要是“幫助”、“提示”的意思，所有導(dǎo)致該功能的使用率較低，所以直接換成了文字進(jìn)行提示。
響應(yīng)體
該部分以JSON格式展示返回信息，以及其他的響應(yīng)狀態(tài)與訪問時間等。
最后
因為實際的使用需求所以對該P(yáng)ostman工具中的gRPC部分進(jìn)行了使用上的學(xué)習(xí)。根據(jù)Release Notes以及git上的Issues觀察了軟件的演進(jìn)這件事還挺有意思的。
網(wǎng)站名稱：一篇帶給你PostmangRPC功能使用介紹
標(biāo)題路徑：http://www.dlmjj.cn/article/djcooso.html
