一統(tǒng)江湖的大前端（3） DOClever——你的postman有點(diǎn)low

《一統(tǒng)江湖的大前端》系列是自己的前端學(xué)習(xí)筆記，旨在介紹javascript在非網(wǎng)頁(yè)開(kāi)發(fā)領(lǐng)域的應(yīng)用案例和發(fā)現(xiàn)各類好玩的js庫(kù)，不定期更新。如果你對(duì)前端的理解還是寫寫頁(yè)面綁綁事件，那你真的是有點(diǎn)OUT了，前端能做的事情已經(jīng)太多了, 手機(jī)app開(kāi)發(fā) , 桌面應(yīng)用開(kāi)發(fā) , 用于神經(jīng)網(wǎng)絡(luò)人工智能的庫(kù) , 頁(yè)面游戲 , 數(shù)據(jù)可視化 , 甚至 嵌入式開(kāi)發(fā) ，什么火就搞什么,活脫脫一個(gè)蹭熱點(diǎn)小能手。如果你也覺(jué)得前端的日常開(kāi)發(fā)有些枯燥，不妨一起來(lái)看看前端的另一番模樣。

Mock服務(wù)器 + Excel怎么了

如果你的開(kāi)發(fā)進(jìn)度還在被后端開(kāi)發(fā)人員牽著鼻子走，請(qǐng)參考《一統(tǒng)江湖的大前端（2）—— Mock.js+Node.js如何與后端瀟灑分手》，優(yōu)化自己的開(kāi)發(fā)工作流

有了Mock服務(wù)器和Excel的文檔說(shuō)明后，相信大家的溝通效率會(huì)比以前提升很多，但仍然被溝通占據(jù)著絕大部分開(kāi)發(fā)時(shí)間，常常遇到的情況會(huì)有：

• 沒(méi)有注釋信息，字段不宜對(duì)齊
  Mock服務(wù)器返回的只有數(shù)據(jù)，沒(méi)有注釋信息，即便后端開(kāi)發(fā)人員有心把查到的信息重組為你需要的字段，但仍有可能因?yàn)闊o(wú)法對(duì)號(hào)入座而作罷。

• 接口數(shù)量增加后難以管理
  簡(jiǎn)易的Mock服務(wù)器無(wú)法提供相應(yīng)的接口文檔，隨著接口數(shù)量的增加，分分鐘亂成一鍋粥，總不能每次查個(gè)接口都是跑去翻Mock服務(wù)器的源代碼然后看注釋吧

• 無(wú)測(cè)試支持
  MockJs只生成模擬數(shù)據(jù)，并無(wú)任何對(duì)自動(dòng)化測(cè)試的支持

• 滿懷熱情寫了API文檔，But沒(méi)人看
  程序員大多沒(méi)有Excel習(xí)慣，而且大家都很忙，忙到即便你提供了Mock接口以及相關(guān)的API說(shuō)明，他們還是會(huì)再問(wèn)你一遍關(guān)于接口的信息程序員習(xí)慣以自己熟悉的方式進(jìn)行工作，而且一般默認(rèn)這種效率最高。

• Excel版本的API文檔方便交流，但不易更新
  一對(duì)一聯(lián)調(diào)時(shí)候還好，但如果項(xiàng)目組內(nèi)協(xié)作人員較多時(shí)，麻煩就來(lái)了，每當(dāng)你更新或是增加接口信息時(shí)，就要重新給所有相關(guān)人員發(fā)送一次新的Excel文件，很不方便。

DOClever——前端開(kāi)發(fā)的接口管理工具

Java開(kāi)發(fā)人員有Swagger，無(wú)嚴(yán)格保密性要求的可以嘗試阿里的RAP，都是專業(yè)且強(qiáng)大的接口管理工具。當(dāng)我們僅希望在內(nèi)網(wǎng)中使用，或僅僅處于優(yōu)化個(gè)人工作流的目的時(shí)，強(qiáng)烈推薦這塊開(kāi)源接口管理軟件——DOClever，DOClever非常適合前端人員使用，VUE+express+mongodb編寫，純前端技術(shù)棧，能夠?qū)崿F(xiàn)團(tuán)隊(duì)管理，接口管理，文檔管理，自動(dòng)化測(cè)試等功能，甚至可以根據(jù)接口返回?cái)?shù)據(jù)自動(dòng)生成接口文檔的結(jié)構(gòu)，方便智能。

無(wú)論你當(dāng)前在做的項(xiàng)目是否有管理好相關(guān)的接口文檔，作為開(kāi)發(fā)人員，你都應(yīng)該有自己的方式來(lái)管理好所有出自你手的接口

MockJs尚未失寵

• 特殊場(chǎng)景
  DOClever自帶的Mock工具可以按參數(shù)類型生成虛擬數(shù)據(jù)，對(duì)于開(kāi)發(fā)人員交流已經(jīng)夠用了，但如果前臺(tái)需要多條模式相同的數(shù)據(jù)時(shí)，就需要用到上一篇博客中提到的MockJs來(lái)生成，（DOClever自帶的Mock語(yǔ)法貌似尚未支持循環(huán)生成雷同數(shù)據(jù)，除了自己修改源代碼外，如果還有其他更方便的實(shí)現(xiàn)方法也請(qǐng)不吝賜教~），DOClever中可以設(shè)置多臺(tái)Mock服務(wù)器的url地址，常見(jiàn)的協(xié)作需求中，兩套數(shù)據(jù)基本夠用了，一套方便快捷，配合核對(duì)接口，另一套需要自定義開(kāi)發(fā)，配合實(shí)現(xiàn)各種前端展示需求。

DOClever的安裝

安裝需要的東西真的比較多，尤其是對(duì)于非前端人員而言。

• 1.安裝nodejs
  上一篇博客的附件中有nodejs V8.9的安裝包
• 2.安裝mongodb
  mongodb的安裝可以參考Windows環(huán)境下如何安裝mongodb
• 3.安裝mongodb可視化管理工具(個(gè)人推薦robot3T)[可選]
• 4.安裝DOClever
  由于是開(kāi)源項(xiàng)目，直接在github上下載DOClever,使用方法主頁(yè)有很詳細(xì)的說(shuō)明，按步驟來(lái)部署就可以了。
  自己部署的圖：

開(kāi)始DOCLever

• 可視化的管理API

  • 界面左側(cè)樹(shù)形圖式管理所有相關(guān)API，方便查找
  • 可視化界面直接填寫API相關(guān)信息
  • 參數(shù)化填寫request請(qǐng)求體
  • 參數(shù)化編寫響應(yīng)數(shù)據(jù)，支持無(wú)限層次嵌套

  

• 方便的Mock數(shù)據(jù)獲取

  • 直接選擇DOClever自帶的mock服務(wù)器，可以方便地與協(xié)作人員溝通接口字段和結(jié)構(gòu)
  • 選擇自己搭建的Mock服務(wù)器，可以方便地獲得更多模式相同的響應(yīng)數(shù)據(jù)

  

• 自動(dòng)化接口測(cè)試

  • 簡(jiǎn)易的自動(dòng)化測(cè)試語(yǔ)法

  

• 自動(dòng)化測(cè)試集計(jì)劃任務(wù)
  • 定時(shí)跑任務(wù)自動(dòng)化測(cè)試用例集
    

后記

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