Go-web(一)Gin路由和请求

以你之姓@ 2022-10-21 12:53 242阅读 0赞

### 文章目录 ###

*  Go-web(一)Gin框架
 *   *  简介
     *   *  hello world
     *  Gin基础
     *   *  1.路由
         *   *  a.路由
             *  b.路由组
             *  c.路由拆分和注册
         *  2. 请求参数
         *   *  Get
             *   *  a.url参数
                 *  b.restful参数
             *  Post
             *   *  a.表单参数
                 *  b.body参数

# Go-web(一)Gin框架 #

## 简介 ##

Gin是一个golang的微框架，封装比较优雅，API友好，源码注释比较明确，具有快速灵活，容错方便等特点

安装：

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

我在安装过程中，有以下的包没有成功安装，采用了手动下载然后放到gopath下

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70]

### hello world ###

/**
     * gin版本hello world
     */
    func GinHelloWorld()  {
        
    	r := gin.Default()
    	// gin.Context，封装了request和response
    	r.GET("/hello_gin", func(context *gin.Context) {
        
    		context.String(http.StatusOK,"hello world")
    	})
    	r.Run(":8080")
    }

访问localhost:8080/hello\_gin

![在这里插入图片描述][20210504170653541.png]

## Gin基础 ##

### 1.路由 ###

#### a.路由 ####

// 路由
    func GinRoute()  {
        
    	// 默认路由器
    	r := gin.Default()
    	// get请求
    	r.GET("/get", func(context *gin.Context) {
        
    		// 路由处理函数
    	})
    	// post请求
    	r.POST("/post", func(context *gin.Context) {
        
    	})
    	// put请求
    	r.PUT("/put", func(context *gin.Context) {
        
    	})
    	// delete请求
    	r.DELETE("delete", func(context *gin.Context) {
        
    	})
    }

#### b.路由组 ####

routes group是为了管理一些相同的URL，就是相当于在controller类上加上@RequestMapping()，相当于url的公共前缀

// 路由组
    	v1 := r.Group("/v1")
    	v1.GET("/vv1", func(context *gin.Context) {
        
    		// url: /v1/vv1
    		context.String(200,"vv1")
    	})
    	v2 := r.Group("/v2")
    	v2.GET("/vv2", func(context *gin.Context) {
        
    		// url: /v2/vv2
    		context.String(200,"vv2")
    	})

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 1]

#### c.路由拆分和注册 ####

上面那种只能应用于简单的项目或者demo中

当项目的规模增大后就不太适合继续在项目的main.go文件中去实现路由注册相关逻辑了，我们会倾向于把路由部分的代码都拆分出来，形成一个单独的文件或包：

- service
    - controller
        - handlers
        - routes
    - main

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 2]

在routes包中可以分类管理路由：

bookRoute.go

func BookRoute(r *gin.Engine)  {
        
    	// 注册book相关路由
    	r.GET("/getBook",handle.MyGetBookhandler)
    	r.POST("/addBook",handle.AddBookHandler)
    }

userRoute.go

func UserRoute(r *gin.Engine)  {
        
    	r.POST("/user",handle.AddUser)
    }

统一注册：

// 路由注册函数
    func SetupRouter() *gin.Engine {
        
    	r := gin.Default()
    	// 将子路由模块set
    	BookRoute(r)
    	UserRoute(r)
    	return r
    }

处理器函数分别调用service层：

func AddUser(r *gin.Context)  {
        
    	// 调用service
    }

在main函数中：

func main()  {
        
    	r := route.SetupRouter()
    	if err := r.Run(":8080");err != nil{
        
    		fmt.Println("startup service failed, err:%v\n", err)
    	}
    }

参考：

*  [路由拆分和注册][Link 1]

### 2. 请求参数 ###

#### Get ####

##### a.url参数 #####

url参数即get请求中的请求参数，即url后明文拼接的参数，可以通过Query()和DefaultQuery()获取

*  Query()相当于springMvc中的注解@RequestParam()，若不存在则返回空字符串
 *  DefaultQuery()在在Query获取不到相应字段时

// url参数
    	r.GET("/getUrlParams", func(context *gin.Context) {
        
    		name := context.Query("name")
    		age := context.Query("age")
    		defaultParam := context.DefaultQuery("testDefault","testtest")
    		context.JSON(http.StatusOK,map[string]interface{
        }{
        
    			"name":name,
    			"age":age,
    			"defaultValue":defaultParam,
    		})
    	})

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 3]

##### b.restful参数 #####

// api参数
    	r.GET("/getParams/:name/:age", func(context *gin.Context) {
        
    		// context封装了请求和响应
    		name := context.Param("name")
    		age := context.Param("age")
    		fmt.Println(name)
    		fmt.Println(age)
    		// 返回json
    		context.JSONP(http.StatusOK,name + " " + age)
    	})

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 4]

#### Post ####

##### a.表单参数 #####

<!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>Document</title>
    </head>
    <body>
    <form action="http://localhost:8080/form" method="post" action="application/x-www-form-urlencoded">
        用户名：<input type="text" name="username" placeholder="请输入你的用户名">  <br>
        密   码：<input type="password" name="userpassword" placeholder="请输入你的密码">  <br>
        <input type="submit" value="提交">
    </form>
    </body>
    </html>

// 表单参数
    	r.POST("/form", func(context *gin.Context) {
        
    		// 获取表单参数
    		username := context.PostForm("username")
    		password := context.PostForm("password")
    		context.JSON(http.StatusOK,map[string]interface{
        }{
        
    			"userName":username,
    			"password":password,
    		})
    	})

![在这里插入图片描述][20210505001051299.png]

##### b.body参数 #####

接收请求体的body，将body转为json后处理也是现在前后端分离的交互方式

定义接收数据结构：标签中json是你body中如果使用json的话，就是key

// 定义接收数据的数据结构即body
    type ReqBody struct {
        
    	// binding:"required"修饰的字段，若接收为空值，则报错，是必须字段
    	UserName string `form:"username" json:"userName" xml:"userName" binding:"required"`
    	Password int `form:"password" json:"password" xml:"password" binding:"required"`
    }

handler函数：

// 接收并解析请求中的body参数
    	r.POST("/post", func(context *gin.Context) {
        
    		var body ReqBody
    		if err := context.ShouldBindJSON(&body);err != nil{
        
    			log.Fatal("解析body错误：",err)
    			// gin.H封装了生成json数据的工具
    			context.JSON(http.StatusBadRequest,gin.H{
        "error":err})
    		}
    		// 解析正确
    		context.JSON(http.StatusOK,gin.H{
        "body":body})
    	})

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 5]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70]: /images/20221021/308954c261754b1c8ac9f826b480a47e.png
[20210504170653541.png]: /images/20221021/e4fee407a4824c1e8ae56e28493dada5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 1]: /images/20221021/347164067226487d84ae3634a0e05b2f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 2]: /images/20221021/64dc8814abc44889887f1ec2ae4c5fad.png
[Link 1]: https://www.liwenzhou.com/posts/Go/gin_routes_registry/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 3]: /images/20221021/f0d7ebdfaa264787b410e5a0ed035541.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 4]: /images/20221021/538787a8f89842fea9881e6fbb87c09b.png
[20210505001051299.png]: /images/20221021/9477435eec754738a236e5f16e2a63b8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTkyMjI4OQ_size_16_color_FFFFFF_t_70 5]: /images/20221021/4d5b5b3b52254ae9bb21d0e9d7e84215.png