寫的什么?
現在開發都要用到介面檔案,不寫的話代碼不知道怎么維護,寫的話又費時費力,更煩人的是有時候寫完了前端還要來問這個引數那個引數,真的苦不堪言,
在前后端分離的近幾年,寫介面檔案對我來說是老大難,后面特地去查了自動化工具的理論,才茅塞頓開,至少對于寫檔案的思路清晰了許多!
那么現在就來分享一下我怎么做的吧!
要做什么?
我們的目標,是寫出清晰簡練的檔案,所以,首先我們要確定:怎么才是清晰簡練的檔案,
如下圖所示:

上面的檔案簡練在哪?
首先,讓你知道它的功能,引數,一目了然;
其次,你輸入引數就能馬上看到結果,
我希望的是在完成代碼后,可以費很少的力氣,就生成一個像上圖所示的可除錯檔案,
那么接下來要做兩件事:
1、自動生成可視化的檔案;
2、檔案可除錯,

怎么協作?
一是可以直接在工具里完成整個專案,二是匯出不同格式的專案檔案,可用于其他檔案工具,

結語
我實作的工具是Eolinker
使用地址是:www.eolinker.com
類似的工具有很多, swagger editor,gwsee,apidoc,都還可以,
寫這篇文章不是推薦什么工具,但是自己走過一遍,肯定會有識訓哈哈:)
轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/228794.html
標籤:其他
上一篇:程式員的悲哀是什么?采訪了幾個大神,他們的回答我竟無法反駁
下一篇:api如何獲取cookie
