Gin简介
Gin是一个golang的微框架，基于httprouter，封装比较优雅，API友好，源码注释比较明确，具有快速灵活，容错方便等特点
Gin特征
速度快：基于基数树的路由，内存占用小，没有反射，可预测的APi性能
中间件支持
传入的http请求可以有中间件链和最终操作处理，例如：Logger，Authorization，GZip最后在Db中发布以条消息
Crash-free
Gin可以捕获Http请求期间发生的panic并恢复它，这样你的服务器始终都可用
JSON验证
Gin可以解析和验证请求的JSON——例如，检查所需的值是否存在
路由分组
更好的组织您的路线，需要授权与不需要授权，不同的API版本，此外，组可以无限嵌套，而不会降低性能
错误管理
Gin提供了一种方便的方法用来收集HTTP请求期间发生的所有错误，最终 ，中间件可以将它们写入日志，数据并通过网络发送他们
内置渲染
GIn为JSon，XML，HTML渲染提供了简单易用·的API
可扩展
创建一个新的中间件非常简单，只需要查看实例代码就可以
第一个Gin
安装Gin
go get -u github.com/gin-gonic/gin
导入项目
import"github.com/gin-gonic/gin"
实现代码
package main
import"github.com/gin-gonic/gin"funcmain(){
r := gin.Default()
r.GET("/ping",func(c *gin.Context){
c.JSON(200, gin.H{"message":"pong",})})
r.Run()// listen and serve on 0.0.0.0:8080}
Gin实现用户登录
实现步骤
创建一个文件templates
在项目根目录下边创建文件夹templtes，用来保存静态文件
创建一个登录的html文件
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Login</title></head><body><form action="/login" method="post">
Username:<input type="text" name="username"><br>
Password:<input type="password" name="password"><br><input type="submit" value="Login"></form></body></html>
创建一个欢迎html页面
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Welcome</title></head><body>
Welcome,{{.username}}</body></html>
使用Gin处理逻辑
package main
import"github.com/gin-gonic/gin"funcMyHandler(c *gin.Context){
c.JSON(200, gin.H{"hello":"hello world",})}funcLogin(c *gin.Context){
c.HTML(200,"login.html",nil)}funcDoLogin(c *gin.Context){
username := c.PostForm("username")
password := c.PostForm("password")
c.HTML(200,"welcome.html", gin.H{"username": username,"password": password,})}funcmain(){
e := gin.Default()
e.LoadHTMLGlob("templates/*")
e.GET("/login", Login)
e.POST("/login", DoLogin)
e.Run()}
使用Gin请求参数
Get请求参数
使用c.Query(“key”),或者c.DefaultQuery（”key”）方法
package main
import"github.com/gin-gonic/gin"funcTestQueryString(c *gin.Context){
username := c.Query("username")
site := c.DefaultQuery("site","www.duoke360.com")
c.String(200,"username:%s, site:%s", username, site)}funcmain(){
e := gin.Default()// url : http://localhost:8080/testQueryString?username=郭宏志&site=多课网
e.GET("/testQueryString", TestQueryString)
e.Run()}
Gin数据绑定
绑定Form表单
package main
import("github.com/gin-gonic/gin")type User struct{
Username string`form:"username"`
Password string`form:"password"`
Hobby []string`form:"hobby"`
Gender string`form:"gender"`
City string`form:"city"`}funcRegsiter(c *gin.Context){var user User
c.ShouldBind(&user)
c.String(200,"User:%s", user)}funcGoRegister(c *gin.Context){
c.HTML(200,"register.html",nil)}funcmain(){
e := gin.Default()
e.LoadHTMLGlob("templates/*")
e.POST("/register", Regsiter)
e.GET("/register", GoRegister)
e.Run()}
绑定查询参数
package main
import("log""github.com/gin-gonic/gin")type User struct{
Username string`form:"username"`
Password string`form:"password"`}funcTestGetBind(c *gin.Context){var user User
err := c.ShouldBind(&user)if err !=nil{
log.Fatal(err)}
c.String(200,"User:%s", user)}funcmain(){
e := gin.Default()// http://localhost:8080/testGetBind?username=ghz&password=123
e.GET("/testGetBind", TestGetBind)
e.Run()}
绑定路径请求参数
package main
import("log""github.com/gin-gonic/gin")type User struct{
Username string`uri:"username"`
Password string`uri:"password"`}funcTestGetBind(c *gin.Context){var user User
err := c.ShouldBindUri(&user)if err !=nil{
log.Fatal(err)}
c.String(200,"User:%s", user)}funcmain(){
e := gin.Default()// http://localhost:8080/testGetBind/ghz/123
e.GET("/testGetBind/:username/:password", TestGetBind)
e.Run()}
GIN 访问静态文件集成BootStrap框架
下载bootstrap
下载地址：
https://getbootstrap.com/
添加bootstrap css 和js 文件
创建一个assets文件夹 将 css和js文件添加到该文件夹中
创建html文件
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><link rel="stylesheet" href="/assets/css/bootstrap.min.css"><title>Login</title></head><body><div class="container"><form><div class="mb-3"><label for="exampleInputEmail1" class="form-label">Email address</label><input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp"><div id="emailHelp" class="form-text">We'll never share your email with anyone else.</div></div><div class="mb-3"><label for="exampleInputPassword1" class="form-label">Password</label><input type="password" class="form-control" id="exampleInputPassword1"></div><div class="mb-3 form-check"><input type="checkbox" class="form-check-input" id="exampleCheck1"><label class="form-check-label"for="exampleCheck1">Check me out</label></div><button type="submit" class="btn btn-primary">Submit</button></form></div></body></html>
go code
package main
import("net/http""github.com/gin-gonic/gin")funcLogin(c *gin.Context){
c.HTML(200,"login.html",nil)}funcmain(){
e := gin.Default()
e.LoadHTMLGlob("templates/*")
e.Static("/assets","./assets")
e.StaticFS("/croot", http.Dir("c:/"))
e.StaticFile("/favicon.ico","./assets/favicon.ico")
e.GET("/login", Login)
e.POST("/login", DoLogin)
e.Run()}
Gin使用中间件
中间件听起来非常高大上的名字，实际上非常简单，就是在请求中间其拦截作用的处理函数
Gin默认中间件
如果你使用Gin.Default实例化gin引擎，默认有俩个中间件，LOgger和Recover，分别用来处理日志和处理错误，如果使用Gin.New需要重新添加
// 新建一个没有任何默认中间件的路由
r := gin.New()// 全局中间件// Logger 中间件将日志写入 gin.DefaultWriter，即使你将 GIN_MODE 设置为 release。// By default gin.DefaultWriter = os.Stdout
r.Use(gin.Logger())// Recovery 中间件会 recover 任何 panic。如果有 panic 的话，会写入 500。
r.Use(gin.Recovery())
自定义中间件
1.自定义中间件非常简单，定义一个符合下边格式的处理函数
type HandlerFunc func(*Context)
2.使用Use方法调用
package main
import("fmt""github.com/gin-gonic/gin")funcTestMW(c *gin.Context){
c.String(200,"hello,%s","ghz")}funcMyMiddleware1(c *gin.Context){
fmt.Println("我的第一个中间件")}funcMyMiddleware2(c *gin.Context){
fmt.Println("我的第二个中间件")}funcmain(){/* func Default() *Engine {
debugPrintWARNINGDefault()
engine := New()
engine.Use(Logger(), Recovery())
return engine
} */// e := gin.Default()// e := gin.New()
e := gin.Default()
e.Use(MyMiddleware1, MyMiddleware2)
e.GET("testmw", TestMW)
e.Run()}
使用Gin BasicAuth中间件
Gin提供了BasicAuth的中间件，用来对网络资源的访问保护
实例：
package main
import("fmt""net/http""github.com/gin-gonic/gin")// 模拟一些私人数据var secrets = gin.H{"foo": gin.H{"email":"[email protected]","phone":"123433"},"austin": gin.H{"email":"[email protected]","phone":"666"},"lena": gin.H{"email":"[email protected]","phone":"523443"},}funcmain(){
r := gin.Default()// 路由组使用 gin.BasicAuth() 中间件// gin.Accounts 是 map[string]string 的一种快捷方式
authorized := r.Group("/admin", gin.BasicAuth(gin.Accounts{"foo":"bar","austin":"1234","lena":"hello2","manu":"4321",}))// /admin/secrets 端点// 触发 "localhost:8080/admin/secrets
authorized.GET("/secrets",func(c *gin.Context){// 获取用户，它是由 BasicAuth 中间件设置的
user := c.MustGet(gin.AuthUserKey).(string)
fmt.Println(user)if secret, ok := secrets[user]; ok {
c.JSON(http.StatusOK, gin.H{"user": user,"secret": secret})}else{
c.JSON(http.StatusOK, gin.H{"user": user,"secret":"NO SECRET :("})}})// 监听并在 0.0.0.0:8080 上启动服务
r.Run(":8080")}
测试
在浏览器中输入localhost:8080/admin/secrets时，会弹出一个对话框，要求输入正确的用户名和密码，才能访问资源。
Gin cookie的使用
cookie是服务器向客户端写的一些数据，可以实现像自动登陆等功能
Gin cookie的使用
package main
import"github.com/gin-gonic/gin"funcHandler(c *gin.Context){// 获得cookie
s, err := c.Cookie("username")if err !=nil{
s ="ghz"// 设置cookie
c.SetCookie("username", s,60*60,"/","localhost",false,true)}
c.String(200,"测试cookie")}funcmain(){
e := gin.Default()
e.GET("/test", Handler)
e.Run()}
Gin使用session
因为http是无状态短连接 ，如何保存客户端和服务器直接的会话状态呢？可以使用session
使用gin session中间件
gin本身没有对session的支持，可以使用第三方中间件
go get github.com/gin-contrib/sessions
import"github.com/gin-contrib/sessions"
该中间件提更了很多后端支持：
cookie-based
redis
memcached
MongoDB
memstore
PostgreSQL
实例：
package main
import("github.com/gin-contrib/sessions""github.com/gin-contrib/sessions/cookie""github.com/gin-gonic/gin")funcmain(){
r := gin.Default()
store := cookie.NewStore([]byte("secret"))
r.Use(sessions.Sessions("mysession", store))
r.GET("/hello",func(c *gin.Context){
session := sessions.Default(c)if session.Get("hello")!="world"{
session.Set("hello","world")
session.Save()}
c.JSON(200, gin.H{"hello": session.Get("hello")})})
r.Run(":8000")}
Gin实现restful风格的CURD
package main
import("fmt""strconv""github.com/gin-gonic/gin")type User struct{
UId int`json:"uid"`
Name string`json:"name"`
Age int`json:"age"`}var users =make([]User,3)funcinit(){
u1 := User{1,"tom",20}
u2 := User{2,"kite",30}
u3 := User{3,"rose",40}
users =append(users, u1)
users =append(users, u2)
users =append(users, u3)
fmt.Println(users)}funcfind(uid int)(*User,int){for i, u :=range users {if u.UId == uid {return&u, i
}}returnnil,-1}funcAddUser(c *gin.Context){
u4 := User{4,"Joe",50}
users =append(users, u4)
c.JSON(200, users)}funcDelUser(c *gin.Context){
uid := c.Param("uid")
id,_:= strconv.Atoi(uid)_, i :=find(id)
users =append(users[:i], users[i+1:]...)
c.JSON(200, users)}funcUpdateUser(c *gin.Context){
uid := c.Param("uid")
id,_:= strconv.Atoi(uid)
u,_:=find(id)
u.Name ="修改的Name"
c.JSON(200, u)}funcFindUser(c *gin.Context){
uid := c.Param("uid")
id,_:= strconv.Atoi(uid)
u,_:=find(id)
c.JSON(200, u)}funcmain(){
e := gin.Default()
e.GET("/user/:uid", FindUser)
e.PUT("/user/:uid", UpdateUser)
e.DELETE("/user/:uid", DelUser)
e.POST("/user/", AddUser)
e.Run()}
Gin实现路由分组
假如你的网站上有很多个模块：博客，教程，视频，回答，每个模块又有很多个路由，这样就可以进行路由分组，使用的方法是router.Group（“分组名称”）
package main
import"github.com/gin-gonic/gin"funcF1(c *gin.Context){}funcF2(c *gin.Context){}funcF3(c *gin.Context){}funcF4(c *gin.Context){}funcF5(c *gin.Context){}funcF6(c *gin.Context){}funcmain(){
router := gin.Default()// 博客// 访问：http://localhost:8080/blog/list
v1 := router.Group("/blog"){
v1.POST("/list", F1)
v1.POST("/post", F2)
v1.POST("/add", F3)}// 视频// 访问：http://localhost:8080/video/list
v2 := router.Group("/video"){
v2.POST("/list", F4)
v2.POST("/post", F5)
v2.POST("/add", F6)}
router.Run(":8080")}
Gin输出渲染
Gin支持很多种输出渲染，可以是简单的字符串，Json，xml，html，protoBuf。使用的方法如下：
c.JSON(200,nil)
c.XML(200,nil)
c.HTML(200,"",nil)
c.String(200,"")
c.ProtoBuf(200,nil)
这里像字符串，json，html我们都用过，这里我们再总结一下：
package main
import"github.com/gin-gonic/gin"funcTestJson(c *gin.Context){
c.JSON(200, gin.H{"name":"多课网","site":"www.duoke360.com",})}funcTestXML(c *gin.Context){
c.XML(200, gin.H{"name":"多课网","site":"www.duoke360.com",})}funcTestHtml(c *gin.Context){
c.HTML(200,"login.html",nil)}funcTestString(c *gin.Context){
c.String(200,"多课网，老郭讲golang")}funcmain(){
e := gin.Default()
e.GET("/test_json", TestJson)
e.GET("/test_xml", TestXML)
e.LoadHTMLGlob("templates/*")
e.GET("/test_html", TestHtml)
e.GET("/test_string", TestString)> 这里是引用
e.Run()}
Gin实现文件上传
创建xml文件
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title></head><body><form action="/upload" method="post" enctype="multipart/form-data">
请选择上传文件：<input type="file" name="file" id=""><br><input type="submit" value="上传"></form></body></html>
Go code
package main
import("fmt""log""net/http""github.com/gin-gonic/gin")funcUpload(c *gin.Context){// 单文件
file,_:= c.FormFile("file")
log.Println(file.Filename)// 上传文件到项目根目录，使用原文件名
c.SaveUploadedFile(file, file.Filename)
c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))}funcGoUpload(c *gin.Context){
c.HTML(200,"upload.html",nil)}funcmain(){
router := gin.Default()// 为 multipart forms 设置较低的内存限制 (默认是 32 MiB)
router.MaxMultipartMemory =8<<20// 8 MiB
router.LoadHTMLGlob("templates/*")
router.GET("/upload", GoUpload)
router.POST("/upload", Upload)
router.Run(":8080")}
本文转载自: https://blog.csdn.net/qq_46079238/article/details/130780276
版权归原作者 啊啊啊杨 所有， 如有侵权，请联系我们删除。
版权归原作者 啊啊啊杨 所有， 如有侵权，请联系我们删除。