Pular para o conteúdo
Gin Web Framework

Renderização

O Gin suporta renderização de respostas em múltiplos formatos incluindo JSON, XML, YAML, ProtoBuf, HTML e mais. Todo método de renderização segue o mesmo padrão: chame um método no *gin.Context com um código de status HTTP e os dados a serem serializados. O Gin cuida dos headers de content-type, serialização e escrita da resposta automaticamente.

// All rendering methods share this pattern:
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

Você pode usar o header Accept ou um parâmetro de query para servir os mesmos dados em múltiplos formatos a partir de um único handler:

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")
}

Nesta seção