golang+gin实现api接口开发

一、简介:

Gin是Go语言的一个微框架,也是是一个用 Go (Golang) 编写的 HTTP Web 框架,封装比较优雅,API相对友好。Gin具有性能优异和灵活快速等优点。它具有类似 Martini 的 API,但性能比 Martini 快 40 倍。并且支持中间件、Crash 处理、JSON 验证、路由组、错误管理、内置渲染、可扩展性等....

二、Gin安装

复制代码
$ go get -u github.com/gin-gonic/gin

引用方式:

复制代码
import "github.com/gin-gonic/gin"

三、使用Gin实现http服务器

复制代码
package main

import "github.com/gin-gonic/gin"

func main() {
  router := gin.Default()
  router.GET("/hello", func(c *gin.Context) {
    c.JSON(200, gin.H{
      "message": "heelo world!",
    })
  })
  router.Run()//默认127.0.0.1:8080上启动服务
}

直接先运行

复制代码
go mod tidy
//再执行
go run main.go

启动程序

这样则表示调用成功。

四、路由和控制器

复制代码
router.GET("/account/:name",func(c *gin.Context){
    name:=c.Param("name")
    c.String(http.StatusOK, "hello %s", name)
})

注⚠️:冒号":"加上一个参数组成路由参数,而且可以使用c.Param方法都去值。

http请求方法:常用的http请求方法有下面4种:GET、POST、PUT、DELETE

带星号* 模糊匹配参数的url路径

星号代表匹配任意路径的意思, 必须在*号后面指定一个参数名,后面可以通过这个参数获取*号匹配的内容。

复制代码
router.GET("/account/:name/*act",func(c *gin.Context){
    name:=c.Param("name")
    act := c.Param("act")
    msg := name+" is "+ act
    c.String(http.StatusOK, "hello %s", msg)
})

五、Gin中间件

例如我们设定了一个AuthMiddle权限中间件

我们就可以在接口中这么写

复制代码
router.GET("/account",AuthMiddle(),func(c *gin.Context){
    name:=c.Param("name")
    c.String(http.StatusOK, "hello %s", name)
})

这样可以实现横切关注点问题,通常对于记录Log,error handler和接口鉴权等问题。

六、路由

比如:

复制代码
//实例化gin实例
r := gin.Default()
//post请求
r.POST("/account", SendUser)
//get请求:
r.GET("/account/:id", GetUserInfo)
//put请求
r.PUT("/account/:id", UpdateUser)
//delete请求
r.DELETE("/account/:id", DelUser)

分组管理

复制代码
r := gin.Default()
apiv1 := r.Group("/api/v1")
apiv1.Use(jwt.JWT())
{
      apiv1.GET("/tags", v1.GetTags)
      apiv1.POST("/tags", v1.AddTag)
      apiv1.PUT("/tags/:id", v1.EditTag)
      apiv1.DELETE("/tags/:id", v1.DelTag)
}

结尾:

学习永无止境,有喜欢学习golang的朋友,具体可以参考官方文档进一步学习Gin这个Web框架。
Gin官方文档gin-gonic.com/zh-cn/docs/introduction/

相关推荐
利威尔xu1 天前
Go Mutex 饥饿模式:正常模式等待者饿死,1ms 阈值自动切换崩溃
开发语言·后端·面试·golang·并发编程
利威尔xu2 天前
Go channel 关闭 3 个 panic:向已关闭 channel 发送,服务当场崩溃
开发语言·后端·golang·并发编程·channel
Java展博2 天前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang
联犀3 天前
ai时代复杂项目的golang项目如何更好的与ai共舞:monorepo+gozero
开发语言·人工智能·golang
codeejun3 天前
每日一Go·MySQL-15、慢查询日志实战分析(从 0 到 1 实战排查慢 SQL)
sql·mysql·golang
程序员Query6 天前
day01-认识Go语言 + golang环境的安装
开发语言·后端·golang
喵了几个咪7 天前
GoWind Flow 拆解:一个 Go 工作流引擎与它的双模式设计器
开发语言·人工智能·后端·golang
codeejun7 天前
每日一Go·MySQL-14、慢 SQL 产生原因全解
sql·mysql·golang
利威尔xu10 天前
Go map 底层崩溃:3 个 goroutine 并发写同一张 map,fatal error 崩掉整个服务
golang·源码·map·并发·后端开发
利威尔xu11 天前
2026-11-08-Go-defer-panic-recover面试
面试·golang