Go语言(十三)Gin Web框架

wx5b285b48ed74e · · 1316 次点击 · · 开始浏览

这是一个创建于的文章,其中的信息可能已经有所发展或是发生改变。

Gin Web框架

简介

基于httprouter开发的web框架:https://github.com/gin-gonic/gin
提供Martini风格的API,但比Martini要快40倍
非常轻量级,使用简洁

Gin框架的安装与使用

安装: go get -u github.com/gin-gonic/gin
基本使用

import "github.com/gin-gonic/gin"
func main() {
 r := gin.Default()
 r.GET("/ping", func(c *gin.Context) {
 c.JSON(200, gin.H{
 "message": "pong",
 })
 })
 r.Run("0.0.0.0:9090")
}

支持restful风格的API

把设计的API抽象成一个个资源,用URI来标识
针对每一个资源,使用统一的方法进行操作
统一的方法: GET,POST,PUT,DELETE

import (
 "github.com/gin-gonic/gin"
 "net/http"
)
type Result struct {
 Message string `json:"message"`
 Code int `json:"code"`
}
func handleUserInfo(c *gin.Context) {
 var result Result = Result{
 Message: "hello",
 Code: 0,
 }
 c.JSON(http.StatusOK,result)
}
func main() {
 r := gin.Default()
 r.GET("/user/info", handleUserInfo)
 r.Run("0.0.0.0:9090")
}

queryString设计

查询类:http://127.0.0.1:9090/user/info?username=dadasd&&passwd=1234
路由类:http://127.0.0.1:9090/user/info/2020/12

import (
 "github.com/gin-gonic/gin"
 "net/http"
)
type Result struct {
 Message string `json:"message"`
 Code int `json:"code"`
}
type UserInfo struct {
 Result
 UserName string `json:"username"`
 Passwd string `json:"passwd"`
}
func handleUserParams(c *gin.Context) {
 //查询类接口
 username := c.Query("username")
 passwd := c.DefaultQuery("passwd","adcdefg")
 var result UserInfo = UserInfo{
 Result{
 Message: "success",
 Code: 200,
 },
 username,
 passwd,
 }
 c.JSON(http.StatusOK,result)
}
func handleUserInfo(c *gin.Context) {
 //路由类接口
 username := c.Param("username")
 passwd := c.Param("passwd")
 var result UserInfo = UserInfo{
 Result{
 Message: "success",
 Code: 200,
 },
 username,
 passwd,
 }
 c.JSON(http.StatusOK,result)
}
func main() {
 r := gin.Default()
 r.GET("/user/info", handleUserParams)
 r.GET("/user/info/:username/:passwd", handleUserInfo)
 r.Run("0.0.0.0:9090")
}

Gin框架参数传递

获取表单参数

import (
 "github.com/gin-gonic/gin"
 "net/http"
)
type Result struct {
 Message string `json:"message"`
 Code int `json:"code"`
}
type UserInfo struct {
 Result
 UserName string `json:"username"`
 Passwd string `json:"passwd"`
}
func handleUserInfo(c *gin.Context) {
 username := c.PostForm("username")
 passwd := c.PostForm("passwd")
 var result UserInfo = UserInfo{
 Result: Result{
 Message: "success",
 Code: 200,
 },
 UserName: username,
 Passwd: passwd,
 }
 c.JSON(http.StatusOK,result)
}
func main() {
 r := gin.Default()
 r.POST("/user/info",handleUserInfo)
 r.Run(":9090")
}

单文件上传

func handleUpload(c *gin.Context) {
 file,err := c.FormFile("testfile")
 if err != nil {
 fmt.Printf("upload file faild,err:%v\n",err)
 return
 }
 //文件上传路径
 filename := fmt.Sprintf("/Users/wanghui/go/src/oldBoy/day8/tmp/%s",file.Filename)
 //文件保存
 err = c.SaveUploadedFile(file,filename)
 if err != nil {
 fmt.Printf("save file faild,err:%v\n",err)
 return
 }
 //状态返回
 c.JSON(http.StatusOK,"file upload success")
}
func main() {
 r := gin.Default()
 r.POST("/file/upload",handleUpload)
 r.Run(":9090")
}

多文件上传

func multiHandleUpload(c *gin.Context) {
 //多文件上传
 form,err := c.MultipartForm()
 if err != nil {
 fmt.Printf("upload file faild,err:%v\n",err)
 return
 }
 files := form.File["testfile"]
 for _,file := range files {
 filename := fmt.Sprintf("/Users/wanghui/go/src/oldBoy/day8/tmp/%s",file.Filename)
 err = c.SaveUploadedFile(file,filename)
 if err != nil {
 fmt.Printf("save file faild,err:%v\n",err)
 return
 }
 }
 //状态返回
 c.JSON(http.StatusOK,"file upload success")
}
func main() {
 r := gin.Default()
 r.POST("/file/upload",handleUpload)
 r.POST("/files",multiHandleUpload)
 r.Run(":9090")
}

通过postman上传文件
Go语言(十三)Gin Web框架

路由分组

func main() {
 r := gin.Default()
 v1Group := r.Group("/v1")
 v1Group.POST("/user/info",handleUserInfo)
 v1Group.POST("/user/info2",handleUserInfo)
 r.Run(":9090")
}

gin的参数绑定

为什么要使用参数绑定
- 通过反射的机制,自动提取querystring、form表单,json,xml等参数到struct中
- 通过http协议中的content type,识别是json,xml或者表单

type UserInfo struct {
 UserName string `form:"username" json:"username" binding:"required"`
 Passwd string `form:"passwd" json:"passwd" binding:"required"`
 Age int `form:"age" json:"age" binding:"required"`
 Sex string `form:"sex" json:"sex" binding:"required"`
}
func PostUserInfo(c *gin.Context) {
 var UserInfo UserInfo
 //表单绑定,使用指针
 err := c.ShouldBind(&UserInfo)
 if err != nil {
 return
 }
 c.JSON(http.StatusOK,UserInfo)
}
func PostUserInfoJson(c *gin.Context) {
 var UserInfo UserInfo
 //表单绑定,使用指针
 err := c.ShouldBindJSON(&UserInfo)
 if err != nil {
 return
 }
 c.JSON(http.StatusOK,UserInfo)
}
func GetUserInfoJson(c *gin.Context) {
 var UserInfo UserInfo
 //表单绑定,使用指针
 err := c.ShouldBindJSON(&UserInfo)
 if err != nil {
 return
 }
 c.JSON(http.StatusOK,UserInfo)
}
func main() {
 r := gin.Default()
 v1Group := r.Group("/v1")
 v1Group.POST("/user/infos",PostUserInfo)
 v1Group.POST("/user/infojson",PostUserInfoJson)
 v1Group.GET("/user/info",GetUserInfoJson)
 r.Run(":9090")
}

渲染

gin.Context.JSON方法进行渲染

type UserInfo struct {
 UserName string `form:"username" json:"username" binding:"required"`
 Passwd string `form:"passwd" json:"passwd" binding:"required"`
}
func GetUserInfoJson(c *gin.Context) {
 var userInfo = &UserInfo{
 UserName: "zhansan",
 Passwd: "aaaa",
 }
 c.XML(200,userInfo)
}
func main() {
 r := gin.Default()
 v1Group := r.Group("/v1")
 v1Group.GET("/user/info",GetUserInfoJson)
 r.Run(":9090")
}

HTML模板渲染

templates/post.html

{{ define "index.tmpl" }}
 <html><h1>
 {{ . }}
 </h1>
 <p>Using posts/index.tmpl</p>
 </html>
{{ end }}

server.go

func HandleHtmml(c *gin.Context) {
 c.HTML(200,"index.tmpl","mmmmmmmm")
}
func main() {
 r := gin.Default()
 r.LoadHTMLGlob("./templates/*")
 r.GET("/user/info",HandleHtmml)
 r.Run(":9090")
}

gin中间件

gin框架在请求处理过程中,加入用户自己的钩子函数,这个钩子函数就叫做中间件
因此,可以使用中间件处理一些公共业务逻辑,比如耗时统计,日志打印,登录校验等

func StatCost(c *gin.Context) {
 //中间件
 start := time.Now()
 fmt.Printf("start \n")
 c.Next()
 lattacy := time.Since(start)
 fmt.Printf("cost Time is %dms\n", lattacy/1000/1000)
}
func funcHello(c *gin.Context) {
 fmt.Printf("request start\n")
 time.Sleep(time.Second * 3)
 c.JSON(http.StatusOK, "hello world")
}
func main() {
 r := gin.Default()
 r.Use(StatCost)
 r.GET("/hello", funcHello)
 r.Run(":9090")
}

gin框架路由原理

路由部分使用的是:https://github.com/julienschmidt/httprouter
对于路由的规则,httprouter会构造一颗前缀树

Go语言(十三)Gin Web框架

有疑问加站长微信联系(非本文作者)

本文来自:51CTO博客

感谢作者:wx5b285b48ed74e

查看原文:Go语言(十三)Gin Web框架

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

关注微信

1316 次点击

上一篇:CVE-2019-16097

下一篇:Go+GraphQL+React+Typescript搭建简书项目(五)——注册与登录

gin 框架 context web

0 回复

暂无回复

添加一条新回复 (您需要后才能回复没有账号 ?)

请尽量让自己的回复能够对别人有帮助
支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
图片支持拖拽、截图粘贴等方式上传

用户登录

Go今日面试题

(追記) (追記ここまで)

今日阅读排行

加载中

(追記) (追記ここまで)

一周阅读排行

加载中

关注我

扫码关注领全套学习资料关注微信公众号
加入 QQ 群:
- 192706294(已满)
- 731990104(已满)
- 798786647(已满)
- 729884609(已满)
- 977810755(已满)
- 815126783(已满)
- 812540095(已满)
- 1006366459(已满)
- 692541889
关注微信公众号
加入微信群:liuxiaoyan-s,备注入群
也欢迎加入知识星球 Go粉丝们(免费)

给该专栏投稿写篇新文章

每篇文章有总共有 5 次投稿机会

Go语言(十三)Gin Web框架

Gin Web框架

简介

Gin框架的安装与使用

基本使用

支持restful风格的API

queryString设计

Gin框架参数传递

单文件上传

多文件上传

路由分组

gin的参数绑定

渲染

HTML模板渲染

gin中间件

gin框架路由原理

用户登录

今日阅读排行

一周阅读排行

关注我

给该专栏投稿 写篇新文章

收入到我管理的专栏 新建专栏

Gin Web框架

简介

Gin框架的安装与使用

基本使用

支持restful风格的API

queryString设计

Gin框架参数传递

单文件上传

多文件上传

路由分组

gin的参数绑定

渲染

HTML模板渲染

gin中间件

gin框架路由原理

给该专栏投稿写篇新文章

收入到我管理的专栏新建专栏