binding

Documentation

Index

• Constants
• Variables
• func MapFormWithTag(ptr any, form map[string][]string, tag string) error
• type Binding
  • func Default(method, contentType string) Binding
• type BodyBinding
• type FieldBindError
  • func (fbe *FieldBindError) Error() string
  • func (fbe *FieldBindError) Unwrap() error
• type FieldBindErrors
  • func (fbes FieldBindErrors) As(err any) bool
  • func (fbes FieldBindErrors) Error() string
  • func (fbes FieldBindErrors) Unwrap() []error
• type JsonBindError
  • func (jbe *JsonBindError) Error() string
  • func (jbe *JsonBindError) Unwrap() error
• type URIBinding
• type XmlBindError
  • func (xbe *XmlBindError) Error() string
  • func (xbe *XmlBindError) Unwrap() error

Constants

const (
	MIMEJSON              = "application/json"
	MIMEHTML              = "text/html"
	MIMEXML               = "application/xml"
	MIMEXML2              = "text/xml"
	MIMEPlain             = "text/plain"
	MIMEPOSTForm          = "application/x-www-form-urlencoded"
	MIMEMultipartPOSTForm = "multipart/form-data"
)

Content-Type MIME of the most common data formats.

Variables

var (
	JSON          BodyBinding = jsonBinding{}
	XML           BodyBinding = xmlBinding{}
	Form          Binding     = formBinding{}
	Query         Binding     = queryBinding{}
	FormPost      Binding     = formPostBinding{}
	FormMultipart Binding     = formMultipartBinding{}
	URI           URIBinding  = uriBinding{}
	Header        Binding     = headerBinding{}
)

These implement the Binding interface and can be used to bind the data present in the request to struct instances.

var (

	// ErrConvertMapStringSlice can not covert to map[string][]string
	ErrConvertMapStringSlice = errors.New("can not convert to map slices of strings")

	// ErrConvertToMapString can not convert to map[string]string
	ErrConvertToMapString = errors.New("can not convert to map of strings")
)

var (
	// ErrMultiFileHeader multipart.FileHeader invalid
	ErrMultiFileHeader = errors.New("unsupported field type for multipart.FileHeader")

	// ErrMultiFileHeaderLenInvalid array for []*multipart.FileHeader len invalid
	ErrMultiFileHeaderLenInvalid = errors.New("unsupported len of array for []*multipart.FileHeader")
)

var EnableDecoderDisallowUnknownFields = false

EnableDecoderDisallowUnknownFields is used to call the DisallowUnknownFields method on the JSON Decoder instance. DisallowUnknownFields causes the Decoder to return an error when the destination is a struct and the input contains object keys which do not match any non-ignored, exported fields in the destination.

var EnableDecoderUseNumber = false

EnableDecoderUseNumber is used to call the UseNumber method on the JSON Decoder instance. UseNumber causes the Decoder to unmarshal a number into an any as a Number instead of as a float64.

Functions

func MapFormWithTag

func MapFormWithTag(ptr any, form map[string][]string, tag string) error

Types

type Binding

type Binding interface {
	Name() string
	Bind(*http.Request, any) error
}

Binding describes the interface which needs to be implemented for binding the data present in the request such as JSON request body, query parameters or the form POST.

func Default

func Default(method, contentType string) Binding

Default returns the appropriate Binding instance based on the HTTP method and the content type.

type BodyBinding

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

BodyBinding adds BindBody method to Binding. BindBody is similar with Bind, but it reads the body from supplied bytes instead of req.Body.

type FieldBindError

type FieldBindError struct {
	Err    error
	Field  string
	Values []string
}

FieldBindError bind error

func (*FieldBindError) Error

func (fbe *FieldBindError) Error() string

Error return a string representing the bind error

func (*FieldBindError) Unwrap

func (fbe *FieldBindError) Unwrap() error

type FieldBindErrors

type FieldBindErrors []*FieldBindError

FieldBindErrors bind errors

func (FieldBindErrors) As

func (fbes FieldBindErrors) As(err any) bool

func (FieldBindErrors) Error

func (fbes FieldBindErrors) Error() string

Error return a string representing the bind errors

func (FieldBindErrors) Unwrap

func (fbes FieldBindErrors) Unwrap() []error

type JsonBindError

type JsonBindError struct {
	Err error
}

func (*JsonBindError) Error

func (jbe *JsonBindError) Error() string

Error return a string representing the bind error

func (*JsonBindError) Unwrap

func (jbe *JsonBindError) Unwrap() error

type URIBinding

type URIBinding interface {
	Name() string
	BindURI(map[string][]string, any) error
}

URIBinding adds BindUri method to Binding. BindUri is similar with Bind, but it reads the Params.

type XmlBindError

type XmlBindError struct {
	Err error
}

func (*XmlBindError) Error

func (xbe *XmlBindError) Error() string

Error return a string representing the bind error

func (*XmlBindError) Unwrap

func (xbe *XmlBindError) Unwrap() error