Golang | Gin（简洁版）

安装使用

• Gin 是一个 golang 的微框架，封装比较优雅，API 友好，源代码比较明确。具有快速灵活，容错方便等特点。其实对于 golang 而言，web 框架的依赖远比 python，java 之类的要小。自身的 net/http 足够简单，性能也非常不错。框架更像是一个常用函数或者工具的集合。借助框架开发，不仅可以省去很多常用的封装带来的时间，也有助于团队的编码风格和形成规范。
• Gin 官方文档地址：https://gin-gonic.com/zh-cn.docs
• 安装 Gin：

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

• 在 windows 10 系统中，安装 Go1.19 之后的版本，然后打开 go module，在命令行终端中输入：go env -w GO111MODULE=on
• 修改指定的代理，在命令行终端中输入：go env -w GOPROXY=https:/lgoproxy.io,direct

package main

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

func main() {
	// 创建一个服务
	ginServer := gin.Default()

	// 为网页标签导入一个icon
	ginServer.Use(favicon.New("path/to/your/icon"))

	// 连接数据库的代码
	
	// 访问地址，处理请求 Request Response
	ginServer.GET("/hello", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "Hello World!"})
	})
	// gin.H 其实就是一个 map[string]any
	
	// 服务器端口
	ginServer.Run(":8082")
}

RESTful API

• RESTful API（Representational State Transfer API）是一种基于REST架构风格的网络应用编程接口，它通过HTTP协议进行通信，常用于Web服务的实现。RESTful API遵循一些基本的设计原则，使得服务更加灵活、简单和易于维护。
• REST的核心思想是通过定义资源（Resource）并通过HTTP动词（GET、POST、PUT、DELETE等）对资源进行操作。

// 以前写网站
get /user
post /create_user
post /update_user
post /delete_user

// RESTful API
get /user
post /user
put /user
delete /user

• GET：获取资源，不修改服务器上的数据。
• POST：创建新的资源，通常用于提交数据。
• PUT：更新资源，用于替代现有资源。
• DELETE：删除资源。
• PATCH：部分更新资源。

	// 访问地址，处理请求 Request Response
	// Gin RestFul 十分简单
	ginServer.GET("/hello", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "Hello World!"})
	})
	ginServer.POST("/user", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "Post user"})
	})
	ginServer.PUT("/user", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "Put user"})
	})
	ginServer.DELETE("/user", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "Delete user"})
	})

响应页面

	// 加载静态页面(全局加载)
	ginServer.loadHTMLGlob("templates/*")
	
	// 加载资源文件
	gin.Server.Static("./static","./static")

	// 响应一个页面给前端
	ginServer.GET("/index", func(context *gin.Context) {
		// context.JSON()  json数据
		context.HTML(http.StatusOK, "index.html", gin.H{
			"msg":"This is the data form server."
		})
		//  前端用 {{.msg}} 赋值表达式即可取出
	})

获取请求参数

• url?userid=1&username=z3，url传参方式

	ginServer.GET("/user/info", func(context *gin.Context) {
		userid := context.Query("userid")
		username := context.Query("username")
		context.JSON(http.StatusOK, gin.H {
			"userid":userid,
			"username":username,
		})
	})

• url/user/info/1/z3，RestFul风格请求参数

	// :就可以直接取出这个值了
	ginServer.GET("/user/info/:userid/:username", func(context *gin.Context) {
		userid := context.Param("userid")
		username := context.Param("username")
		context.JSON(http.StatusOK, gin.H {
			"userid":userid,
			"username":username,
		})
	})

	// 前端给后端传递 json
	ginServer.GET("/json", func(context *gin.Context) {
		// request.body
		b, _ := context.GetRawData()
		var m map[string]interface{}
		// 返回的是byte切片，包装为json数据
		_ = json.Unmarshal(b, &m)
		context.JSON(http.StatusOK, m)
	})
	
	// 处理表单
	ginServer.GET("/user/add", func(context *gin.Context) {
		username := context.PostForm("username")
		password := context.PostForm("password")
		
		// 校验逻辑，略
		
		context.JSON(http.StatusOK, gin.H {
			"msg":"ok",
			"username":username,
			"password":password,
		})
	})

路由讲解

	ginServer.GET("/json", func(context *gin.Context) {
		// 重定向
		context.Redirect(http.StatusMovedPermanently, "https://www.4399.com")
	})

	// 404 NoRoute
	ginServer.NoRoute(func(context *gin.Context) {
		context.Redirect(http.StatusNotFound, "404.html", nil)
	})

	// 路由组
	userGroup := ginServer.Group("/user"){
		userGroup.POST("/add", func)
		userGroup.POST("/login", func)
		userGroup.POST("/logout", func)
	}
	orderGroup := ginServer.Group("/order"){
		orderGroup.POST("/add", func)
		orderGroup.DELETE("/delete", func)
	}

中间件

	// go中间件可以进行预处理，登录授权、验证、分页等

	// 自定义go中间件 拦截器
	func myHandler() (gin.HandlerFunc) {
		return func(context *gin.Context) {
			// 通过自定义的中间件，设置的值在后续处理只要调用了这个中间件都可以拿到这里的值
			context.Set("usersession", "userid-1")
			if condition {
				context.Next() // 放行
			} else {
				context.Abort() // 阻止
			}
		}
	}


	ginServer.GET("/user/info", myHandler(), func(context *gin.Context) {
		// 取出中间件中的值
		usersession := context.MustGet("userSession").(string)
		log.Println("userSession", usersession)

		userid := context.Query("userid")
		username := context.Query("username")
		context.JSON(http.StatusOK, gin.H {
			"userid":userid,
			"username":username,
		})
	})