goweb如何使用swagger自动化文档

Question

如何自动化文档，做api接口

Answer 1

我现在是在后端生成的文档，在http函数上面加注解的方式
github 地址 https://github.com/yvasiyarov...
比如：

/*
@Title 测试swagger
@Description 测试swagger
@Accept  json
@Param   limit    query    int64   false    "limit"
@Param   page     query    int64   false    "page"
@Resource test
@Router /test/swagger [GET]
*/
func HttpTestSwagger(ctx echo.Context) error {
    limit := ctx.QueryParam("limit")
    page := ctx.QueryParam("page")

    fmt.Println(limit, "  ", page)

    return helper.SuccessResponse(ctx, "")
}

执行swagger的生成文档命令，会生成swagger目录和文件

然后你就可以把访问地址执行生成的文档上就行了

Answer 2

beego也带这种注解式的swagger 文档生成，缺陷是路由只支持namespace那种形式的