(十二)java springcloud b2b2c多用户商城系统-springboot集成apidoc
生活随笔
收集整理的這篇文章主要介紹了
(十二)java springcloud b2b2c多用户商城系统-springboot集成apidoc
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
b2b2c電子商務(wù)社交平臺源碼請加企鵝求求:一零三八七七四六二六。首先聲明下,apidoc是基于注釋來生成文檔的,它不基于任何框架,而且支持大多數(shù)編程語言,為了springboot系列的完整性,所以標了個題。
一、apidoc簡介
apidoc通過在你代碼的注釋來生成api文檔的。它對代碼沒有侵入性,只需要你寫好相關(guān)的注釋即可,并且它僅通過寫簡單的配置就可以生成高顏值的api接口頁面。它基于node.js,所以你需要安裝node.js環(huán)境。node.js安裝。這里就不介紹。
二、準備工作
安裝完node.js安裝api.doc
通過命令安裝:
npm install apidoc -g復制代碼三、注釋怎么寫
@api {method} path [title]method:請求方法, path:請求路徑 title(可選):標題 @apiDescription @apiDescription text text說明 @apiError @apiError [(group)] [{type}] field [description](group)(可選):參數(shù)將以這個名稱分組,不設(shè)置的話,默認是Error 4xx {type}(可選):返回值類型,例如:{Boolean}, {Number}, {String}, {Object}, {String[]} field:返回值字段名稱 descriptionoptional(可選):返回值字段說明 @apiGroup @apiGroup name name:組名稱,也是導航的標題復制代碼寫個注釋:
/*** @api {POST} /register 注冊用戶* @apiGroup Users* @apiVersion 0.0.1* @apiDescription 用于注冊用戶* @apiParam {String} account 用戶賬戶名* @apiParam {String} password 密碼* @apiParam {String} mobile 手機號* @apiParam {int} vip = 0 是否注冊Vip身份 0 普通用戶 1 Vip用戶* @apiParam {String} [recommend] 邀請碼* @apiParamExample {json} 請求樣例:* ?account=sodlinken&password=11223344&mobile=13739554137&vip=0&recommend=* @apiSuccess (200) {String} msg 信息* @apiSuccess (200) {int} code 0 代表無錯誤 1代表有錯誤* @apiSuccessExample {json} 返回樣例:* {"code":"0","msg":"注冊成功"}*/復制代碼用apidoc命令生成文檔界面
先cd到工程的外層目錄,并在外層目建個輸出文檔的目錄,我建的是docapi。
輸命令:
apidoc -i chapter4/ -o apidoc/-i 輸入目錄 -o 輸出目錄復制代碼Spring Cloud大型企業(yè)分布式微服務(wù)云構(gòu)建的B2B2C電子商務(wù)平臺源碼請加企鵝求求:一零三八七七四六二六
轉(zhuǎn)載于:https://juejin.im/post/5cde71c751882525c104c766
總結(jié)
以上是生活随笔為你收集整理的(十二)java springcloud b2b2c多用户商城系统-springboot集成apidoc的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: AJAX(Asynchronous Ja
- 下一篇: 【转载】端口释放