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

《一統江湖的大前端》系列是自己的前端學習筆記，旨在介紹javascript在非網頁開發領域的應用案例和發現各類好玩的js庫，不定期更新。如果你對前端的理解還是寫寫頁面綁綁事件，那你真的是有點OUT了，前端能做的事情已經太多了, 手機app開發 , 桌面應用開發 , 用於神經網路人工智慧的庫 , 頁面游戲 , 數據可視化 , 甚至 嵌入式開發 ，什麼火就搞什麼,活脫脫一個蹭熱點小能手。如果你也覺得前端的日常開發有些枯燥，不妨一起來看看前端的另一番模樣。

Mock伺服器 + Excel怎麼了

如果你的開發進度還在被後端開發人員牽著鼻子走，請參考《一統江湖的大前端（2）—— Mock.js+Node.js如何與後端瀟灑分手》，優化自己的開發工作流

有了Mock伺服器和Excel的文檔說明後，相信大家的溝通效率會比以前提升很多，但仍然被溝通占據著絕大部分開發時間，常常遇到的情況會有：

• 沒有註釋信息，欄位不宜對齊
  Mock伺服器返回的只有數據，沒有註釋信息，即便後端開發人員有心把查到的信息重組為你需要的欄位，但仍有可能因為無法對號入座而作罷。

• 介面數量增加後難以管理
  簡易的Mock伺服器無法提供相應的介面文檔，隨著介面數量的增加，分分鐘亂成一鍋粥，總不能每次查個介面都是跑去翻Mock伺服器的源代碼然後看註釋吧

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

• 滿懷熱情寫了API文檔，But沒人看
  程式員大多沒有Excel習慣，而且大家都很忙，忙到即便你提供了Mock介面以及相關的API說明，他們還是會再問你一遍關於介面的信息程式員習慣以自己熟悉的方式進行工作，而且一般預設這種效率最高。

• Excel版本的API文檔方便交流，但不易更新
  一對一聯調時候還好，但如果項目組內協作人員較多時，麻煩就來了，每當你更新或是增加介面信息時，就要重新給所有相關人員發送一次新的Excel文件，很不方便。

DOClever——前端開發的介面管理工具

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

無論你當前在做的項目是否有管理好相關的介面文檔，作為開發人員，你都應該有自己的方式來管理好所有出自你手的介面

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伺服器，可以方便地獲得更多模式相同的響應數據

• 自動化介面測試
  • 簡易的自動化測試語法

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

後記

別人開發的代碼你可以不管，但出自你手的代碼， 願它們都是精品，易於查詢，易於管理。