Go Web轻量级框架Gin学习系列：多种数据响应格式

内容简介：我们在上面的例子中，我们定义了一个处理HTTP GET请求的方法，回调用函数的参数为下面列表出gin.Context中响应客户端的方法列表：

我们在《Go Web轻量级框架Gin学习系列：安装与使用》已经讲过如何安装Gin框架以及如何定义各种处理HTTP请求的方法了，这篇文章就接着讲讲接收到客户端请求后，怎么响应客户端请求以及有多种响应数据格式。

r.GET("/test",func(c *gin.Context){
    //省略处理请求的代码
})
复制代码

上面的例子中，我们定义了一个处理HTTP GET请求的方法，回调用函数的参数为 *gin.Context ,Gin框架在 *gin.Context 实例中封装了所以处理请求并响应客户端的方法，GGin支持多种响应方法，包括我们常见的 String , HTML , JSON , XML , YAML , JSONP ,也支持直接响应 Reader 和 []byte ，而且还支持重定向。

下面列表出gin.Context中响应客户端的方法列表：

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数据返回给客户端。

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官方文档：

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.im")  
    })
    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应用程序的开发，会大大提升开发速度与效率的。

以上就是本文的全部内容，希望本文的内容对大家的学习或者工作能带来一定的帮助，也希望大家多多支持码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

Essential C++中文版

[美] Stanley B. Lippman / 侯捷 / 华中科技大学出版社 / 2001-8 / 39.80元

书中以4个面向来表现C++的本质：procedural（程序性的）、generic（泛型的）、object-based（个别对象的）、object-oriented（面向对象的），全书围绕着一系列逐渐繁复的程序问题，以及用以解决这些问题的语言特性。循此方式，读者不只学到C++的函数和结构，也会学习到它们的设计目的和基本原理。一起来看看《Essential C++中文版》这本书的介绍吧!

码农工具