1. 路由

1.1 基本路由（无参路由）

gin 框架中采用的路由库是基于 httprouter (opens new window) 做的。

package main
import (
	"fmt"
	"net/http"
	"github.com/gin-gonic/gin"
)
func HelloWorldHandler(c *gin.Context) {
	// gin.Context，封装了request和response
	c.String(http.StatusOK, "hello World!")
}
func main() {
	// 1.创建路由
	r := gin.Default()
	// 2.绑定路由规则，执行的函数
	// 基本路由 /hello/
	r.GET("/hello", HelloWorldHandler)
	// 3.监听端口，默认在8080
	fmt.Println("运行地址：http://127.0.0.1:8000")
	r.Run(":8000")
}

1.2 api参数

可以通过Context的Param方法来获取API参数。

package main
import (
	"fmt"
	"net/http"
	"github.com/gin-gonic/gin"
)
func GetBookDetailHandler(c *gin.Context) {
	bookId := c.Param("id")
	// gin.Context，封装了request和response
	c.String(http.StatusOK, fmt.Sprintf("成功获取书籍详情：%s", bookId))
}
func main() {
	// 1.创建路由
	r := gin.Default()
	// 2.绑定路由规则，执行的函数
	// 基本路由 /book/24/
	r.GET("/book/:id", GetBookDetailHandler)
	// 3.监听端口，默认在8080
	fmt.Println("运行地址：http://127.0.0.1:8000/book/24/")
	r.Run(":8000")
}

1.3 url参数

• URL参数可以通过DefaultQuery()或Query()方法获取
• DefaultQuery()若参数不存在，返回默认值，Query()若不存在，返回空串
• http://127.0.0.1:8080/user?name=zhangsan

package main
import (
	"fmt"
	"net/http"
	"github.com/gin-gonic/gin"
)
func GetUserDetailHandler(c *gin.Context) {
	//username := c.DefaultQuery("name", "xxx")
	username := c.Query("name")
	// gin.Context，封装了request和response
	c.String(http.StatusOK, fmt.Sprintf("姓名：%s", username))
}
func main() {
	// 1.创建路由
	r := gin.Default()
	// 2.绑定路由规则，执行的函数
	// 基本路由 /user?name=root
	r.GET("/user/", GetUserDetailHandler)
	// 3.监听端口，默认在8080
	fmt.Println("运行地址：http://127.0.0.1:8000/user?name=root")
	r.Run(":8000")
}

1.4 routes group

routes group是为了管理一些相同的URL

package main

import (
   "github.com/gin-gonic/gin"
   "fmt"
)

// gin的helloWorld
func main() {
   // 1.创建路由
   // 默认使用了2个中间件Logger(), Recovery()
   r := gin.Default()
   // 路由组1 ，处理GET请求
   v1 := r.Group("/v1")
   // {} 是书写规范
   {
      v1.GET("/login", login)
      v1.GET("submit", submit)
   }
   v2 := r.Group("/v2")
   {
      v2.POST("/login", login)
      v2.POST("/submit", submit)
   }
   r.Run(":8000")
}

func login(c *gin.Context) {
   name := c.DefaultQuery("name", "jack")
   c.String(200, fmt.Sprintf("hello %s\n", name))
}

func submit(c *gin.Context) {
   name := c.DefaultQuery("name", "lily")
   c.String(200, fmt.Sprintf("hello %s\n", name))
}

1.5 路由重定向

HTTP重定向

r.GET("/test", func(c *gin.Context) {
	c.Redirect(http.StatusMovedPermanently, "http://www.sogo.com/")
})

路由重定向

r.GET("/test", func(c *gin.Context) {
    // 指定重定向的URL
    c.Request.URL.Path = "/test2"
    r.HandleContext(c)
})
r.GET("/test2", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{"hello": "world"})
})