binding

GitHub Workflow Status Codecov GoDoc Sourcegraph

Package binding is a middleware that provides request data binding and validation for Flamego.

Installation

The minimum requirement of Go is 1.16.

  1. go get github.com/flamego/binding

Getting started

  1. package main
  3. import (
  4.     "fmt"
  5.     "net/http"
  7.     "github.com/flamego/binding"
  8.     "github.com/flamego/flamego"
  9. )
  11. type address struct {
  12.     Street string `json:"street" validate:"required"`
  13.     City   string `json:"city" validate:"required"`
  14.     Planet string `json:"planet" validate:"required"`
  15.     Phone  string `json:"phone" validate:"required"`
  16. }
  18. type user struct {
  19.     FirstName string     `json:"first_name" validate:"required"`
  20.     LastName  string     `json:"last_name" validate:"required"`
  21.     Age       uint8      `json:"age" validate:"gte=0,lte=130"`
  22.     Email     string     `json:"email" validate:"required,email"`
  23.     Addresses []*address `json:"addresses" validate:"required,dive,required"`
  24. }
  26. func main() {
  27.     f := flamego.Classic()
  28.     f.Post("/", binding.JSON(user{}), func(c flamego.Context, form user, errs binding.Errors) {
  29.         if len(errs) > 0 {
  30.             c.ResponseWriter().WriteHeader(http.StatusBadRequest)
  31.             _, _ = c.ResponseWriter().Write([]byte(fmt.Sprintf("Oops! Error occurred: %v", errs[0].Err)))
  32.             return
  33.         }
  35.         fmt.Printf("Name: %s %s\n", form.FirstName, form.LastName)
  36.     })
  37.     f.Run()
  38. }

Getting help

License

This project is under the MIT License. See the LICENSE file for the full license text.