middleware

Documentation

Overview

Package middleware implements middleware function for server implementations, which validates incoming HTTP requests to make sure that they conform to the given OAPI 3.0 specification. When OAPI validation fails on the request, we return an HTTP/400.

Index

• func GetFiberContext(c context.Context) *fiber.Ctx
• func GetUserData(c context.Context) interface{}
• func OapiRequestValidator(swagger *openapi3.T) fiber.Handler
• func OapiRequestValidatorWithOptions(swagger *openapi3.T, options *Options) fiber.Handler
• func OapiValidatorFromYamlFile(path string) (fiber.Handler, error)
• func ValidateRequestFromContext(c *fiber.Ctx, router routers.Router, options *Options) error
• type ErrorHandler
• type MultiErrorHandler
• type Options

Functions

func GetFiberContext

func GetFiberContext(c context.Context) *fiber.Ctx

GetFiberContext gets the fiber context from within requests. It returns nil if not found or wrong type.

func GetUserData

func GetUserData(c context.Context) interface{}

func OapiRequestValidator

func OapiRequestValidator(swagger *openapi3.T) fiber.Handler

OapiRequestValidator is a fiber middleware function which validates incoming HTTP requests to make sure that they conform to the given OAPI 3.0 specification. When OAPI validation fails on the request, we return an HTTP/400 with error message

func OapiRequestValidatorWithOptions

func OapiRequestValidatorWithOptions(swagger *openapi3.T, options *Options) fiber.Handler

OapiRequestValidatorWithOptions creates a validator from a swagger object, with validation options

func OapiValidatorFromYamlFile

func OapiValidatorFromYamlFile(path string) (fiber.Handler, error)

OapiValidatorFromYamlFile creates a validator middleware from a YAML file path

func ValidateRequestFromContext

func ValidateRequestFromContext(c *fiber.Ctx, router routers.Router, options *Options) error

ValidateRequestFromContext is called from the middleware above and actually does the work of validating a request.

Types

type ErrorHandler

type ErrorHandler func(c *fiber.Ctx, message string, statusCode int)

ErrorHandler is called when there is an error in validation

type MultiErrorHandler

type MultiErrorHandler func(openapi3.MultiError) error

MultiErrorHandler is called when oapi returns a MultiError type

type Options

type Options struct {
	Options           openapi3filter.Options
	ErrorHandler      ErrorHandler
	ParamDecoder      openapi3filter.ContentParameterDecoder
	UserData          interface{}
	MultiErrorHandler MultiErrorHandler
}

Options to customize request validation. These are passed through to openapi3filter.