一統江湖的大前端(3) DOClever——你的postman有點low

《一統江湖的大前端》系列是本身的前端學習筆記,旨在介紹javascript在非網頁開發領域的應用案例和發現各種好玩的js庫,不按期更新。若是你對前端的理解仍是寫寫頁面綁綁事件,那你真的是有點OUT了,前端能作的事情已經太多了, 手機app開發 , 桌面應用開發 , 用於神經網絡人工智能的庫 , 頁面遊戲 , 數據可視化 , 甚至 嵌入式開發 ,什麼火就搞什麼,活脫脫一個蹭熱點小能手。若是你也以爲前端的平常開發有些枯燥,不妨一塊兒來看看前端的另外一番模樣。javascript

Mock服務器 + Excel怎麼了

若是你的開發進度還在被後端開發人員牽着鼻子走,請參考《一統江湖的大前端(2)—— Mock.js+Node.js如何與後端瀟灑分手》,優化本身的開發工做流html

有了Mock服務器和Excel的文檔說明後,相信你們的溝通效率會比之前提高不少,但仍然被溝通佔據着絕大部分開發時間,經常遇到的狀況會有:前端

  • 沒有註釋信息,字段不宜對齊
    Mock服務器返回的只有數據,沒有註釋信息,即使後端開發人員有心把查到的信息重組爲你須要的字段,但仍有可能由於沒法對號入座而做罷。java

  • 接口數量增長後難以管理
    簡易的Mock服務器沒法提供相應的接口文檔,隨着接口數量的增長,分分鐘亂成一鍋粥,總不能每次查個接口都是跑去翻Mock服務器的源代碼而後看註釋吧node

  • 無測試支持
    MockJs只生成模擬數據,並沒有任何對自動化測試的支持git

  • 滿懷熱情寫了API文檔,But沒人看
    程序員大多沒有Excel習慣,並且你們都很忙,忙到即使你提供了Mock接口以及相關的API說明,他們仍是會再問你一遍關於接口的信息程序員習慣以本身熟悉的方式進行工做,並且通常默認這種效率最高程序員

  • Excel版本的API文檔方便交流,但不易更新
    一對一聯調時候還好,但若是項目組內協做人員較多時,麻煩就來了,每當你更新或是增長接口信息時,就要從新給全部相關人員發送一次新的Excel文件,很不方便。github

DOClever——前端開發的接口管理工具

Java開發人員有Swagger,無嚴格保密性要求的能夠嘗試阿里的RAP,都是專業且強大的接口管理工具。當咱們僅但願在內網中使用,或僅僅處於優化我的工做流的目的時,強烈推薦這塊開源接口管理軟件——DOCleverDOClever很是適合前端人員使用,VUE+express+mongodb編寫,純前端技術棧,可以實現團隊管理接口管理文檔管理自動化測試等功能,甚至能夠根據接口返回數據自動生成接口文檔的結構,方便智能。mongodb

不管你當前在作的項目是否有管理好相關的接口文檔,做爲開發人員,你都應該有本身的方式來管理好全部出自你手的接口express

MockJs還沒有失寵

  • 特殊場景
    DOClever自帶的Mock工具能夠按參數類型生成虛擬數據,對於開發人員交流已經夠用了,但若是前臺須要多條模式相同的數據時,就須要用到上一篇博客中提到的MockJs來生成,(DOClever自帶的Mock語法貌似還沒有支持循環生成雷同數據,除了本身修改源代碼外,若是還有其餘更方便的實現方法也請不吝賜教~),DOClever中能夠設置多臺Mock服務器的url地址,常見的協做需求中,兩套數據基本夠用了,一套方便快捷,配合覈對接口,另外一套須要自定義開發,配合實現各類前端展現需求。

DOClever的安裝

安裝須要的東西真的比較多,尤爲是對於非前端人員而言。

  • 1.安裝nodejs
    上一篇博客的附件中有nodejs V8.9的安裝包
  • 2.安裝mongodb
    mongodb的安裝能夠參考Windows環境下如何安裝mongodb
  • 3.安裝mongodb可視化管理工具(我的推薦robot3T)[可選]
  • 4.安裝DOClever
    因爲是開源項目,直接在github上下載DOClever,使用方法主頁有很詳細的說明,按步驟來部署就能夠了。
    本身部署的圖:

開始DOCLever

  • 可視化的管理API
    • 界面左側樹形圖式管理全部相關API,方便查找
    • 可視化界面直接填寫API相關信息
    • 參數化填寫request請求體
    • 參數化編寫響應數據,支持無限層次嵌套

  • 方便的Mock數據獲取
    • 直接選擇DOClever自帶的mock服務器,能夠方便地與協做人員溝通接口字段和結構
    • 選擇本身搭建的Mock服務器,能夠方便地得到更多模式相同的響應數據

  • 自動化接口測試
    • 簡易的自動化測試語法

  • 自動化測試集計劃任務
    • 定時跑任務自動化測試用例集

後記

別人開發的代碼你能夠無論,但出自你手的代碼, 願它們都是精品,易於查詢,易於管理。

相關文章
相關標籤/搜索