http

type BindDirectiveConfiguration ¶

type BindDirectiveConfiguration struct {
	// Default prefixes for qualified directives
	PathBindingPrefix       string
	HeaderBindingPrefix     string
	QueryParamBindingPrefix string
	PayloadBindingPrefix    string

	// Default values for unqualified directives
	SkipField    string
	IncludeField string
	BindBody     string

	OmitEmptyDirective    string
	IncludeEmptyDirective string

	// Defines how an empty value is marshaled unless overridden by OmitEmptyDirective or IncludeEmptyDirective. Default
	// is to omit.
	EmptyValueHandlingDefault EmptyValueHandlingType
}

func NewBindDirectiveConfiguration() BindDirectiveConfiguration

type BindFromRequestConfiguration ¶

type BindFromRequestConfiguration struct {
	BindConfiguration bind.Configuration
	BindDirectiveConfiguration
	// contains filtered or unexported fields
}

BindFromRequestConfiguration TODO: add config option mechanism...

func NewBindFromRequestConfiguration() BindFromRequestConfiguration

type BindToResponseConfiguration ¶

type BindToResponseConfiguration struct {
	BindConfiguration bind.Configuration
	BindDirectiveConfiguration
	// contains filtered or unexported fields
}

BindToResponseConfiguration TODO: add config option mechanism...

func NewBindToResponseConfiguration() BindToResponseConfiguration

type BindingConfiguration ¶ added in v0.2.0

type BindingConfiguration struct {
	// contains filtered or unexported fields
}

BindingConfiguration holds unified configuration for request/response binding.

func NewBindingConfiguration(options ...BindingOption) *BindingConfiguration

func (bc *BindingConfiguration) SetAsDefault() *BindingConfiguration

type BindingOption ¶ added in v0.2.0

type BindingOption func(*BindingConfiguration)

BindingOption configures HTTP binding for both request and response.

var (
	// CamelCaseFields configures field names to use camelCase in JSON (e.g., "firstName").
	CamelCaseFields BindingOption = wrapBindOption(bind.CamelCaseFields)

	// PascalCaseFields configures field names to use PascalCase in JSON (e.g., "FirstName").
	// This is the default behavior.
	PascalCaseFields BindingOption = wrapBindOption(bind.PascalCaseFields)

	// OmitEmptyValues configures binding to omit empty/zero values from output.
	// This is the default behavior.
	OmitEmptyValues BindingOption = wrapBindOption(bind.OmitEmpty)

	// IncludeEmptyValues configures binding to include empty/zero values in output.
	IncludeEmptyValues BindingOption = wrapBindOption(bind.IncludeEmpty)
)

func RequestOption(opts ...BindingOption) BindingOption

http.Configure(
    http.CamelCaseFields,                        // applies to both
    http.RequestOption(http.IncludeEmptyValues), // override for request only
)

func ResponseOption(opts ...BindingOption) BindingOption

http.Configure(
    http.CamelCaseFields,                       // applies to both
    http.ResponseOption(http.OmitEmptyValues),  // override for response only
)

type EmptyValueHandlingType ¶

type EmptyValueHandlingType int

const (
	OmitEmpty EmptyValueHandlingType = iota
	IncludeEmpty
)

type Marshal ¶

type Marshal func(toMarshal any) ([]byte, error)

Marshal provides a function to convert the toMarshal to bytes suitable for returning in a response body.

type Marshaler ¶

type Marshaler interface {
	Marshal() ([]byte, error)
}

type Method ¶

type Method = Op

const (
	MethodPut     Method // 0b00000001
	MethodPost           // 0b00000010
	MethodGet            // 0b00000011
	MethodPatch          // 0b00000100
	MethodDelete         // 0b00000101
	MethodHead           // 0b00000110
	MethodOptions        // 0b00000111

)

type Op ¶

type Op byte

Op has 8 bits where the bottom five bits correspond to the action type, the sixth and seventh bit specifies what resource type the action is against (instance or a collection; a singleton counts as an instance) and the highest bit indicates if the op is built-in or customer-defined. The seventh bit is reserved. Use NewOp rather than try to construct manually to allow for the introduction of new, built-in Method values.

func NewOp(method Method, category resource.Category) Op

func (o Op) IsBuiltIn() bool

func (o Op) IsValid() bool

func (o Op) Method() string

func (o Op) ResourceType() resource.Category

type StatusCoder ¶

type StatusCoder interface {
	StatusCode() int
}

type Unmarshal ¶

type Unmarshal func(toUnmarshal []byte, ptrToTarget any) error

Unmarshal defines a function that processes the input and stores the result in the value pointed to by ptrToTarget. If ptrToTarget is nil, not a pointer, or otherwise unprocessable, Unmarshal returns a gomerr.Gomerr.

type UnroutableError ¶ added in v0.4.4

type UnroutableError struct {
	gomerr.Gomerr
	Route string
}

func Unroutable() *UnroutableError