开始前的准备

go get github.com/gin-gonic/gin

编码

构建main函数

main.go

package main

import (
   "fmt"
   "github.com/gin-gonic/gin"
)

func main() {
   router := gin.New()

   bootstrap.SetupRoute(router)

   err := router.Run(":3000")
   if err != nil {
      fmt.Println(err)
   }
}

我们会在bootstrap包中的SetupRoute()中初始化router，下面我们去完成这个函数

初始化router

bootstrap/route.go

package bootstrap

import (
   "github.com/gin-gonic/gin"
   "go-api-practice/routes"
   "net/http"
)

func SetupRoute(router *gin.Engine) {
   registerGlobalMiddleware(router)
   routes.RegisterAPIRoutes(router)
   setup404Handler(router)
}

func registerGlobalMiddleware(router *gin.Engine) {
   router.Use(
      gin.Recovery(),
      gin.Logger(),
   )
}

func setup404Handler(router *gin.Engine) {
   router.NoRoute(func(c *gin.Context) {
      c.JSON(http.StatusNotFound, gin.H{
         "error_code":    404,
         "error_message": "页面不存在",
      })
   })
}

registerGlobalMiddleware()

registerGlobalMiddleware(router *gin.Engine)，在这个函数中我们去注册需要使用的中间件，这里我们使用gin自带的中间件即可，此外setup404Handler(router *gin.Engine)设置了404时的返回结果。

gin.H

1 2	type H map[string]any type any = interface{}

可以看到gin.H是一个map[string]interface{}类型，借助于gin.H我们可以快速的构建想要返回的JSON数据

到这里我们就配置好了我们的gin.Engine，接下来我们在routes包下的api.go中注册路由

注册路由

routes/api.go

package routes

import (
   "github.com/gin-gonic/gin"
   "net/http"
)

func RegisterAPIRoutes(router *gin.Engine) {
   v1 := router.Group("/v1")

   v1.GET("/", func(c *gin.Context) {
      c.JSON(http.StatusOK, gin.H{
         "hello": "world",
      })
   })
}