middleware

Documentation

Index

• Constants
• func GetEchoContext(c context.Context) echo.Context
• func GetUserData(c context.Context) interface{}
• func OapiRequestValidator(swagger *openapi3.T) echo.MiddlewareFunc
• func OapiRequestValidatorWithOptions(swagger *openapi3.T, options *Options) echo.MiddlewareFunc
• func OapiValidatorFromYamlFile(path string) (echo.MiddlewareFunc, error)
• func ValidateRequestFromContext(ctx echo.Context, router routers.Router, options *Options) *echo.HTTPError
• type ErrorHandler
• type MultiErrorHandler
• type Options

Constants

const (
	EchoContextKey = "oapi-codegen/echo-context"
	UserDataKey    = "oapi-codegen/user-data"
)

Functions

func GetEchoContext

func GetEchoContext(c context.Context) echo.Context

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

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#GetEchoContext

func GetUserData

func GetUserData(c context.Context) interface{}

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#GetUserData

func OapiRequestValidator

func OapiRequestValidator(swagger *openapi3.T) echo.MiddlewareFunc

OapiRequestValidator creates a validator from a swagger object.

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#OapiRequestValidator

func OapiRequestValidatorWithOptions

func OapiRequestValidatorWithOptions(swagger *openapi3.T, options *Options) echo.MiddlewareFunc

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

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#OapiRequestValidatorWithOptions

func OapiValidatorFromYamlFile

func OapiValidatorFromYamlFile(path string) (echo.MiddlewareFunc, error)

OapiValidatorFromYamlFile is an Echo 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. Create validator middleware from a YAML file path

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#OapiValidatorFromYamlFile

func ValidateRequestFromContext

func ValidateRequestFromContext(ctx echo.Context, router routers.Router, options *Options) *echo.HTTPError

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

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#ValidateRequestFromContext

Types

type ErrorHandler

type ErrorHandler func(c echo.Context, err *echo.HTTPError) error

ErrorHandler is called when there is an error in validation

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#ErrorHandler

type MultiErrorHandler

type MultiErrorHandler func(openapi3.MultiError) *echo.HTTPError

MultiErrorHandler is called when oapi returns a MultiError type

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#MultiErrorHandler

type Options

type Options struct {
	ErrorHandler      ErrorHandler
	Options           openapi3filter.Options
	ParamDecoder      openapi3filter.ContentParameterDecoder
	UserData          interface{}
	Skipper           echomiddleware.Skipper
	MultiErrorHandler MultiErrorHandler
	// SilenceServersWarning allows silencing a warning for https://github.com/deepmap/oapi-codegen/issues/882 that reports when an OpenAPI spec has `spec.Servers != nil`
	SilenceServersWarning bool
}

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

Deprecated: This has been replaced by https://pkg.go.dev/github.com/oapi-codegen/echo-middleware#Options