Gin响应

Gin框架提供了丰富的响应处理功能，使得开发者可以轻松地返回各种类型的响应数据，包括JSON、XML、HTML、文件等。以下是Gin框架响应处理的详细介绍：

1. 基本响应处理

1.1 返回JSON响应

Gin提供了简洁的方法返回JSON格式的数据。

router.GET("/json", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
        "message": "hello world",
        "status":  200,
    })
})

gin.H是一个快捷方式，表示map[string]interface{}。

1.2 返回XML响应

同样地，Gin也可以返回XML格式的数据。

router.GET("/xml", func(c *gin.Context) {
    c.XML(http.StatusOK, gin.H{
        "message": "hello world",
        "status":  200,
    })
})

1.3 返回HTML响应

Gin支持返回HTML页面。首先需要加载HTML模板，然后在处理函数中渲染模板。

router.LoadHTMLGlob("templates/*")

router.GET("/html", func(c *gin.Context) {
    c.HTML(http.StatusOK, "index.tmpl", gin.H{
        "title": "Main website",
    })
})

假设有一个模板文件templates/index.tmpl：

<html>
<head>
    <title>{{ .title }}</title>
</head>
<body>
    <h1>Hello, world!</h1>
</body>
</html>

2. 文件响应

2.1 返回文件

Gin可以返回文件给客户端。

router.GET("/file", func(c *gin.Context) {
    c.File("path/to/file")
})

2.2 返回文件附件

可以使用c.FileAttachment返回文件附件，提示用户下载。

router.GET("/file", func(c *gin.Context) {
    c.FileAttachment("path/to/file", "filename.ext")
})

3. 响应头部和状态码

3.1 设置响应头部

可以使用c.Header方法设置响应头部。

router.GET("/header", func(c *gin.Context) {
    c.Header("Content-Type", "application/json")
    c.JSON(http.StatusOK, gin.H{"message": "hello world"})
})

3.2 设置状态码

使用c.Status方法设置响应状态码。

router.GET("/status", func(c *gin.Context) {
    c.Status(http.StatusAccepted)
})

或者在返回数据时直接设置状态码：

router.GET("/json", func(c *gin.Context) {
    c.JSON(http.StatusCreated, gin.H{
        "message": "resource created",
    })
})

4. 自定义响应格式

4.1 返回字符串

使用c.String返回字符串。

router.GET("/string", func(c *gin.Context) {
    c.String(http.StatusOK, "hello world")
})

4.2 返回HTML

使用c.HTML返回HTML内容。

router.GET("/html", func(c *gin.Context) {
    c.HTML(http.StatusOK, "index.tmpl", gin.H{
        "title": "Main website",
    })
})

4.3 返回数据流

使用c.Data返回任意数据流。

router.GET("/data", func(c *gin.Context) {
    data := []byte("hello world")
    c.Data(http.StatusOK, "text/plain", data)
})

5. 重定向

Gin支持重定向功能。

router.GET("/redirect", func(c *gin.Context) {
    c.Redirect(http.StatusMovedPermanently, "https://www.google.com")
})

6. JSONP 响应

JSONP（JSON with Padding）用于跨域请求。

router.GET("/jsonp", func(c *gin.Context) {
    data := gin.H{
        "foo": "bar",
    }
    c.JSONP(http.StatusOK, data)
})

7. 流式响应

Gin支持流式响应，通过c.Stream方法实现。

router.GET("/stream", func(c *gin.Context) {
    c.Stream(func(w io.Writer) bool {
        w.Write([]byte("hello world\n"))
        return false
    })
})

8. 示例项目

结合上述各个方面，创建一个综合的示例项目，演示各种响应类型：

package main

import (
    "github.com/gin-gonic/gin"
    "net/http"
)

func main() {
    router := gin.Default()

    router.LoadHTMLGlob("templates/*")

    // JSON response
    router.GET("/json", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "hello world",
            "status":  200,
        })
    })

    // XML response
    router.GET("/xml", func(c *gin.Context) {
        c.XML(http.StatusOK, gin.H{
            "message": "hello world",
            "status":  200,
        })
    })

    // HTML response
    router.GET("/html", func(c *gin.Context) {
        c.HTML(http.StatusOK, "index.tmpl", gin.H{
            "title": "Main website",
        })
    })

    // File response
    router.GET("/file", func(c *gin.Context) {
        c.FileAttachment("path/to/file", "filename.ext")
    })

    // String response
    router.GET("/string", func(c *gin.Context) {
        c.String(http.StatusOK, "hello world")
    })

    // Data response
    router.GET("/data", func(c *gin.Context) {
        data := []byte("hello world")
        c.Data(http.StatusOK, "text/plain", data)
    })

    // Redirect
    router.GET("/redirect", func(c *gin.Context) {
        c.Redirect(http.StatusMovedPermanently, "https://www.google.com")
    })

    // JSONP response
    router.GET("/jsonp", func(c *gin.Context) {
        data := gin.H{
            "foo": "bar",
        }
        c.JSONP(http.StatusOK, data)
    })

    // Stream response
    router.GET("/stream", func(c *gin.Context) {
        c.Stream(func(w io.Writer) bool {
            w.Write([]byte("hello world\n"))
            return false
        })
    })

    router.Run(":8080")
}

通过这个详细的介绍，你可以掌握Gin框架中响应处理的各个方面，包括基本用法、文件响应、状态码设置、自定义响应格式、重定向、JSONP和流式响应。这样，你就能更灵活地构建和维护Gin框架下的Web应用。