国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專(zhuān)欄INFORMATION COLUMN

利用apidoc維護(hù)api接口文檔

biaoxiaoduan / 969人閱讀

摘要：什么是是一個(gè)輕量級(jí)的在線接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括和等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好界面美觀的在線接口文檔。雙擊文件夾下的，就能看到文檔了。

什么是apidoc 
apidoc是一個(gè)輕量級(jí)的在線REST接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括Java、C、C#、PHP和Javascript等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好、界面美觀的在線接口文檔。

這里了解更多

快速開(kāi)始

安裝依賴(lài)

安裝nodejs https://nodejs.org/官網(wǎng)下載.msi文件；
測(cè)試是否安裝成功 npm -v

npm的安裝。由于新版的NodeJS已經(jīng)集成了npm，所以之前npm也一并安裝好了。同樣可以使用cmd命令行輸入"npm -v"來(lái)測(cè)試是否成功安裝。如下圖，出現(xiàn)版本提示便OK了。

安裝apidoc

利用npm進(jìn)行安裝

npm install apidoc -g

安裝速度和網(wǎng)速有關(guān)，最多1到2分鐘，

apidoc -v  可以查看版本信息

安裝好后在

C:UsersadminAppDataRoaming
pm
ode_modulesapidoc

能夠看到如下文件

apidoc配置

打開(kāi)example文件夾apidoc.json為配置文件,修改參數(shù)為自己的項(xiàng)目信息。

{
  "name": "apidoc-example",
  "version": "0.3.0",
  "description": "apidoc example project",
  "title": "Custom apiDoc browser title",
  "url" : "https://api.github.com/v1",
  "sampleUrl": "https://api.github.com/v1",
  "header": {
    "title": "My own header title",
    "filename": "header.md"
  },
  "footer": {
    "title": "My own footer title",
    "filename": "footer.md"
  },
  "template": {
      "withCompare": true,
      "withGenerator": true
  }
}

將 apidoc.json 拷貝到需要生成文檔的目錄下

然后按照文檔說(shuō)明做代碼注釋

/**
 * @api {get} /sguoshan_api/Logon 獲取用戶(hù)信息
 * @apiVersion 1.0.0
 * @apiName  Logon
 * @apiGroup User
 * @apiPermission 所有已注冊(cè)用戶(hù)
 * @apiPrivate
 * @apiDescription 與0.9.0相比安全性提高
 *
 * @apiParam {String} username 用戶(hù)名稱(chēng)/郵箱/會(huì)員號(hào)
 * @apiParam {Number} password 用戶(hù)密碼
 * @apiExample 使用示例:
 * http://api.guoshanchina.com/sguoshan_api/Logon?username=911117&password=123456
 *
 * @apiSuccess {Number}   id            The Users-ID.
 * @apiSuccess {Date}     registered    Registration Date.
 * @apiSuccess {Date}     name          Fullname of the User.
 * @apiSuccess {String[]} nicknames     List of Users nicknames (Array of Strings).
 * @apiSuccess {Object}   profile       Profile data (example for an Object)
 * @apiSuccess {Number}   profile.age   Users age.
 * @apiSuccess {String}   profile.image Avatar-Image.
 * @apiSuccess {Object[]} options       List of Users options (Array of Objects).
 * @apiSuccess {String}   options.name  Option Name.
 * @apiSuccess {String}   options.value Option Value.
 *
 * @apiSuccessExample 成功 return ():
{
"msg": "獲取成功",
"status":"200",
"data":{
    "id":"123",
    "name":"shmily"
    }
}
 * @apiError NoAccessRight     只用登陸成功才能訪問(wèn).
 * @apiError UserNotFound   用戶(hù) id 錯(cuò)誤.
 * @apiErrorExample 失敗 return ():
 *     HTTP/1.1 401 Not Authenticated
 *     {
 *       "msg": "沒(méi)有權(quán)限","status":"401"
 *     }
 */
function getUser() { return; }

在命令行中

切換到項(xiàng)目apidoc.json的上一級(jí)（api目錄）
d:
cd www/shop/Web
apidoc -i api/ -o apidoc/


運(yùn)行后在api的同級(jí)目錄能夠看到生成了apidoc的文件夾。雙擊文件夾下的index.html，就能看到文檔了。

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://specialneedsforspecialkids.com/yun/88608.html

相關(guān)文章

  • 利用apidoc維護(hù)api接口文檔

    摘要：什么是是一個(gè)輕量級(jí)的在線接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括和等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好界面美觀的在線接口文檔。雙擊文件夾下的，就能看到文檔了。 什么是apidoc apidoc是一個(gè)輕量級(jí)的在線REST接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括Java、C、C#、PHP和Javascript等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好、界面美觀的在線接...

    hiyayiji 評(píng)論0 收藏0

  • 利用apidoc維護(hù)api接口文檔

    摘要：什么是是一個(gè)輕量級(jí)的在線接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括和等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好界面美觀的在線接口文檔。雙擊文件夾下的，就能看到文檔了。 什么是apidoc apidoc是一個(gè)輕量級(jí)的在線REST接口文檔生成系統(tǒng)，支持多種主流語(yǔ)言，包括Java、C、C#、PHP和Javascript等。使用者按照要求書(shū)寫(xiě)相關(guān)注釋?zhuān)涂梢陨煽勺x性好、界面美觀的在線接...

    shaonbean 評(píng)論0 收藏0

  • Web API 文檔生成工具 apidoc

    摘要：實(shí)現(xiàn)接口文檔編寫(xiě)工作，有很多種方式，例如通過(guò)文檔編寫(xiě)，或者通過(guò)進(jìn)行維護(hù)。這里，筆者想分享另一個(gè)文檔生成工具。此外，可以支持多種語(yǔ)言，，，，，，。查詢(xún)簽收預(yù)警策略查詢(xún)簽收預(yù)警策略平臺(tái)類(lèi)型商家名稱(chēng)最后，我們?cè)诮K端輸入命令進(jìn)行文檔生成。 原文地址：梁桂釗的博客 在服務(wù)端開(kāi)發(fā)過(guò)程中，我們需要提供一份 API 接口文檔給 Web 端和移動(dòng)端使用。實(shí)現(xiàn) API 接口文檔編寫(xiě)工作，有很多種方式，例...

    sushi 評(píng)論0 收藏0

  • [原] Python 開(kāi)發(fā)者面向文檔編程的正確姿勢(shì)

    摘要：用注釋寫(xiě)單元測(cè)試單元測(cè)試是代碼開(kāi)發(fā)環(huán)節(jié)必不可少的一環(huán)，對(duì)于定位和代碼質(zhì)量而言是非常重要的?，F(xiàn)在最廣為人知的單元測(cè)試框架就是，它借鑒了中成熟的單元測(cè)試框架的。 概述 showImg(https://segmentfault.com/img/bVD66s?w=550&h=550); 秦人不暇自哀,而后人哀之;后人哀之而不鑒之,亦使后人而復(fù)哀后人也! --論面向文檔編程的重要性 如果想看見(jiàn)識(shí)...

    Y3G 評(píng)論0 收藏0

發(fā)表評(píng)論

0條評(píng)論

閱讀需要支付1元查看
<