Gin框架快速上手使用

最新推荐文章于 2024-09-08 08:28:41 发布

ydy0987

最新推荐文章于 2024-09-08 08:28:41 发布

阅读量265

点赞数 8

文章标签： gin

本文链接：https://blog.csdn.net/a1783760364/article/details/138182387

版权

本文介绍了如何在Go语言中使用Gin框架进行环境配置，包括设置镜像源，以及如何进行初步操作如创建实例、设置路由。还详细讲解了路由分组、JSON返回格式、Controller的设计和方法调用，以避免方法冲突。

摘要由CSDN通过智能技术生成

1 . 环境配置

1. Gin 下载使用镜像源

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

go get -u github.com/gin-gonic/gin

2 . 初步上手

package main

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

func main() {
    r := gin.Default() // 生成一个实例

    r.GET("/hello", func(context *gin.Context) {   // 设置路由
        context.String(http.StatusOK, "hello Gin")

    })
    r.Run(":9999") // 启动端口号
}

2 . 实操

1 . 路由 Router

// 多种路由方式
r.GET("/hello", func(context *gin.Context) {
    context.String(http.StatusOK, "hello Gin")
})
r.POST("/user/list", func(context *gin.Context) {
    context.String(http.StatusOK, "user list")
})
r.PUT("/user/put", func(context *gin.Context) {
    context.String(http.StatusOK, "user put")
})
r.DELETE("/user/delete", func(context *gin.Context) {
    context.String(http.StatusOK, "user delete")
})

路由分组

user := r.Group("/user")
{
    user.GET("/hello", func(context *gin.Context) {
        context.String(http.StatusOK, "hello Gin")

    })
    user.POST("/post", func(context *gin.Context) {
        context.String(http.StatusOK, "user post")
    })
    user.PUT("/put", func(context *gin.Context) {
        context.String(http.StatusOK, "user put")
    })
    user.DELETE("/delete", func(context *gin.Context) {
        context.String(http.StatusOK, "user delete")
    })
}

2 . 实现Json返回并统一返回数据格式

// JsonStruct 定义一个返回结果格式
type JsonStruct struct {
    Code  int         `json:"code"`
    Msg   interface{} `json:"msg"`
    Data  interface{} `json:"data"`
    Count int64       `json:"count"`
}

// ReturnSuccess 成功响应返回数据
func ReturnSuccess(c *gin.Context, code int, msg interface{}, data interface{}, count int64) {
    json := &JsonStruct{
        code, msg, data, count,
    }
    c.JSON(200, json)
}

// ReturnError 失败响应结果
func ReturnError(c *gin.Context, code int, msg interface{}) {
    json := &JsonStruct{
        Code: code, Msg: msg,
    }
    c.JSON(200, json)
}

3 . 实现控制器Controller

// controller 中实现方法
// 但是这种方式有一个弊端，多个Controller 中如果有相同的方法就会报错，所以我们可以使用一个结构体来维护这些方法
func GetUserInfo(c *gin.Context) {
    ReturnSuccess(c, 200, "ydy", "2024-8-12", 1)
}

// 在router中调用方法
user.GET("/hello", controllers.GetUserInfo) /// 直接调用 Controller中实现的方法


// 结构体定义
type UserController struct {
}

func (u UserController) GetUserInfo(c *gin.Context) {
    ReturnSuccess(c, 200, "ydy", "2024-8-12", 1)
}

func (u UserController) GetUserList(c *gin.Context) {
    ReturnError(c, 200, "信息不存在")
}

// 通过上面这个方式就可以避免多个Controller之间的方法冲突
// 调用方式：
user.GET("/hello", controllers.UserController{}.GetUserInfo) /// 直接调用 Controller中实现的方法
user.POST("/post", controllers.UserController{}.GetUserList)