Go Web輕量級框架Gin學習系列：多種數據響應格式

原創做者，公衆號【程序員讀書】，歡迎關注公衆號，轉載文章請註明出處哦。html

咱們在《Go Web輕量級框架Gin學習系列：安裝與使用》已經講過如何安裝Gin框架以及如何定義各類處理HTTP請求的方法了，這篇文章就接着講講接收到客戶端請求後，怎麼響應客戶端請求以及有多種響應數據格式。git

r.GET("/test",func(c *gin.Context){
    //省略處理請求的代碼
})
複製代碼

上面的例子中，咱們定義了一個處理HTTP GET請求的方法，回調用函數的參數爲*gin.Context,Gin框架在*gin.Context實例中封裝了因此處理請求並響應客戶端的方法，Gin支持多種響應方法，包括咱們常見的String,HTML,JSON,XML,YAML,JSONP,也支持直接響應Reader和[]byte，並且還支持重定向。程序員

下面列表出gin.Context中響應客戶端的方法列表：github

func (c *Context) AsciiJSON(code int, obj interface{})
func (c *Context) Data(code int, contentType string, data []byte)
func (c *Context) DataFromReader(code int, contentLength int64, contentType string,
reader io.Reader, extraHeaders map[string]string)
func (c *Context) HTML(code int, name string, obj interface{})
func (c *Context) IndentedJSON(code int, obj interface{})
func (c *Context) JSON(code int, obj interface{})
func (c *Context) JSONP(code int, obj interface{})
func (c *Context) ProtoBuf(code int, obj interface{})
func (c *Context) PureJSON(code int, obj interface{})
func (c *Context) Redirect(code int, location string)
func (c *Context) Render(code int, r render.Render)
func (c *Context) SecureJSON(code int, obj interface{})
func (c *Context) String(code int, format string, values ...interface{})
func (c *Context) XML(code int, obj interface{})
func (c *Context) YAML(code int, obj interface{})
複製代碼

下面是多種響應數據格式的詳細講：編程

JSON

json是輕量級數據交互格式，應用很普遍，尤爲是Web API服務方面，所以Gin框架爲JSON提供了支持，使用gin.Context中的JSON方法將格式化後的JSON數據返回給客戶端。json

package main
import (
    "github.com/gin-gonic/gin"
    "net/http"
)
type User struct {
    Uid      int    `json:"uid" xml:"uid"`
    Username string `json:"username" xml:"username"`
}
func main() {
    r := gin.Default()
    r.GET("test", func(c *gin.Context) {
        data := &User{Uid:1,Username:"測試帳號"}
        c.JSON(http.StatusOK,data)
    })
    r.Run()
}
複製代碼

XML,YAML,String

響應XML、YAML或String格式的數據，處理方式如同JSON同樣，Gin都提供相應的函數，示例以下：跨域

//xml
r.GET("xml",func(c *gin.Context){
    data := gin.H{"xml":"Hello World"}
    c.XML(200,data)
})
//yaml
r.GET("yaml",func(c *gin.Context){
    data := gin.H{"xml":"Hello World"}
    c.YAML(200,data)
})
//string
r.GET("yaml",func(c *gin.Context){
    c.String(200,"Hello World")
})
複製代碼

上面的例子中，咱們使用了一個叫gin.H類型，實際gin.H在gin包中的定義以下：數組

type H map[string]interface{}
複製代碼

Protobuf

Protobuf是一種與平臺無關和語言無關，且可擴展且輕便高效的序列化數據結構的協議，能夠用於網絡通訊和數據存儲，其實序列化的速度要比JSON和XML快，但其易用性和可閱讀性遠不如JSON和XML，所以並無普遍使用。瀏覽器

不過Gin也爲Protobuf數據響應提供了支持，如下例子來自Gin官方文檔：bash

r.GET("/someProtoBuf", func(c *gin.Context) {
    reps := []int64{int64(1), int64(2)}
    label := "test"
    // protobuf 的具體定義寫在 testdata/protoexample 文件中。
    data := &protoexample.Test{
        Label: &label,
        Reps:  reps,
    }
    // 請注意，數據在響應中變爲二進制數據
    // 將輸出被 protoexample.Test protobuf 序列化了的數據
    c.ProtoBuf(http.StatusOK, data)
})
複製代碼

HTML渲染

Gin也支持傳統Web編程中的HTML模板渲染，直接返回HTML代碼給客戶端，主要步驟以下：

1. 定義HTML模板

HTML模板文件：templates/index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
    <body>
    {{.foo}}
    </body>
</html>
複製代碼

2. 加載模板

定義好模板以後，在渲染以前，要使用gin.Engine中的LoadHTMLFiles()或LoadHTMLGlob()方法加載模板。

LoadHTMLFiles(files ...string)方法能夠接收一個或多個參數，用於加載單個或多個模板文件。

r := gin.Default()
r.LoadHTMLFiles("./templates/index.html")
複製代碼

LoadHTMLGlob(pattern string)方法則用於加載整個目錄下的模板文件，若是目錄不存在或目錄下沒有模板文件會引起panic錯誤。

r := gin.Default()
r.LoadHTMLGlob("./templates/*")
複製代碼

3. 完整示例

func main() {
    r := gin.Default()
    r.LoadHTMLFiles("./templates/index.html")
    //r.LoadHTMLGlob("./templates/*")
    r.GET("html", func(c *gin.Context) {
        data := map[string]interface{}{
            "foo": "bar",
        }
        c.HTML(http.StatusOK,"index.html",data)
    })
    r.Run()
}
複製代碼

JSONP

JSONP是一種基於JSON，而用於解決瀏覽器跨域訪問問題的機制，使用gin.Context的JSONP()返回數據時，會將URL中的callback參數按照JSONP的數據格式放在json數據前面,並返回給客戶端。

func main() {
    r := gin.Default()
    r.GET("/JSONP?callback=test", func(c *gin.Context) {
        data := map[string]interface{}{
            "foo": "bar",
        }
        c.JSONP(http.StatusOK,data)
    })
    r.Run()
}
複製代碼

Reader

使用gin.Context中的DataFromReader()方法，能夠直接從Reader讀取數據，下面演示一個下載圖片的HTTP請求：

func main() {
    r := gin.Default()
    r.GET("file", func(c *gin.Context) {
        fileName := "./1.jpg"
        file, _ := os.Open(fileName)
        fileInfo, _ := os.Lstat(fileName)
        extraHeaders := map[string]string{
            "Content-Disposition": `attachment; filename="` + fileName + `"`,
        }
        c.DataFromReader(200, fileInfo.Size(), "image/png", file, extraHeaders)
    })
    r.Run()
}
複製代碼

字節數組

使用gin.Context中的Data()方法，能夠返回一個字節數組([]byte)給客戶端，下面的例子演示從圖片中讀取二進制數組並返回給客戶端。

func main() {
    r := gin.Default()
    r.GET("file", func(c *gin.Context) {
        file, _ := os.Open("./1.jpg")
        b, _ := ioutil.ReadAll(file)
        c.Data(200, "image/png", b)
    })
    r.Run()
}
複製代碼

重定向

除了返回不一樣格式的數據給客戶端，Gin框架也支持重定向操做，重定向分爲外部和內部重定向。

1. 外部重定向

用於跳轉其餘外部的連接。

func main(){
    r := gin.Default()
    r.GET("Redirect",func(c *gin.Context){
        c.Redirect(http.StatusMovedPermanently,"https://juejin.cn")  
    })
    r.Run()
}
複製代碼

2. 內部重定向

用於跳轉內部路由。

func main() {
    r := gin.Default()
    r.GET("test", func(c *gin.Context) {
        c.Request.URL.Path = "/profile"
        r.HandleContext(c)
    })
    r.GET("profile", func(c *gin.Context) {
        username := c.Query("username")
        fmt.Println(username)
        c.JSON(200, gin.H{"user": "profile"})
    })
    r.Run()
}
複製代碼

小結

從上面的多個例子中能夠看到Gin響應Web請求的良好封裝，所以使用Gin進入Web應用程序的開發，會大大提高開發速度與效率的。

你的關注，是我寫做路上最大的鼓勵！