Beego API自动化文档

  • routers > router.go

func init() {
    ns := beego.NewNamespace("/app",
        beego.NSNamespace("/模块",
            beego.NSInclude(
                &controllers.MyController{},
            ),
        ),
    )
    beego.AddNamespace(ns)
}
  • models > request.go > 接收结构体

type ReqStruct struct {
    BaseRequest
    ...         `description:"描述"`
}
  • models > ...

type MyStruct struct {
    ...         `description:"描述"`
}

func Function (interface{}) (interface{}) {
    o := orm.NewOrm()
    o.Using("...")
    ...
    return 
}
  • models > response.go > 返回结构体

type RespStruct struct {
    BaseResp
    MyStruct
    ...         `description:"描述"`
}
  • controllers > ...

type MyController struct {
    AppBaseController
}

// @Title   标题
// @Description 描述
// @Param   body    body    models.接受结构体   true
// @Success 200 {object}    models.返回结构体   请求成功
// @Failure 304 请求失败
// @router  /功能   [post]
func (this *MyController) Method() {
    req := models.ReqStruct{}
    resp := models.RespStruct{}
    json.Unmarshal(this.Ctx.Input.RequestBody, &req)
    defer this.ServeJSON()
    var err error
    // models.Function()
    if err != nil {
        resp.RetCode = 304
        resp.RetMsg = "请求失败"
        this.Data["json"] = resp
        return
    }
    resp.RetCode = 200
    resp.RetMsg = "返回成功"
    this.Data["json"] = resp
}
  • err

if err != nil && err != orm.ErrNoRows {
    log.Print("Error:", err)
    return
}
  • run

bee run -gendoc=true -downdoc=true

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值