[raw]swagger笔记

• Z时代
• 2024-01-10
• 分类：综合

import (
	_ "sisyphus/docs"          // 自动生成swag文件位置
	"github.com/swaggo/gin-swagger"
	"github.com/swaggo/gin-swagger/swaggerFiles"
)
// 使用gin路由 gin.engine
engine.GET("/swagger/*any",ginSwagger.WrapHandler(swaggerFiles.Handler))

• 编写注释

// @title Golang 
// @version 1.0
// @description An example
// @termsOfService https://github.com/
// @license.name MIT
// @license.url https://github.com//LICENSE
func main(){
  ...
}
// @Summary Get multiple article tags
// @Produce  json
// @Param name query string false "Name"
// @Param state query int false "State"
// @Success 200 {object} app.Response
// @Failure 500 {object} app.Response
// @Router /api/v1/tags [get]
func GetTag(c*gign.Context){
  ...
}

• 生成并访问

swag init
go run main.go
//web: http://127.0.0.1:8080/swagger/index.html

以上是 [raw]swagger笔记 的全部内容， 来源链接： utcz.com/z/513329.html