Pular para o conteúdo
Gin Web Framework

Binding Multipart/Urlencoded

ShouldBind detecta automaticamente o Content-Type e vincula corpos de requisição multipart/form-data ou application/x-www-form-urlencoded em uma struct. Use a tag de struct form para mapear os nomes dos campos do formulário para os campos da struct, e binding:"required" para impor campos obrigatórios.

Isso é comumente usado para formulários de login, páginas de registro ou qualquer envio de formulário HTML.

package main


import (
  "net/http"


  "github.com/gin-gonic/gin"
)


type LoginForm struct {
  User     string `form:"user" binding:"required"`
  Password string `form:"password" binding:"required"`
}


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


  router.POST("/login", func(c *gin.Context) {
    var form LoginForm
    // ShouldBind automatically selects the right binding based on Content-Type
    if err := c.ShouldBind(&form); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }


    if form.User == "user" && form.Password == "password" {
      c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
    } else {
      c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
    }
  })


  router.Run(":8080")
}

Teste

Terminal window
# Multipart form
curl -X POST http://localhost:8080/login \
  -F "user=user" -F "password=password"
# Output: {"status":"you are logged in"}


# URL-encoded form
curl -X POST http://localhost:8080/login \
  -d "user=user&password=password"
# Output: {"status":"you are logged in"}


# Wrong credentials
curl -X POST http://localhost:8080/login \
  -d "user=wrong&password=wrong"
# Output: {"status":"unauthorized"}


# Missing required field
curl -X POST http://localhost:8080/login \
  -d "user=user"
# Output: {"error":"Key: 'LoginForm.Password' Error:Field validation for 'Password' failed on the 'required' tag"}

Veja também