Go Web框架 Gin路由（一）

一时失言乱红尘 2021-09-03 03:02 569阅读 0赞

## 简介 ##

Gin是目前应用比较广泛的Golang web框架。Gin提供了web开发的一些基本功能。比如路由，中间件，日志，参数获取等。Gin的路由功能是基于https://github.com/julienschmidt/httprouter 这个项目实现的。它是一个类似于martini但拥有更好性能的API框架，由于使用了httprouter，速度提高了40倍。gin中文文档，地址https://gin-gonic.com/zh-cn/docs/

## Gin安装和使用 ##

下载并安装

go  get  -u   github.com/gin-gonic/gin

安装完毕后，可以在当前系统得$GOPATH目录下得src/github.com目录中找到gin-goni目录，该目录下存放的就是gin框架的源码 go env 可以查看GOPATH路径  
在文档服务器里面  
1.首先创建mod  
git mod init 项目名  
![在这里插入图片描述][20201208142653547.png]

2.go get -u -v 把需要的包拉到mod  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 1]  
3.完成后生成 .sum  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 2]

## 使用 ##

示例

package main
    
    import (
    	"github.com/gin-gonic/gin"
    )
    
    func main() { 
    	//创建一个默认的路由引擎
    	r := gin.Default()
    	//GET:请求方式； /hello ：请求的路径
    	//当客户端以GET方法请求/hello路径时，会执行后面的匿名函数
    	r.GET("/hello", func(c *gin.Context) { 
    		//c.Json:返回JSON格式的数据
    		c.JSON(200, gin.H{ 
    			"message": "Hello world",
    		})
    	})
    	//启动HTTP服务，默认在0.0.0.0:8080 启动服务
    	r.Run()
    	err !=nil{ 
    	  log.Fatal(err.Error)
    	}
    }

1.func Default()\*Engine\{ \}  
gin.Default()返回的是一个指针类型，路由引擎  
2.返回的指针类型包含了一个run（）方法，run方法返回一个error类型  
3.可以用err接收返回的error类型，判断是否为空，如果不为空的话，就打印log.Fatal(err.Error())  
4.返回的指针类型engine还包含get方法，第一个参数是解析的路径，第二个是func函数处理get请求，  
发现端口已被占用  
![在这里插入图片描述][20201208143036373.png]  
法一：修改监听的端口  
![在这里插入图片描述][20201208161237751.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 3]

法二：将端口释放  
查看端口的占用情况（linux）  
\-t (tcp) 仅显示tcp相关选项  
\-u (udp)仅显示udp相关选项  
\-n 拒绝显示别名，能显示数字的全部转化为数字  
\-l 仅列出在Listen(监听)的服务状态  
\-p 显示建立相关链接的程序名  
![在这里插入图片描述][20201208143633100.png]  
根据端口找到对应的进程

## restful API ##

REST是客户端与web服务器之间进行交互的时候，使用HTTP协议中的4个请求方法代表不同的动作。  
GET用来获取资源  
POST用来新建资源  
PUT用来更新资源  
DELETE永安里删除资源  
只要API程序遵循了REST风格，那就可以称其为RESTful API 。前后端基本都是通过RESTful API来进行交互。

编写一个管理书籍的系统，查询对一本书进行查询，创建，更新和删除等操作，我们在编写程序的时候就要设计客户端浏览器与我们web服务端交互的方式和路径。按照经验我们通常设计如下模式  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 4]  
同样的需求我们按照RESTful AP设计  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 5]  
相关代码

package main
    
    import (
    	"github.com/gin-gonic/gin"
    )
    
    func main() { 
    	//创建一个默认的路由引擎
    	r := gin.Default()
    	//GET:请求方式； /hello ：请求的路径
    	//当客户端以GET方法请求/hello路径时，会执行后面的匿名函数
    	r.GET("/book", func(c *gin.Context) { 
    		c.JSON(200, gin.H{ 
    			"message": "GET",
    		})
    	})
    
    	r.POST("/book", func(c *gin.Context) { 
    		c.JSON(200, gin.H{ 
    			"message": "POST",
    		})
    	})
    
    	r.PUT("/book", func(c *gin.Context) { 
    		c.JSON(200, gin.H{ 
    			"message": "PUT",
    		})
    	})
    
    	r.DELETE("/book", func(c *gin.Context) { 
    		c.JSON(200, gin.H{ 
    			"message": "DELETE",
    		})
    	})
    	//
    	//r.Run()启动HTTP服务，默认在0.0.0.0:8080 启动服务 如果是自己电脑就是本地ip（127.0.0.1）
    	//但是此时我用的环境的ip是192.168.12.112：9000 所以访问的时候用192.168.12.112
    	r.Run("0.0.0.0:9000")
    }
    }

开发RESTful API的时候我们通常使用Postman来作为客户端测试工具  
GET请求  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 6]  
POST请求  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 7]  
PUT请求  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 8]  
DELETE请求  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 9]

## Gin渲染 ##

### HTML渲染 ###

首先定义一个存放模板文件的templates文件夹，然后再内部按照业务分别定义一个posts文件夹和users文件夹，posts/index.html文件的内容如下：

{
       {define "posts/index.html"}}
    <!DOCTYPE html>
    <html lang="en">
    
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta http-equiv="X-UA-Compatible" content="ie=edge">
        <title>posts/index</title>
    </head>
    <body>
        {
       {.title}}
    </body>
    </html>
    {
       {end}}

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 10]  
user/index.html文件内容如下：

{
       {define "users/index.html"}}
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta http-equiv="X-UA-Compatible" content="ie=edge">
        <title>users/index</title>
    </head>
    <body>
        {
       {.title}}
    </body>
    </html>
    {
       {end}}

![在这里插入图片描述][20201208163935368.png]  
新建一个mod  
![在这里插入图片描述][20201208164311775.png]  
![在这里插入图片描述][20201208164404858.png]  
完成后又生成了一个sum文件  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 11]  
之后可以执行正常的go 命令  
Gin框架中使用LoadHTMLGlob()或者LoadHTMLFiles()方法进行HTML模板渲染

package main
    
    import (
    	"net/http"
    
    	"github.com/gin-gonic/gin"
    )
    
    func main() { 
    	//创建一个默认的路由引擎
    	r := gin.Default()
    	r.LoadHTMLGlob("/home/liyingzhi/workspace/git.chinaddos.com/templates/**/*")
    
    	r.GET("/posts/index", func(c *gin.Context) { 
    		c.HTML(http.StatusOK, "posts/index.html", gin.H{ 
    			"title": "posts/index",
    		})
    	})
    
    	r.GET("users/index", func(c *gin.Context) { 
    		c.HTML(http.StatusOK, "users/index.html", gin.H{ 
    			"title": "users/index",
    		})
    	})
    	//
    	//0.0.0.0:8080但是此时我用的环境的ip是192.168.12.112：9000 所以访问的时候用192.168.12.112:9000
    	r.Run(":9000")
    }

[20201208142653547.png]: /images/20210820/324ea98cbf2d4f1b90c41fd18dde7069.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70]: /images/20210820/d75519a201534b1e9ab5bcf81f3c0c84.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 1]: /images/20210820/5c92c80c4ec54bebb7ff71d66b7137d7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 2]: /images/20210820/951b5e74738e47029dc3314f05806fce.png
[20201208143036373.png]: /images/20210820/18380fa8b3144eeebb3a7505399c5f49.png
[20201208161237751.png]: /images/20210820/390e9844fcae4956aa36191df01e3bad.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 3]: /images/20210820/af7c722a261346d3b60a84a77a835459.png
[20201208143633100.png]: /images/20210820/81aa1d40deb54caf97d9b55b9110af81.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 4]: /images/20210820/3ecb0724acb040919091ebba49e6afdb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 5]: /images/20210820/a69412f68c334f108f5fb9f11f068402.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 6]: /images/20210820/5c9f1396e3ac4e0c9d07c3d500c4642a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 7]: /images/20210820/e500c079c9e942e79941964efa66182c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 8]: /images/20210820/4d676fb7e3c84c0aaa19cd41222cef38.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 9]: /images/20210820/4355464ee63441358602ecf382f65b5a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 10]: /images/20210820/8157e92a337144748954b4b53d43c914.png
[20201208163935368.png]: /images/20210820/b4f034ce50654e1e8bffb65000c1fb70.png
[20201208164311775.png]: /images/20210820/17e1378626f44e5285531a6c45f67c93.png
[20201208164404858.png]: /images/20210820/7920b5e410604cbda1d26d6764bbc76d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODkxNDI1_size_16_color_FFFFFF_t_70 11]: /images/20210820/c1ec20b190944caebac76dcdd85d40af.png