既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上Go语言开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
###### 参数作为URL
package main
import (
“github.com/gin-gonic/gin”
)
func main() {
// 开启实例
r := gin.Default()
// 参数 访问 http://127.0.0.1:8080/assets/2 返回 {"id":"2","name":"assets"}
r.GET("/:name/:id", func(c \*gin.Context) {
c.JSON(200, gin.H{
"name": c.Param("name"), // 获取URL参数
"id": c.Param("id"), // 获取URL参数
})
})
// 启动
r.Run()
}
###### 泛绑定
package main
import (
“github.com/gin-gonic/gin”
)
func main() {
// 开启实例
r := gin.Default()
// 匹配刀所有的user前缀的请求
// http://127.0.0.1:8080/user/\*\*\*\*
// http://127.0.0.1:8080/user/ashdjka
// http://127.0.0.1:8080/user
r.GET("/user/\*action", func(c \*gin.Context) {
c.String(200, "hello")
})
// 启动
r.Run()
}
#### 2. 获取请求参数
###### 获取GET请求参数
package main
import (
“github.com/gin-gonic/gin”
“net/http”
)
func main() {
// 创建实例
r := gin.Default()
// 请求 http://127.0.0.1:8080/test?first\_name=long 返回 long:wang
// 请求 http://127.0.0.1:8080/test?first\_name=long&last\_name=wei 返回 long:wei
r.GET("/test", func(c \*gin.Context) {
firstName := c.Query("first\_name")
lastName := c.DefaultQuery("last\_name", "wang") // 默认值
c.String(http.StatusOK, "%s:%s", firstName, lastName)
})
// 启动
r.Run(":8080")
}
###### 获取POST请求参数
package main
import (
“github.com/gin-gonic/gin”
“net/http”
)
func main() {
// 创建实例
r := gin.Default()
r.POST("/test", func(c \*gin.Context) {
// 从POST请求中获取参数值
firstName := c.PostForm("first\_name")
lastName := c.DefaultPostForm("last\_name", "wei")
c.String(http.StatusOK, "%s:%s", firstName, lastName)
})
// 启动
r.Run(":8080")
}
###### 获取Body值
package main
import (
“bytes”
“github.com/gin-gonic/gin”
“io/ioutil”
“net/http”
)
func main() {
// 创建实例
r := gin.Default()
r.POST("/test", func(c \*gin.Context) {
// 数据流中获取Body
all, err := ioutil.ReadAll(c.Request.Body)
if err != nil {
c.String(http.StatusBadRequest, err.Error())
// 结束, 将程序中止
c.Abort()
}
// 从数据流取出body后, 无法再通过post获取到POST请求中参数的值
// 需要将读到的结果再回存, 再写到c.Request.Body中
c.Request.Body = ioutil.NopCloser(bytes.NewBuffer(all))
firstName := c.PostForm("first\_name")
lastName := c.DefaultPostForm("last\_name", "wei")
c.String(http.StatusOK, "%s:%s:%s", firstName, lastName, string(all))
})
// 启动
r.Run(":8080")
}
###### 获取参数绑定到结构体
package main
import (
“github.com/gin-gonic/gin”
“net/http”
“time”
)
// Person 定义结构体
type Person struct {
Name string form:"name"
Address string form:"address"
Birthday time.Time form:"birthday" time\_format:"2006-01-02"
}
func main() {
// 创建实例
r := gin.Default()
r.GET("/test", handle)
r.POST("/test", handle)
r.Run(":8080")
}
func handle(c *gin.Context) {
var user Person
// 这里是根据请求的content-type来做不同的binding操作
err := c.ShouldBind(&user)
// 结构体要传指针, 因为要修改值, 并且结构体字段首字母大写, 因为要包外可见
if err != nil {
c.String(http.StatusBadRequest, "error: %v", err)
c.Abort()
}
c.String(http.StatusOK, "user: %v", user)
}
#### 2. 验证请求参数
###### 结构体验证
更多验证规则[官方验证规则](https://bbs.csdn.net/topics/618658159)
package main
import (
“github.com/gin-gonic/gin”
“net/http”
)
// Person 定义结构体
type Person struct {
// 验证规则 多个条件都须满足用,分割 多个条件任意满足用|分割, 多个条件时,和|两边不要有空格
Name string form:"name" binding:"required"
// 结构体绑定通过form标签, 结构体字段验证通过binding标签
Address string form:"address" binding:"required"
// 结构体绑定通过form标签, 结构体字段验证通过binding标签
Age int form:"age" binding:"required,gt=10"
// 结构体绑定通过form标签, 结构体字段验证通过binding标签
}
func main() {
// 创建实例
r := gin.Default()
// 请求 http://127.0.0.1:8080/testing?name=chao&age=10&address=hangzhou
// 返回 error: Key: 'Person.Age' Error:Field validation for 'Age' failed on the 'gt' tag
r.GET("/testing", handle)
r.Run(":8080")
}
func handle(c *gin.Context) {
var user Person
// 结构体要传指针, 因为要修改值, 并且结构体字段首字母大写, 因为要包外可见
if err := c.ShouldBind(&user); err != nil {
// 这里是根据请求的content-type来做不同的binding操作
c.String(http.StatusInternalServerError, "error: %v", err)
c.Abort() // Note that this will not stop the current handler, call Abort to ensure the remaining handlers for this request are not called.
return
}
c.String(http.StatusOK, "user: %v", user)
}
###### 自定义验证
package main
import (
“fmt”
“github.com/gin-gonic/gin”
“github.com/gin-gonic/gin/binding”
“github.com/go-playground/validator/v10”
“net/http”
“time”
)
// Booking 定义结构体
type Booking struct {
// 验证规则 多个条件都须满足用,分割 多个条件任意满足用|分割 多个条件时,和|两边不要有空格
CheckIn time.Time form:"check\_in" binding:"required,bookabledate" time\_format:"2006-01-02"
// 结构体绑定通过form标签, 结构体字段验证通过binding标签
CheckOut time.Time form:"check\_out" binding:"required,gtfield=CheckIn" time\_format:"2006-01-02"
// 结构体绑定通过form标签, 结构体字段验证通过binding标签
}
// 自定义验证规则
func bookableDate(fl validator.FieldLevel) bool {
// 类型断言, 是否 time.Time 类型
if date, ok := fl.Field().Interface().(time.Time); ok {
// 当前时间, 格式为 Time
today := time.Now()
// 转成时间戳格式
if today.Unix() < date.Unix() {
return true
}
}
return false
}
func main() {
// 创建实例
r := gin.Default()
// 注册验证器
if validate, ok := binding.Validator.Engine().(\*validator.Validate); ok {
// 将 tag 中的 key, 与自定义规则方法绑定
err := validate.RegisterValidation("bookabledate", bookableDate)
if err != nil {
fmt.Println(err)
return
}
}
// 请求 http://127.0.0.1:8080/bookable?check\_in=2021-11-04&check\_out=2021-11-05
// 返回 {"error": "Key: 'Booking.CheckIn' Error:Field validation for 'CheckIn' failed on the 'bookabledate' tag"}
// 请求 http://127.0.0.1:8080/bookable?check\_in=2021-11-08&check\_out=2021-11-02
// 返回 {"error": "Key: 'Booking.CheckOut' Error:Field validation for 'CheckOut' failed on the 'gtfield' tag"}
r.GET("/bookable", handle)
r.Run(":8080")
}
func handle(c *gin.Context) {
var booking Booking
// 结构体要传指针, 因为要修改值, 并且结构体字段首字母大写, 因为要包外可见
if err := c.ShouldBind(&booking); err != nil {
// 这里是根据请求的content-type来做不同的binding操作
c.JSON(http.StatusInternalServerError, gin.H{
"error": err.Error(),
})
return
}
c.JSON(http.StatusOK, gin.H{
"message": "ok",
"booking": booking,
})
}
###### 升级验证-支持多语言错误信息
package main
import (
“github.com/gin-gonic/gin”
en2 “github.com/go-playground/locales/en” // 英文语言包
zh2 “github.com/go-playground/locales/zh” // 中文语言包
ut “github.com/go-playground/universal-translator”
“github.com/go-playground/validator/v10” // 公共包
en_translations “github.com/go-playground/validator/v10/translations/en”
zh_translations “github.com/go-playground/validator/v10/translations/zh”
“net/http”
)
// Person 定义结构体
type Person struct {
// 验证规则 多个条件都须满足用,分割 多个条件任意满足用|分割 多个条件时,和|两边不要有空格
// 使用多语言包, 结构体验证 tag 不再是 binding, 而是 validate
Name string form:"name" validate:"required" json:"name"
Age int form:"age" validate:"required,gt=10" json:"age"
}
func main() {
// 创建验证器
v := validator.New()
// 支持的语言
zh := zh2.New()
en := en2.New()
// 创建翻译器
translator := ut.New(zh, en)
// 创建实例
r := gin.Default()
// 请求 http://127.0.0.1:8080/bookable?name=chao&age=20, 返回 {"data":{"name":"chao","age":20},"message":"ok"}
// 请求 http://127.0.0.1:8080/bookable?age=20, 返回 {"error":["Name为必填字段"]}
// 请求 http://127.0.0.1:8080/bookable?name=chao&age=10&locale=en, 返回 {"error":["Age must be greater than 10"]}
// 请求 http://127.0.0.1:8080/bookable, 返回 {"error":["Name为必填字段","Age为必填字段"]}
r.GET("/bookable", func(c \*gin.Context) {
// 接收指定语言参数, 设置默认语言
locale := c.DefaultQuery("locale", "zh")
trans, \_ := translator.GetTranslator(locale)
switch locale {
case "zh":
zh_translations.RegisterDefaultTranslations(v, trans)
case "en":
en_translations.RegisterDefaultTranslations(v, trans)
default:
zh_translations.RegisterDefaultTranslations(v, trans)
}
var p Person
// 绑定结构体
if err := c.ShouldBind(&p); err != nil {
// 结构体要传指针, 因为要修改值, 并且结构体字段首字母大写, 因为要包外可见
c.JSON(http.StatusInternalServerError, gin.H{
"error": err.Error(),
})
c.Abort()
return
}
// 验证结构体
if err := v.Struct(p); err != nil {
errs := err.(validator.ValidationErrors)
var sliceErrors []string
for \_, e := range errs {
// 将错误翻译成相应的语言
sliceErrors = append(sliceErrors, e.Translate(trans))
}
c.JSON(http.StatusInternalServerError, gin.H{
"error": sliceErrors,
})
c.Abort()
return
}
c.JSON(http.StatusOK, gin.H{
"message": "ok",
"data": p,
})
})
r.Run(":8080")
}
#### 3. 中间件
中间件是介于 gin 服务器和执行的回调函数之间的中间层, 可以作为请求拦截和日志打印
###### 使用 gin 中间件
package main
import (
“github.com/gin-gonic/gin”
“io”
“net/http”
“os”
)
func main() {
// 指定日志写入文件
file, \_ := os.Create("gin.log")
gin.DefaultWriter = io.MultiWriter(file)
gin.DefaultErrorWriter = io.MultiWriter(file)
// 创建实例, gin.Default()方法默认已经实现了Logger()和Recovery()两个中间件
r := gin.New()
// 设置中间件
// gin.Logger() 添加日志中间件 打印到终端, 或者写入文件
// gin.Recovery() 添加 panic 恢复中间件, 遇到 panic 不会中断程序, 如果不加该中间件会直接中断程序结束运行
r.Use(gin.Logger(), gin.Recovery())
// [GIN] 2021/11/05 - 22:45:53 | 200 | 997.8µs | 127.0.0.1 | GET "/get"
r.GET("/get", func(c \*gin.Context) {
name := c.DefaultQuery("name", "chao")
c.JSON(http.StatusOK, gin.H{
"message": "OK",
"data": name,
})
})
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
| 127.0.0.1 | GET “/get”
r.GET(“/get”, func(c *gin.Context) {
name := c.DefaultQuery("name", "chao")
c.JSON(http.StatusOK, gin.H{
"message": "OK",
"data": name,
})
})
[外链图片转存中…(img-g82Ewezb-1715513694276)]
[外链图片转存中…(img-DoMDZaQ0-1715513694276)]
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!