binding

Documentation

Index

• Variables
• func Bind(c fiber.Ctx, obj interface{}) error
• func BindJSON(c fiber.Ctx, obj interface{}) error
• func BindQuery(c fiber.Ctx, obj interface{}) error
• func BindUri(c fiber.Ctx, obj interface{}) error
• func BindXML(c fiber.Ctx, obj interface{}) error
• func BindYAML(c fiber.Ctx, obj interface{}) error
• func MustBindWith(c fiber.Ctx, obj interface{}, b Binding) error
• func NewReq[REQ any](c fiber.Ctx) (*REQ, error)
• func RegisterBodyBinding(name string, unmarshaller func(data []byte, obj any) error)
• func ShouldBind(c fiber.Ctx, obj interface{}) error
• func ShouldBindJSON(c fiber.Ctx, obj interface{}) error
• func ShouldBindQuery(c fiber.Ctx, obj interface{}) error
• func ShouldBindUri(c fiber.Ctx, obj interface{}) error
• func ShouldBindWith(c fiber.Ctx, obj interface{}, b Binding) error
• func ShouldBindXML(c fiber.Ctx, obj interface{}) error
• func ShouldBindYAML(c fiber.Ctx, obj interface{}) error
• type Binding
  • func Body(contentType []byte) Binding
  • func Default(method string, contentType []byte) Binding
• type BindingBody

Variables

var (
	CustomBody    = bodyBinding{/* contains filtered or unexported fields */}
	Query         = queryBinding{}
	FormPost      = formPostBinding{}
	FormMultipart = formMultipartBinding{}
	Uri           = uriBinding{}
	Header        = headerBinding{}
)

Functions

func Bind

func Bind(c fiber.Ctx, obj interface{}) error

func BindJSON

func BindJSON(c fiber.Ctx, obj interface{}) error

BindJSON is a shortcut for c.MustBindWith(obj, binding.JSON).

func BindQuery

func BindQuery(c fiber.Ctx, obj interface{}) error

BindQuery is a shortcut for c.MustBindWith(obj, binding.Query).

func BindUri

func BindUri(c fiber.Ctx, obj interface{}) error

MustBindWith binds the passed struct pointer using the specified binding engine. BindUri binds the passed struct pointer using binding.Uri. It will abort the request with HTTP 400 if any error occurs.

func BindXML

func BindXML(c fiber.Ctx, obj interface{}) error

BindXML is a shortcut for c.MustBindWith(obj, binding.BindXML).

func BindYAML

func BindYAML(c fiber.Ctx, obj interface{}) error

BindYAML is a shortcut for c.MustBindWith(obj, binding.YAML).

func MustBindWith

func MustBindWith(c fiber.Ctx, obj interface{}, b Binding) error

MustBindWith binds the passed struct pointer using the specified binding engine. It will abort the request with HTTP 400 if any error occurs. See the binding package.

func NewReq

func NewReq[REQ any](c fiber.Ctx) (*REQ, error)

func RegisterBodyBinding

func RegisterBodyBinding(name string, unmarshaller func(data []byte, obj any) error)

func ShouldBind

func ShouldBind(c fiber.Ctx, obj interface{}) error

ShouldBind checks the Content-Type to select a binding engine automatically, Depending the "Content-Type" header different bindings are used:

"application/json" --> JSON binding
"application/xml"  --> XML binding

otherwise --> returns an error It parses the request's body as JSON if Content-Type == "application/json" using JSON or XML as a JSON input. It decodes the json payload into the struct specified as a pointer. Like c.GinBind() but this method does not set the response status code to 400 and abort if the json is not valid.

func ShouldBindJSON

func ShouldBindJSON(c fiber.Ctx, obj interface{}) error

ShouldBindJSON is a shortcut for c.ShouldBindWith(obj, binding.JSON).

func ShouldBindQuery

func ShouldBindQuery(c fiber.Ctx, obj interface{}) error

ShouldBindQuery is a shortcut for c.ShouldBindWith(obj, binding.Query).

func ShouldBindUri

func ShouldBindUri(c fiber.Ctx, obj interface{}) error

ShouldBindUri binds the passed struct pointer using the specified binding engine.

func ShouldBindWith

func ShouldBindWith(c fiber.Ctx, obj interface{}, b Binding) error

ShouldBindWith binds the passed struct pointer using the specified binding engine. See the binding package.

func ShouldBindXML

func ShouldBindXML(c fiber.Ctx, obj interface{}) error

ShouldBindXML is a shortcut for c.ShouldBindWith(obj, binding.XML).

func ShouldBindYAML

func ShouldBindYAML(c fiber.Ctx, obj interface{}) error

ShouldBindYAML is a shortcut for c.ShouldBindWith(obj, binding.YAML).

Types

type Binding

type Binding interface {
	Name() string

	Bind(fiber.Ctx, interface{}) error
}

func Body

func Body(contentType []byte) Binding

func Default

func Default(method string, contentType []byte) Binding

type BindingBody

type BindingBody interface {
	Binding
	BindBody([]byte, interface{}) error
}