最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

Golang使用Swagger文檔教程詳解

 更新時間:2023年12月05日 10:22:38   作者:斷問天  
這篇文章主要為大家詳細介紹Golang使用Swagger文檔教程的相關知識,文中通過示例代碼講解詳細,具有一定的借鑒價值,感興趣的小伙伴可以學習一下

Golang開發(fā)效率是杠杠滴,簡單幾行代碼就可完成一個可用的服務,如下代碼:

  • 采用Gin作為web framework
  • 采用Gorm作為持久化ORM
  • 采用Swagger作為OpenAPI文檔管理工具
package main
 
import (
	"encoding/csv"
	"fmt"
	"os"
	"strconv"
	"time"
 
	_ "export/docs"
 
	"github.com/gin-gonic/gin"
	swaggerFiles "github.com/swaggo/files"
	ginSwagger "github.com/swaggo/gin-swagger"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
 
type Detail struct {
	Id        int
	Name      string
	FirstTime time.Time
	LastTime  time.Time
}
 
// @title NeoApi Swagger 標題
// @version 1.0 版本
// @description NeoApi Service 描述
// @BasePath /api  基礎路徑
// @query.collection.format multi
func main() {
	r := gin.Default()
	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
	r.GET("/api/export", export)
	r.POST("/api/data", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "success",
		})
	})
	r.Run("0.0.0.0:9527")
}
 
// @Summary 導出數(shù)據
// @Description 導出數(shù)據
// @Accept json
// @Produce json
// @Success 200 string string "success"
// @Router /api/export [get]
func export(c *gin.Context) {
	dsn := "dev:123456@tcp(192.168.1.203:33306)/menshen?charset=utf8mb4&parseTime=true"
	db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	if err != nil {
		panic("failed to connect database")
	}
 
	var persons []uint
	db.Raw("select id from person").Scan(&persons)
	fmt.Println(persons)
 
	month := 3
	monthFile := "08.csv"
	csvfile, err := os.Create(monthFile)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	defer csvfile.Close()
 
	for _, id := range persons {
		var data []Detail
		// 注意 Gorm 字段映射默認嚴格駝峰命名,否則取不到值
		db.Raw(`select s.person_id as id, s.person_name as name, min(s.origin_time) as first_time, max(s.origin_time) as last_time from (
		select person_id, person_name, origin_time, date_format(origin_time, '%d') as day FROM event_record
		where person_id=? and primary_type=100 and PERIOD_DIFF(date_format(now( ), '%Y%m'), date_format(origin_time, '%Y%m'))=?) s group by s.day
	  `, id, month).Scan(&data)
 
		writer := csv.NewWriter(csvfile)
		for _, da := range data {
			record := []string{strconv.Itoa(da.Id), da.Name, da.FirstTime.Format("2006-01-02 15:04:05"), da.LastTime.Format("2006-01-02 15:04:05")}
			err := writer.Write(record)
			if err != nil {
				fmt.Println("Error:", err)
				return
			}
		}
		writer.Flush()
	}
 
	c.JSON(200, gin.H{
		"message": "export success",
	})
}

簡單介紹一下Swagger的使用。

首先導入swagger相關的包

	swaggerFiles "github.com/swaggo/files"
	ginSwagger "github.com/swaggo/gin-swagger"
 
	_ "export/docs"
  • swaggerFiles和ginSwagger是swaggo庫提供
  • export/docs是swag命令生成的本地API文檔源代碼(export是我的項目名稱),在golang里面只需要docs.go,如下:

其次,想要生成swagger文檔也非常簡單,

  • 安裝swag命令行工具:go get github.com/swaggo/swag/cmd/swag@v1.8.12
  • 編寫項目的swagger注釋文檔
  • 執(zhí)行生成命令:swag init 在項目docs目錄下生成相關文件

然后,為swagger注冊gin路由

	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))

最后,啟動服務,訪問地址:Swagger UI 即可,如果想查看json格式的文檔,可訪問地址:localhost:9527/swagger/doc.json

以上就是Golang使用Swagger文檔教程詳解的詳細內容,更多關于Golang使用Swagger文檔的資料請關注腳本之家其它相關文章!

相關文章

  • Go語言中println和fmt.Println區(qū)別

    Go語言中println和fmt.Println區(qū)別

    本文主要介紹了Go語言中println和fmt.Println區(qū)別,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
    2023-07-07
  • Go語言輸出函數(shù)使用詳解

    Go語言輸出函數(shù)使用詳解

    這篇文章主要介紹了Go語言輸出函數(shù)使用詳解的相關資料,需要的朋友可以參考下
    2023-08-08
  • Go?time包AddDate使用解惑實例詳解

    Go?time包AddDate使用解惑實例詳解

    這篇文章主要為大家介紹了Go?time包AddDate使用解惑實例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2022-09-09
  • 詳解Go語言如何進行Http調用

    詳解Go語言如何進行Http調用

    無論是微服務還是單體架構等,服務間都有相互通信的時候,而最直接的通信方法就是 HTTP 調用,本文將會介紹在 Go 語言里,如何進行 HTTP 調用,需要的可以參考一下
    2022-12-12
  • Go語言自帶測試庫testing使用教程

    Go語言自帶測試庫testing使用教程

    這篇文章主要為大家介紹了Go語言自帶測試庫testing使用教程,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2022-07-07
  • 深入理解Go中rune類型的使用

    深入理解Go中rune類型的使用

    本文主要介紹了深入理解Go中rune類型的使用,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
    2026-02-02
  • 重學Go語言之變量與常量的聲明與使用詳解

    重學Go語言之變量與常量的聲明與使用詳解

    變量、常量的聲明與使用是掌握一門編程語言的基礎,在這篇文章中,小編就來帶大家學習一下Go語言是怎么樣聲明和使用變量與常量吧
    2023-03-03
  • 通過Golang實現(xiàn)無頭瀏覽器截圖

    通過Golang實現(xiàn)無頭瀏覽器截圖

    在Web開發(fā)中,有時需要對網頁進行截圖,以便進行頁面預覽、測試等操作,本文為大家整理了Golang實現(xiàn)無頭瀏覽器的截圖的方法,感興趣的可以了解一下
    2023-05-05
  • golang組件swagger生成接口文檔實踐示例

    golang組件swagger生成接口文檔實踐示例

    這篇文章主要為大家介紹了golang組件swagger生成接口文檔實踐示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步早日升職加薪
    2022-04-04
  • go code review 代碼調試

    go code review 代碼調試

    這篇文章主要為大家介紹了go code review 代碼調試方法詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2022-11-11

最新評論

白银市| 平凉市| 辽宁省| 湖州市| 延津县| 北流市| 华亭县| 亚东县| 双辽市| 岢岚县| 民勤县| 内乡县| 新泰市| 鸡西市| 朝阳市| 深泽县| 本溪| 手游| 喀什市| 绥阳县| 屏东县| 巴中市| 泾阳县| 清河县| 巴林右旗| 揭西县| 沛县| 郯城县| 石渠县| 罗城| 麻城市| 荔波县| 灵武市| 宁蒗| 荣成市| 赤壁市| 江西省| 牙克石市| 中阳县| 疏勒县| 阳东县|