网站首页 返回列表像“草根”一样，紧贴着地面，低调的存在，冬去春来，枯荣无恙。

Golang学习笔记之WEB框架(gin)基本使用

2020-06-09 20:06:14 admin 4599

#####
gin是Go语言写的一个web框架，API性能超强，运行速度号称较httprouter要快40倍。封装比较优雅，API友好，源码注释比较明确，具有快速灵活，容错方便等特点。

Github地址：<https://github.com/gin-gonic/gin>  
gin的安装：`go get github.com/gin-gonic/gin`  
**API**  
`gin.Default()`  
创建路由  
`gin.DisableConsoleColor()`  
禁用控制台颜色  
`gin.SetMode()`  
设置gin模式。参数可以传递：gin.DebugMode、gin.ReleaseMode、gin.TestMode。  
路由的方法为：假定我们先创建一个路由  
`router := gin.Default()`  
获取的方式可以为

router.GET("/someGet", getting)
        router.POST("/somePost", posting)
        router.PUT("/somePut", putting)
        router.DELETE("/someDelete", deleting)
        router.PATCH("/somePatch", patching)
        router.HEAD("/someHead", head)
        router.OPTIONS("/someOptions", options)

`router.Group(s string)`  
分组，s为组名

###### 一、第一个gin程序

官方给的一个示例程序

package main
    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(":8080") // listen and serve on 0.0.0.0:8080
    }

运行程序，在浏览器上访问：<http://127.0.0.1:8080/ping>

> c.String用来返回字符串。  
>  c.JSON用来返回Json。

gin的功能不只是简单输出Json数据。它是一个轻量级的WEB框架，支持RestFull风格API，支持GET，POST，PUT，PATCH，DELETE，OPTIONS
等http方法，支持文件上传，分组路由，Multipart/Urlencoded
FORM，以及支持JsonP，参数处理等等功能，这些都和WEB紧密相关，通过提供这些功能，使开发人员更方便地处理WEB业务。不同于
net/http库的路由函数，gin进行了封装，把request和response都封装到 gin.Context的上下文环境。

##### 二、快速匹配参数

**Gin框架可以快速的匹配参数**

func main() {
        router := gin.Default()
        router.GET("/user/:name/:password", HinHandler)
        router.Run(":8081")
    }
    //HinHandler 解构传过来的name和password
    func HinHandler(c *gin.Context) {
        name := c.Param("name")
        pwd := c.Param("password")
        //内部提供方法用来返回字符串
        c.String(http.StatusOK, "你好 %s,你的密码为%s", name, pwd)
    }

运行程序在浏览器上访问：<http://127.0.0.1:8081/user/huangzhe/123>

##### 三、Gin获取普通get参数

func main() {
        //修改模式
        gin.SetMode(gin.ReleaseMode)
        //Default方法创建一个路由handler。
        router := gin.Default()
        router.GET("/user", GetHandler)
        router.Run(":8081")
    }
    //GetHandler 使用get方式获取对应键的值
    func GetHandler(c *gin.Context) {
        name := c.DefaultQuery("name", "Guest") //找不到name给它一个默认值Guest
        password := c.Query("password")         //找不到直接赋空
        //GetQuery返回两个参数，第一个是找到的对应键的值，第二个是是否找到error类型
        id, exist := c.GetQuery("id")
        if !exist {
            name = "the key is not exist"
        }
        c.Data(http.StatusOK, "text/plain",
            []byte(fmt.Sprintf("get success! %s %s %s", name, password, id)))
    }

运行程序在浏览器上访问：  
[http://127.0.0.1:8081/user?name=huangzhe&password=123&id=456](http://127.0.0.1:8081/user?name=huangzhe&password=123&id=456)

##### 四、分组

//分组
        //组内成员访问为http://127.0.0.1:8080/admin/...
        v1 := router.Group("admin")
        
        {
            //访问为http://127.0.0.1:8080/admin/ping
            v1.GET("/ping", api.HelloPage)
            v1.GET("/welcome", api.LoginHandler)
            v1.GET("/getquery",api.GetHandler)
        }

##### 五、Gin默认路由

我们可以自定义404错误

func main() {
        //修改模式
        gin.SetMode(gin.ReleaseMode)
    
        //Default方法创建一个路由handler。
        router := gin.Default()
    
        //设定请求url不存在的返回值
        router.NoRoute(NoResponse)
    
        router.GET("/user", GetHandler)
        router.Run(":8081")
    }
    //NoResponse 请求的url不存在，返回404
    func NoResponse(c *gin.Context) {
        //返回404状态码
        c.JSON(http.StatusNotFound, gin.H{
            "status": 404,
            "error":  "404, page not exists!",
        })
    }
    //GetHandler 使用get方式获取对应键的值
    func GetHandler(c *gin.Context) {
        name := c.DefaultQuery("name", "Guest") //找不到name给它一个默认值Guest
        password := c.Query("password")         //找不到直接赋空
        //GetQuery返回两个参数，第一个是找到的对应键的值，第二个是是否找到error类型
        id, exist := c.GetQuery("id")
        if !exist {
            name = "the key is not exist"
        }
        c.Data(http.StatusOK, "text/plain",
            []byte(fmt.Sprintf("get success! %s %s %s", name, password, id)))
    }

我们去请求一个并不存在的url：<http://127.0.0.1:8081/us>

##### 六、Gin获取普通post参数

我这里是使用RESTClient来模拟的，在Firefox上附加组件

func main() {
        //修改模式
        gin.SetMode(gin.ReleaseMode)
    
        //Default方法创建一个路由handler。
        router := gin.Default()
    
        //设定请求url不存在的返回值
        router.NoRoute(NoResponse)
    
        router.POST("/user", PostLoginHandler)
        router.Run(":8081")
    }
    
    //NoResponse 请求的url不存在，返回404
    func NoResponse(c *gin.Context) {
        //返回404状态码
        c.JSON(http.StatusNotFound, gin.H{
            "status": 404,
            "error":  "404, page not exists!",
        })
    }
    
    //PostLoginHandler 获取参数
    func PostLoginHandler(c *gin.Context) {
        name := c.PostForm("name")                       //找不到name直接返回0值
        password := c.DefaultPostForm("password", "888") //找不到password赋默认值
        sec, ok := c.GetPostForm("second")               //判断是否能找到，找不到返回false
        c.String(http.StatusOK, "hello %s %s %s", name, password, sec)
        log.Panicln(ok)
    }

使用post需要添加头字段

如下：

##### 七、中间件MiddleWare

**注意，gin.Default() 默认是加载了一些框架内置的中间件的，而 gin.New() 则没有，根据需要自己手动加载中间件。**

func MiddleWare(c *gin.Context) {
        fmt.Println("before request")
        c.Next()
    }
    func main() {
        //修改模式
        gin.SetMode(gin.ReleaseMode)
    
        //Default方法创建一个路由handler。
        router := gin.Default()
    
        //设定请求url不存在的返回值
        router.NoRoute(NoResponse)
    
        router.Use(MiddleWare)
    
        router.GET("/user", GetHandler)
        router.Run(":8081")
    }
    
    //NoResponse 请求的url不存在，返回404
    func NoResponse(c *gin.Context) {
        //返回404状态码
        c.JSON(http.StatusNotFound, gin.H{
            "status": 404,
            "error":  "404, page not exists!",
        })
    }
    
    //GetHandler 使用get方式获取对应键的值
    func GetHandler(c *gin.Context) {
        name := c.DefaultQuery("name", "Guest") //找不到name给它一个默认值Guest
        password := c.Query("password")         //找不到直接赋空
        //GetQuery返回两个参数，第一个是找到的对应键的值，第二个是是否找到error类型
        id, exist := c.GetQuery("id")
        if !exist {
            name = "the key is not exist"
        }
        c.Data(http.StatusOK, "text/plain",
            []byte(fmt.Sprintf("get success! %s %s %s", name, password, id)))
    }

我们访问上面的url

**在终端上你会发现中间件已执行，我们可以在中间件里做验证或者⽇志记录**

> c.Next()继续执行下面的函数  
>  c.Abort()截断执行

##### 八、文件服务

上传单个文件

func main() {
        router := gin.Default()
        // Set a lower memory limit for multipart forms (default is 32 MiB)
        // router.MaxMultipartMemory = 8 << 20  // 8 MiB
        router.POST("/upload", func(c *gin.Context) {
            // single file
            file, _ := c.FormFile("file")
            log.Println(file.Filename)
    
            // Upload the file to specific dst.
            // c.SaveUploadedFile(file, dst)
    
            c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
        })
        router.Run(":8080")
    }

上传多个文件

func main() {
        router := gin.Default()
        // Set a lower memory limit for multipart forms (default is 32 MiB)
        // router.MaxMultipartMemory = 8 << 20  // 8 MiB
        router.POST("/upload", func(c *gin.Context) {
            // Multipart form
            form, _ := c.MultipartForm()
            files := form.File["upload[]"]
            for _, file := range files {
                log.Println(file.Filename)
    
                // Upload the file to specific dst.
                // c.SaveUploadedFile(file, dst)
            }
            c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
        })
        router.Run(":8080")
    }

更多使用可以去Github去查：<https://github.com/gin-gonic/gin>

转载文章，原文链接： Golang学习笔记之WEB框架(gin)基本使用

关键字词golang web

分享到：

上一篇：go语言简介

下一篇：Golang学习笔记之接口(interface)

如需留言，请登录，没有账号？请注册

0 条评论 0 人参与

网站首页 返回列表像“草根”一样，紧贴着地面，低调的存在，冬去春来，枯荣无恙。

Golang学习笔记之WEB框架(gin)基本使用

zhou 3年前

zhou 3年前

zhou 3年前

zhou 3年前

武云 3年前

网站首页 返回列表 像“草根”一样，紧贴着地面，低调的存在，冬去春来，枯荣无恙。

Golang学习笔记之WEB框架(gin)基本使用

zhou 3年前

zhou 3年前

zhou 3年前

zhou 3年前

武云 3年前

网站首页返回列表像“草根”一样，紧贴着地面，低调的存在，冬去春来，枯荣无恙。