Gin 入门实战


Gin 入门实战

正文

环境搭建

一、快速安装入门

net/http

Golang（Go语言）内置是有HTTP服务的，我们可以通过内置的net/http包来实现一个HTTP服务。

package main

import (
    "fmt"
    "log"
    "net/http"
)

func main() {
    http.HandleFunc("/",Index)

    log.Fatal(http.ListenAndServe(":8080", nil))
}

func Index(w http.ResponseWriter, r *http.Request){
    fmt.Fprint(w,"Search:www.baidu.com\nWechat:qq.com")
}

打开浏览器访问 http://localhost:8081 ，返回：

Search:www.baidu.com
Wechat:qq.com

从代码上看实现一个HTTP服务是非常简单的，这也是Golang语言的优势，在底层做了很多封装，可以让我们更容易的实现相关的服务。

虽然net/http看着很便捷、很简单，但是它也存在很多不足：

不能单独的对请求方法(POST,GET等)注册特定的处理函数
不支持Path变量参数
不能很很好的获取参数
不支持参数校验
不支持参数绑定
不能更好的多种格式输出
性能一般
扩展性不足
……

以上等等，这些又都是我们Web开发中常用的，所以我们只能我们自己开发中自己重复的实现，影响了效率，降低了质量，不同人的开发者，性能也不一样。

这时候，我们就非常需要一个Golang Web 框架来帮我们把这些重复的事情做了，这个就是Golang Gin要做的事情了。 Golang Gin 作为一个非常优秀的Web框架，帮我们弥补了net/http的不足，同时还增加了很多日常Web开发使用的功能，可以让我们更好的进行Web开发。

Hello Gin

要使用Gin非常简单，它和其他第三方 Golang 库一样。如果你是基于GOPATH开发的， 你需要先使用go get -u github.com/gin-gonic/gin 下载gin，然后import导入即可。

如果你是用Go Module这种方式，使用import直接导入使用，然后你在go run运行的时候，会自动的下载gin包编译使用。 当然你也可以通过go mod tidy来下载依赖的模块。

现在让我们通过一个例子，看下Golang Gin的使用是多么简单吧。

go.mod

module hello

go 1.14

require github.com/gin-gonic/gin v1.6.3

index.go

package main

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

func main() {
    r := gin.Default()
    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "Search":"www.baidu.com",
            "Wechat":"qq.com",
        })
    })
    r.Run(":8080")
}

然后我们运行它，打开浏览器，输入http://localhost:8080/就可以看到如下内容：

{"Search":"www.baidu.com","Wechat":"qq.com"}

看我们输出一个JSON格式的内容是多么简单，这不就是我们项目中经常用到的API 返回的格式吗？ 不需要特别的包装，即可很方便的实现，比内置的net/http要好多了。

这里解释下如上代码示例：

r := gin.Default()是实例化一个默认的gin示例，便于我们操作，比如接着的为/（也就是首页）的GET访问注册一个处理函数：

    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "Search":"www.baidu.com",
            "Wechat":"qq.com",
        })
    })

看到了吧，Gin允许我们对特定的HTTP方法进行不同的处理，这就为我们实现Restful API提供了方便， 比如这个示例中，如果我们通过POST方法请求http://localhost:8080/会提示404的。

以上返回也很简单，c.JSON方法就是返回一个JSON格式的字符串，它的方法签名如下：

func (c *Context) JSON(code int, obj interface{})

code便是返回的HTTP Status Code，obj是内容，我这里使用的 gin.H 其实是一个map[string]interface{}，声明为H类型，便于操作。

type H map[string]interface{}

最后，我们就可以通过r.Run(":8080")启动一个HTTP服务了，端口是8080，所以我们访问 http://localhost:8080/ 看到返回的JSON内容。

小结

这篇文章到这里就要结束了，相信大家也从这篇文章发现了，我的文章，不仅知其然，更知其所以然（其实我的老读者都知道这件事情）， 所以我并没有直接写Gin的入门代码，而且由浅入深的，逐步介绍引入Gin，然后对代码进行一些解释和分析， 这样大家才会更好的理解，也能加深记忆，不光要做到知其然，也要知其所以然。

Gin还有很多功能，比如路由分组，自定义中间件，自动Crash处理等等，我会在接下来的文章中逐一介绍。






参考资料

go有哪些快速开发的web框架 https://www.zhihu.com/question/27370112

Go语言（Golang）环境搭建详解 https://mp.weixin.qq.com/s?__biz=MzI3MjU4Njk3Ng==&mid=2247484351&idx=3&sn=c148d32f5d0819d66ec71e46bdee91b8

Golang Gin 实战 https://www.flysnow.org/search/?q=Gin

Golang Gin 实战（一）快速安装入门 https://mp.weixin.qq.com/s/Ky5i7rc72s77VOE3LLiQOA

Golang Gin 实战（二）简便的Restful API 实现 https://mp.weixin.qq.com/s/Diue8kQW4L1LpUomfJi73g

Golang Gin 实战（三）路由参数 https://mp.weixin.qq.com/s/lKluqcdkwK6IA3Qp9hgwgw

Golang Gin 实战（四）URL查询参数的获取和原理分析 https://mp.weixin.qq.com/s/y0KhI0BezsQ2MF1z-FBtVA

Golang Gin 实战（五）接收数组和 Map https://www.flysnow.org/2019/12/18/golang-gin-query-parameters-array-map.html

Go语言实战 https://www.flysnow.org/search/?q=Go语言实战笔记

《Go语言实战》笔记(二十八) 后记 https://mp.weixin.qq.com/s?__biz=MzI3MjU4Njk3Ng==&mid=2247484317&idx=4&sn=f69506196f354712378605128617f93d

返回