GIN学习笔记

GIN学习笔记一

引用：路由是自定义url地址执行指定的函数，良好的路由定义可以对seo起到很好的效果。

1.基本路由

gin框架封装了http库，提供了GET POST PUT DELETE PATCH HEAD OPTIONS这些http请求方法。使用router.method()来绑定路由

func (group *RouterGroup) METHOD(relativePath string, handlers ...HandlerFunc) IRoutes

router := gin.Default()

router.GET("/get", func(c *gin.Context) { c.JSON(200, gin.H{"message": "get方法"}) })

router.POST("/post", func(c *gin.Context) { c.JSON(200, gin.H{"message": "post方法"}) })

router.PUT("/put", func(c *gin.Context) { c.JSON(200, gin.H{"message": "put方法"}) })

router.DELETE("/delete", func(c *gin.Context) { c.JSON(200, gin.H{"message": "delete"}) })

router.PATCH("/patch", func(c *gin.Context) { c.JSON(200, gin.H{"message": "patch"}) })

router.HEAD("/head", func(c *gin.Context) { c.JSON(200, gin.H{"message": "head"}) })

router.OPTIONS("/options", func(c *gin.Context) { c.JSON(200, gin.H{"message": "options"}) })

router.Run(":9999")//指定端口  localhost:9999

2.路由参数

• 获取URL路径全部参数

以/为分隔符，每个参数以“：”为参数表示动态变量，会自动绑定到路由对应参数上

路由规则：[:]表示可以不用匹配

c.Params("key")
//http://localhost:8080/user/李四/20/北京/男
router.GET("/user/:name/:age/:address/:sex", func(c *gin.Context) {
    //打印URL中所有参数
    //"[{name 李四} {age 20} {address 北京} {sex 男}]\n"
    c.JSON(http.StatusOK, fmt.Sprintln(c.Params))
})

访问：http://localhost:8080/user/李四/20/北京/男

结果：“[{name 李四} {age 20} {address 北京} {sex 男}]\n”

• 获取URL路径单个参数

使用`gin.Contex对象的Param(key)方法获得某一个key的值，声明方法如下

//http://localhost:8080/login/15949629528/123456
router.GET("/login/:name/:password", func(c *gin.Context) {
  c.JSON(http.StatusOK, gin.H{
    //{ name: "15949629528", password: "123456" }
    "name":     c.Param("name"),
    "password": c.Param("password"),
  })
})
    

访问：http://localhost:8080/login/15949629528/123456

结果：{ name: “15949629528”, password: “123456” }

• 获取URL中指定的参数【GET、POST请求】

获取URL中路径值和获取参数不一样

声明如下
func (c *Context) Query(key string) string

//GET请求
router.GET("/login", func(c *gin.Context) {
  //{ name: "张三", password: "123456" }
  c.JSON(http.StatusOK, gin.H{
    "name":     c.Query("name"),
    "password": c.Query("password"),
  })
})

//POST请求
router.POST("/login", func(c *gin.Context) {
	//{"name":"张三","password":"123456"}
	c.JSON(http.StatusOK, gin.H{
		"name":     c.Query("name"),
		"password": c.Query("password"),
	})
})

访问:http://localhost:8080/login?name=张三&password=123456

结果：{ name: “张三”, password: “123456” }

• 获取指定默认值的参数的【带有默认值的接收】【GET、POST请求】

gin.Context.DefaultQuery()方法，允许你指定接收的参数名，以及没有接收到该参数时，设置的默认值

方法声明如下
func (c *Context) DefaultQuery(key, defaultValue string) string

只有当请求没有携带key，那么此时的默认值就会生效。其他情况，默认值不生效。即使URL中的该key的值为空，那么也不会启用默认值，获取的值就是空。

//GET请求
router.GET("/user", func(c *gin.Context) {
  //{ name: "张三", password: "123456" }
  c.JSON(http.StatusOK, gin.H{
    "name":     c.DefaultQuery("name", "默认张三"),
    "password": c.DefaultQuery("password", "默认密码"),
  })
})

//POST请求
router.POST("/user", func(c *gin.Context) {
//{"name":"张三","password":"默认密码"}
	c.JSON(http.StatusOK, gin.H{
	  "name":     c.DefaultQuery("name", "默认张三"),
	  "password": c.DefaultQuery("password", "默认密码"),
	})
})

访问：http://localhost:8080/user?password=

输出内容如下：{ name: “默认张三”, password: “默认密码” }