一統江湖的大前端（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服務器，可以方便地獲得更多模式相同的響應數據

  

• 自動化接口測試

  • 簡易的自動化測試語法

  

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

后記

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