コンテンツにスキップ

レンダリング

Ginは、JSON、XML、YAML、ProtoBuf、HTMLなど、複数のフォーマットでのレスポンスレンダリングをサポートしています。すべてのレンダリングメソッドは同じパターンに従います:*gin.ContextのメソッドにHTTPステータスコードとシリアライズするデータを渡して呼び出します。Ginはコンテンツタイプヘッダー、シリアライズ、レスポンスの書き込みを自動的に処理します。

// すべてのレンダリングメソッドはこのパターンに従います:
c.JSON(http.StatusOK, data) // application/json
c.XML(http.StatusOK, data) // application/xml
c.YAML(http.StatusOK, data) // application/x-yaml
c.TOML(http.StatusOK, data) // application/toml
c.ProtoBuf(http.StatusOK, data) // application/x-protobuf

Acceptヘッダーやクエリパラメータを使用して、単一のハンドラから同じデータを複数のフォーマットで提供できます:

package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.GET("/user", func(c *gin.Context) {
user := gin.H{"name": "Lena", "role": "admin"}
switch c.Query("format") {
case "xml":
c.XML(http.StatusOK, user)
case "yaml":
c.YAML(http.StatusOK, user)
default:
c.JSON(http.StatusOK, user)
}
})
router.Run(":8080")
}

このセクションの内容