Gin 框架入门实战系列教程

一，Gin介绍

Gin是一个 Go (Golang) 编写的轻量级 http web 框架，运行速度非常快，如果你是性能和高效的追求者，我们推荐你使用Gin框架。

Gin最擅长的就是Api接口的高并发，如果项目的规模不大，业务相对简单，这个时候我们也推荐你使用 Gin.

当某个接口的性能遭到较大挑战的时候，这个还是可以考虑使用Gin重写接口。

Gin 也是一个流行的 golang Web 框架，Github Start 量已经超过了50k.

Gin的官网：

Gin的官网：
https://gin-gonic.com/zh-cn/
Gin Github地址：
https://github.com/gin-gonic/gin

二，Gin环境搭建

要安装 Gin 软件包，需要先安装 Go并设置 Go 工作区。

1，下载并安装 gin:

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

https://github.com/gin-gonic/gin
go install github.com/gin-gonic/gin@latest
go mod init gindemo01
go mod init Administrator
go mod tidy
go get -u github.com/gin-gonic/gin

2，将 gin 引入到代码中:

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

3，(可选) 如果使用诸如 http.StatusOK之类的常量，则需要引入 net/http 包：

import "net/http"

4，新建 Main.go 配置路由

package main
import main() {
	// 创建一个默认的路由引擎
	r := gin.Default()
	// 配置路由
	r.GET("/",func(c *gin.Context) {
		c.JSON(200,gin.H{ // c.JSON：返回JSON格式的数据
			"message":"Hello world!",
		})
	})
	// 启动 HTTP 服务，默认在 0.0.0.0:8080 启动服务
	r.Run()
}

5，运行你的项目

go run main.go



PS G:\GO\gin\gindemo01> go run main.go
[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.

[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:   export GIN_MODE=release
 - using code:  gin.SetMode(gin.ReleaseMode)

[GIN-debug] GET    /                         --> main.main.func1 (3 handlers)
[GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080
[GIN] 2025/01/06 - 10:29:16 | 200 |   548.6µs |   ::1 | GET      "/"
[GIN] 2025/01/06 - 10:29:16 | 404 |   0s |  ::1 | GET    "/favicon.ico"
[GIN] 2025/01/06 - 10:32:48 | 404 |   0s |  ::1 | GET      "/new"
// 改完代码以后要重新运行
[GIN-debug] Listening and serving HTTP on :8080
[GIN] 2025/01/06 - 10:34:50 | 200 |  0s |          ::1 | GET      "/"
[GIN] 2025/01/06 - 10:34:53 | 200 |  0s |          ::1 | GET      "/new"

6，要改变默认启动的端口

r.Run(":9000")

如果 go get 失败请参考：

http://bbs.itying.com/topic/Sed08edee7c0790f8475e276

三，golang程序的热加载

所谓热加载就是当我们对代码进行修改时，程序能够自动重新加载并执行，这在我们开发中是非常便利的，可以快速进行代码测试，省去了每次手动重新编译

beego中我们可以使用官方给我们提供的bee工具来热加载项目，但是gin中并没有官方提供的热加载工具，这个时候我们要实现热加载就可以借助第三方的工具。

工具1 (推荐)

https://github.com/gravityblast/fresh

go install github.com/gravityblast/fresh@latest

go get github.com/pilu/fresh

G:/GO/gin_demo>fresh

工具2：

https://github.com/codegangsta/gin

go get -u github.com/codegangsta/gin

G:/GO/gin_demo>gin run main.go

四，Gin框架中的路由

4.1，路由概述

路由 (Routing) 是由一个 URI (或者叫路径) 和一个特定的 HTTP方法(GET,POST等)组成的，涉及到应用如何响应客户端对某个网站节点的访问。

RESTful API 是目前比较成熟的一套互联网应用程序的API设计理论，所以我们设计我们的路由的时候建议参考 RESTful API 指南。

在 RESTful 架构中，每个网址代表一种资源，不同的请求方式表示执行不同的操作：

GET(SELECT)	从服务器取出资源(一项或多项)
POST(CREATE)	在服务器新建一个资源
PUT(UPDATE)	在服务器更新资源(客户端提供改变后的完整资源)
DELETE(DELETE)	从服务器删除资源

4.2，简单的路由配置

简单的路由配置(可以通过 postman 测试)

当用GET请求访问一个网址的时候，做什么事情：

路由配置实践：

package main

import (
	"net/http"

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

func main() {
	// 创建一个默认的路由引擎
	r := gin.Default()
	// 配置路由 绑定路由规则，执行的函数
	r.GET("/", func(c *gin.Context) {
		c.String(http.StatusOK, "值:%v", "您好gin")
	})

	r.GET("/news", func(c *gin.Context) {
		c.String(http.StatusOK, "我是新闻页面 111")
	})

	// r.GET("/about", func(c *gin.Context) {
	// 	c.String(200, "我是关于页面 222")
	// })

	// r.GET("/login", func(c *gin.Context) {
	// 	c.String(200, "这是一个登录页面")
	// })

	// r.GET("/register", func(c *gin.Context) {
	// 	c.String(200, "这是一个注册页面")
	// })

	// r.GET("/user/:name", func(c *gin.Context) {
	// 	name := c.Param("name")
	// 	c.String(200, "这是一个用户页面 %s", name)
	// })

	// r.GET("/user/:name/:age", func(c *gin.Context) {
	// 	name := c.Param("name")
	// 	age := c.Param("age")
	// 	c.String(200, "这是一个用户页面 %s %s", name, age)
	// })

	// r.GET("/user/:name/*action", func(c *gin.Context) {
	// 	name := c.Param("name")
	// 	action := c.Param("action")
	// 	c.String(200, "这是一个用户页面 %s %s", name, action)
	// })

	// r.GET("/favicon.ico", func(c *gin.Context) {
	// 	c.String(200, "这是一个图标页面")
	// })

	// r.GET("/favicon.ico", func(c *gin.Context) {
	// 	c.String(200, "这是一个图标页面2")
	// })

	r.POST("/add", func(c *gin.Context) {
		c.String(http.StatusOK, "这是一个post请求 主要用于增加数据")
		// c.JSON(200, gin.H{
		// 	"name": "小明",
		// })
	})

	r.PUT("/edit", func(c *gin.Context) {
		c.String(http.StatusOK, "这是一个put请求 主要用于编辑数据")
	})

	r.DELETE("/delete", func(c *gin.Context) {
		c.String(http.StatusOK, "这是一个delete请求 主要用于删除数据")
	})
	//启动一个web服务 监听并在 0.0.0.0:8080 上
	r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
	//r.Run(":8000") // 指定端口启动服务
}

4.3，c.String() c.JSON() c.JSONP() c.XML() c.HTML()

返回一个字符串

r.GET("/news",fnuc(c *gin.Context) {
	aid := c.Query("aid")
	c.String(200,"aid=%s",aid)
})

返回一个 JSON 数据

func main() {
	r := gin.Default()
	
	// gin.H 是 map[string]interface{}的缩写
	r.GET("/someJSON", func(c *gin.Context) {
		// 方式一: 自己拼接JSON
		c.JSON(http.StatusOK,gin.H{"message": "Hello world!"})
	})
	r.GET("/moreJSON",func(c *gin.Context) {
		// 方式二：使用结构体
		var msg struct {
			Name string `json:"user"`
		}
	})
}

新建项目实践：