代码拉取完成,页面将自动刷新
同步操作将从 caixw/apidoc 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
apidoc 是一个简单的 RESTful API 文档生成工具,它从代码注释中提取特定格式的内容,生成文档。 目前支持支持以下语言:C#、C/C++、Go、Java、Javascript、Perl、PHP、Python、Ruby、Rust 和 Swift
具体文档可参考:http://apidoc.tools
/**
* @api get /users 获取所有的用户信息
* @apiGroup users
* @apiQuery page int 显示第几页的内容
* @apiQuery size int 每页显示的数量
*
* @apiSuccess 200 ok
* @apiParam count int 符合条件的所有用户数量
* @apiParam users array 用户列表。
* @apiExample json
* {
* "count": 500,
* "users": [
* {"id":1, "username": "admin1", "name": "管理员2"},
* {"id":2, "username": "admin2", "name": "管理员2"}
* ],
* }
* @apiExmaple xml
* <users count="500">
* <user id="1" username="admin1" name="管理员1" />
* <user id="2" username="admin2" name="管理员2" />
* </users>
*/
func login(w http.ResponseWriter, r *http.Request){
// TODO
}
go get github.com/caixw/apidoc
若需要将 apidoc 当作包集成到其它 Go 程序中,可分别引用 input
和 output
的相关函数:
start := time.Now()
docs := doc.New()
// 分析文档内容
inputOptions := &input.Options{...}
docs, err := input.Parse(docs, inputOptions)
if err != nil {
// TODO
}
// 输出内容
outputOptions := &output.Options{...}
outputOptions.Elapsed = time.Now().Sub(start)
if err = output.Render(docs, outputOptions); err != nil {
// TODO
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。