go-swagger标准接口暴露

添加依赖

	github.com/gin-gonic/gin v1.11.0github.com/swaggo/files v1.0.1github.com/swaggo/gin-swagger v1.6.1github.com/swaggo/swag v1.16.6

定义返回值

package responsetype ResultVO struct {Code    int         `json:"code"`              //错误码Message string      `json:"message,omitempty"` //错误信息Data    interface{} `json:"data,omitempty"`    //返回的数据
}type UserVO struct {ID    int    `json:"id"`    // IDName  string `json:"name"`  // 用户姓名Email string `json:"email"` // 邮箱
}

定义参数

package paramtype UserParam struct {ID    int    `json:"id"`    // IDName  string `json:"name"`  // 用户姓名Email string `json:"email"` // 邮箱
}

创建controller

package controllerimport ("github.com/gin-gonic/gin"
)type UserController struct {
}func NewUserController() *UserController {return &UserController{}
}// @Summary 获取用户信息
// @Description 获取用户详细信息
// @Accept json
// @Produce json
// @Param id query int64 true "用户id"
// @Success 200 {object} response.ResultVO{data=response.UserVO}
// @Router /user/get [get]
func (u *UserController) GetUser(c *gin.Context) {}// @Summary 添加用户信息
// @Description 添加用户信息
// @Accept json
// @Produce json
// @Param user body param.UserParam true "用户信息"
// @Success 200 {object} response.ResultVO{data=response.UserVO}
// @Router /user/add [post]
func (u *UserController) AddUser(c *gin.Context) {}// @Summary 分页获取用户信息
// @Description 分页获取用户信息
// @Accept json
// @Produce json
// @Param pageSize query int64 true "一页几条"
// @Param current query int64 true "当前页"
// @Success 200 {object} response.ResultVO{data=[]response.UserVO}
// @Router /user/list [get]
func (u *UserController) ListUser(c *gin.Context) {}

初始化swagger文件

swag init

启动服务

package mainimport ("swagger_test/controller"_ "swagger_test/docs" //之前使用swag init 生成的swagger文档的路径"github.com/gin-gonic/gin"swaggerFiles "github.com/swaggo/files"ginSwagger "github.com/swaggo/gin-swagger"
)func main() {r := gin.Default()r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))userController := controller.NewUserController()r.GET("/user/get", userController.GetUser)r.POST("/user/add", userController.AddUser)r.GET("/user/list", userController.ListUser)r.Run(":8080")
}

访问接口

http://127.0.0.1:8080/swagger/index.html#/default