Beego是一个快速开发Go语言Web应用程序的Web框架，它提供了许多特性和工具来简化开发流程。这些特性和工具包括支持Swagger（一种API文档生成工具）和Postman（一种API测试工具），两者都可以让开发人员方便地管理和测试API，本文将介绍如何在Beego中使用Swagger并结合Postman进行API测试。
一、安装Swagger
Swagger是一种开源框架，用于设计、构建、文档化和测试RESTful Web服务。通过Swagger，你可以在动态生成的API文档中查看每个API方法的请求和响应。
首先，你需要安装Swagger。输入以下命令：
go get -u github.com/swaggo/swag/cmd/swag
安装完毕后，再次输入以下命令：
swag init
这将在你的Beego应用程序的根目录下生成一个docs文件夹，其中包含生成的Swagger文档。
二、集成Swagger到Beego
接下来，你需要集成Swagger到Beego中。要做到这一点，你需要在你的main.go文件中引入swagger和beego / context依赖项。
import(
"github.com/astaxie/beego"
"github.com/astaxie/beego/context"
_ "your-app-doc-path/docs"
)
现在，在你的main.go文件的init（）函数中添加以下代码：
func main() {
if beego.BConfig.RunMode == beego.DEV {
beego.BConfig.WebConfig.DirectoryIndex = true
beego.BConfig.WebConfig.StaticDir["/swagger"] = "swagger"
// 添加路由，可以自定义，这里设置为/swagger
beego.InsertFilter("/*", beego.BeforeRouter, func(ctx *context.Context) {
ctx.Output.Header("Access-Control-Allow-Origin", "*")
ctx.Output.Header("Access-Control-Allow-Headers", "Content-Type,Token")
ctx.Output.Header("Access-Control-Allow-Methods", "POST,GET")
})
}
// 注册Swagger路由
beego.BConfig.WebConfig.StaticDir["/docs"] = "docs"
beego.BeeApp.Handlers.Get("/docs/*", func(ctx *context.Context) {
ctx.Output.Header("Content-Type", "text/html;charset=utf-8")
ctx.Output.Body(swaggerFiles.Index)
})}
这个代码将在你的应用根目录下创建一个swagger文件夹，用于存放Swagger UI文件。在Beego初始化时，Swagger UI目录将被注册为一个静态路由。因为Swagger UI是一组静态HTML、CSS和JavaScript文件，所以它们是从静态资源目录访问的。
你需要通过输入以下URL在浏览器中打开Swagger UI：
http://localhost:[port]/docs/index.html
这里，请自行替换[port]为你的服务器端口号。
三、编写Swagger注释
在集成Swagger之后，现在你需要为你的API编写Swagger注释。可以通过以下方式来执行：
首先，创建一个文件swagger.go，然后添加以下代码：
package controllers
/* 运算类别
*/
// swagger:parameters add sub
type Operands struct {
// The first operand
// in: path
// required: true
A int `json:"a"`
// The second operand
// in: path
// required: true
B int `json:"b"`
}
/* 返回结果
*/
// swagger:response OperResult
type OperandsResultWrapper struct {
// in:body
Body struct {
// 运算结果
Result int `json:"result,omitempty"`
}}
/ 相加 /
// swagger:route GET /add/{a}/{b} add
//
// 用于相加
//
// 支持的谓词: GET
// 参数:
// + A: (path) - first operand(只能为整数)
// + B: (path) - second operand (只能为整数)
// 接受内容:
// Produces:
// + 返回结果 (application/json)
// + 错误 (application/json)
//
// swagger:parameters add
// swagger:response OperResult
func (o *OperationController) Add() {
// ...
}
在这里，我们定义了Swagger注释来描述API的请求和响应。注释使用Swagger的语法来描述路由规则、命令参数和结果类型。具体来说：
- 运算类别（参数类型）描述了传递给API
.........................................................