??這應該是Postman最詳細的中文使用教程了??(新手使用,簡單明了)
在前后端分離開發時,后端作業人員完成系統介面開發后,需要與前端人員對接,測驗除錯介面,驗證介面的正確性可用性,而這要求前端開發進度和后端進度保持基本一致,任何一方的進度跟不上,都無法及時完成功能模塊的測驗,
做為后端開發人員,要求獨立開發完成某個介面后,開發人員自己需要先測驗通過后再提交給測驗人員進行測驗,否則會出現到測驗人員哪里業務流程根本就走不通,或者BUG會過多的情況等,
市場上有很多優秀的,完善的介面測驗工具,比如SoapUI,Postman等,能夠高效的幫助后端開發人員獨立進行介面測驗,這里使用Postman介面測驗工具,此處以請求方式為POST的userLogin登錄介面為例,
Postman安裝和使用
1、這個直接去官網下載即可,我們使用免費版即可滿足基本介面測驗,根據個人或者公司的專案實際情況考慮是否需要專業版或者其他,
免費版官網鏈接:https://www.getpostman.com/postman
下載好的安裝程式Postman-Win64-xxx-Setup.exe,雙擊安裝即可,建議安裝在非系統盤,即C盤在外的其他盤,另建議使用全英文路徑,避免使用中文路徑,
2、打開Postman如下圖,可以關閉該頁面跳過注冊賬戶,非登陸狀態下該工具可以直接使用,接下來出現引導頁面,類似IDEA,Android Studio等開發工具的引導頁,此處關閉即可,
注冊賬戶圖

專案創建引導圖
3、進入Postman主頁面并創建專案介面集合
這里是我之前用過,所以左側檔案欄存在幾個已有的檔案夾,
選擇功能選單New下的Collection創建專案介面集合,新建一個億的專案A hundred million,可在Description部分寫一下專案描述,
Postman主頁面

新建專案介面集合圖

4、創建專案模塊檔案夾
一般專案會分多個管理模塊或者功能模塊進行開發,這里可根據專案具體情況創建子檔案夾方便介面管理,此處在A hundred million專案右鍵創建資產管理assets檔案夾、user用戶管理檔案夾,可將測驗的介面實體保存在對于管理模塊下,
新建資產管理檔案夾

5、后臺登錄介面演示
開發完成后臺介面,撰寫正確嚴謹的邏輯代碼處理前端請求,此處登錄介面代碼如下,運行后臺開發專案,使該介面能夠訪問,
介面請求路徑為:http://localhost:8080/manage/app/user/login
@Controller @RequestMapping("/manage/app/") @Scope("prototype") public class AppUserController { /** * 日志 */ public static Logger customFile = LoggerFactory.getLogger("manageCustomFile"); @Resource private AppUserService appUserService; /** * 用戶登錄 * @param baseResult * @return */ @RequestMapping(value = "user/login" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST) @ResponseBody public BaseResult loginUser(@RequestBody BaseResult baseResult) { customFile.info("appId:"+ baseResult.getTreasureID()+ "用戶登陸訪問:" + baseResult.toString()); return appUserService.loginUser(baseResult); } }
6、新建介面測驗
在Postman主頁面Content部分點擊’+'按鈕,新增一個介面測驗,在圖2-6所示第一部分填寫介面請求路徑,左側下拉串列可選擇請求方式,此處選擇POST請求方式,介面請求路徑為http://localhost:8080/manage/app/user/login,
第二部分是請求體,即包含介面所需請求引數的Body,此處選擇原始資料RAW,資料型別使用JSON資料作為請求資料,點擊藍色Send按鈕發送請求,后臺專案介面接收請求并回應回傳執行結果,此處后臺處理資料回傳結果仍是JSON資料,這個看實際專案而定,此處僅做演示,
第三部分是介面回應體,即介面回應請求處理并回傳的資料,點擊Pretty自動匹配介面回傳的資料格式并對資料美化顯示,使資料看起來更加直觀,如果介面測驗出現例外,則可以通過PreView視圖查看瀏覽器回應介面的頁面資訊,也可以通過Header了解請求狀態等引數,一般出現例外還是直接去后臺看控制臺的例外資訊及專案日志來處理解決例外,再進行介面測驗,

介面測驗通過后,可Ctrl+S保存介面測驗實體,填寫介面測驗名稱和介面描述資訊,選擇要保存的路徑,此處保存在user用戶管理模塊檔案夾,當專案的介面全部測驗通過后,可在A hundred million專案右鍵Export匯出介面檔案,保存為JSON介面測驗檔案,該檔案可通過Postman匯入查看,
請求方式
對于后臺開發的介面,請求方式肯定不止POST一種,Postman也支持多種請求方式,在新建介面測驗實體時可選擇介面的請求方式,看下圖

請求型別可以模擬Form表單文本提交,Form表單檔案提交,raw原始資料提交,二進制檔案提交,對于原始資料型別raw還支持不同檔案格式,包括JSON,TXT,HTML等多種檔案格式,

資金記錄介面實體演示
后臺開發介面如下,服務器部署運行后臺專案,介面請求路徑為:
@Controller @RequestMapping("/manage/app/") @Scope("prototype") public class AppUserAssetController { /** * 日志 */ public static Logger customFile = LoggerFactory.getLogger("manageCustomFile"); @Resource private AppUserAssetService appUserAssetService; /** * 獲取提現記錄 * 即我的頁面中的資金記錄 * @param baseResult * @return */ @RequestMapping(value = "user/asset/withdrawRecord" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST) @ResponseBody public BaseResult getUserWithdrawRecord(@RequestBody BaseResult baseResult){ customFile.info( "appId:"+ baseResult.getTreasureID() + "用戶提現記錄獲取"+baseResult.toString()); return appUserAssetService.getUserWithdrawRecord(baseResult); } }
新建資金介面測驗
請求方式為POST,
請求URL為http://localhost:8080/manage/app/user/asset/withdrawRecord
請求體為JSON型別的原始資料
點擊Send請求介面,介面回應請求處理回傳結果

轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/325285.html
標籤:其他
