一、訪問官網:
http://doclever.cn/controller/index/index.html
二、doclever作用(重點:mock帶有轉發功能)
DOClever是一個可視化接口管理工具 ,可以分析接口結構,校驗接口正確性, 圍繞接口定義文檔,通過一系列自動化工具提升我們的協作效率。
DOClever前后端全部采用了javascript來作為我們的開發語言,前端用的是vue+element UI,后端是express+mongodb,這樣的框架集成了高並發,迭代快的特點,保證系統的穩定可靠。
三、部署文檔操作:
1、鏈接:http://doclever.cn/controller/read/read.htm
2、此處只補充介紹window環境安裝部署:
①、環境需要安裝node環境,
推薦node 6.9版本
node官網地址:https://nodejs.org
②、
安裝mongodb
mongodb官網地址:https://www.mongodb.com/
64位下載庫:http://dl.mongodb.org/dl/win32/x86_64
32位下載庫:http://dl.mongodb.org/dl/win32/i386
下載完成后我們一路 next進行安裝即可,安裝完成后,我們需要啟動mongodb;
- MongoDB for Windows 64-bit 適合 64 位的 Windows Server 2008 R2, Windows 7 , 及最新版本的 Window 系統。
- MongoDB for Windows 32-bit 適合 32 位的 Window 系統及最新的 Windows Vista。 32 位系統上 MongoDB 的數據庫最大為 2GB。
- MongoDB for Windows 64-bit Legacy 適合 64 位的 Windows Vista, Windows Server 2003, 及 Windows Server 2008 。
根據你的系統下載 32 位或 64 位的 .msi 文件,下載后雙擊該文件,按操作提示安裝即可。
安裝過程中,你可以通過點擊 "Custom(自定義)" 按鈕來設置你的安裝目錄。
創建數據目錄
MongoDB將數據目錄存儲在 db 目錄下。但是這個數據目錄不會主動創建,我們在安裝完成后需要創建它。請注意,數據目錄應該放在根目錄下((如: C:\ 或者 D:\ 等 )。
在本教程中,我們已經在 C 盤安裝了 mongodb,現在讓我們創建一個 data 的目錄然后在 data 目錄里創建 db 目錄。
也可以通過 window 的資源管理器中創建這些目錄,而不一定通過命令行。
連接MongoDB
我們可以在命令窗口中運行 mongo.exe 命令即可連接上 MongoDB,執行如下命令:
C:\mongodb\bin\mongo.exe
③、下載工程代碼:https://github.com/sx1989827/DOClever
下載DOClever最新源代碼
這里我把下載下載好的源文件解壓到F:\wwwroot\doclever根目錄下面;
在命令行下運行node DOClever的根目錄:(上面我們提到的解壓地址在F:\wwwroot\doclever目錄下)\Server\bin\www(注意斜杠),運行之前先啟動mongo
在運行node www命令
啟動成功后,在瀏覽器輸入http://localhost:20000/ (這里20000改為你設置的端口號)
④、管理員賬號:
登錄管理后台,默認用戶名,密碼均為DOClever
三、添加接口
例如接口:http://10.204.57.103:9999/fcboxIndex/createExpressOrder?username=15999661223&password=n123456&senderContact=18520825002&receiverContact=18520825002&expressCompanyType=SF&payType=3
為真實接口,需要配置到DOClever平台
1、
2、請求參數配置
3、調試通本地接口,需要做如下操作:
4、啟動新server操作
登錄本地搭建好的DOClever平台,進入【設置】--【mock】,復制mock server鏈接
然后,根據真實服務器地址(http://10.204.57.103:9999),進入DOClever工程代碼目錄下,在doc界面運行:
node net.js http://localhost:8896/mock/5b0281b009831a19543c3a3c http://10.204.57.103:9999 即可
最后回到DOClever平台,進入【全局】---【環境配置】,添加mock系統環境地址http://localhost::36742
PS:https://www.zhihu.com/question/30434095
https://yapi.ymfe.org