endpoint

Documentation

Index

• func ErrorHandler(logger log.Logger) http2.Middleware
• func MaxRequestBodySize(maxBytes int64) http2.Middleware
• func Metrics(storage *http_metrics.ServerStorage) http2.Middleware
• func Recovery() http2.Middleware
• func RequestId() http2.Middleware
• type Caller
  • func NewCaller(f any, bodyExtractor RequestBodyExtractor, bodyMapper ResponseBodyMapper, ...) (*Caller, error)
  • func (h *Caller) Handle(ctx context.Context, w http.ResponseWriter, r *http.Request) error
• type HttpError
• type JsonRequestExtractor
  • func (j JsonRequestExtractor) Extract(ctx context.Context, reader io.Reader, reqBodyType reflect.Type) (reflect.Value, error)
• type JsonResponseMapper
  • func (j JsonResponseMapper) Map(ctx context.Context, result any, w http.ResponseWriter) error
• type LogMiddleware
  • func Log(logger log.Logger, logBody bool) LogMiddleware
  • func LogWithContentTypes(logger log.Logger, logBody bool, logBodyContentTypes []string) LogMiddleware
  • func Noop() LogMiddleware
• type ParamBuilder
• type ParamMapper
  • func ContextParam() ParamMapper
  • func RequestParam() ParamMapper
  • func ResponseWriterParam() ParamMapper
• type RequestBodyExtractor
• type ResponseBodyMapper
• type Validator
• type Wrapper
  • func DefaultWrapper(logger log.Logger, logMiddleware LogMiddleware, ...) Wrapper
  • func NewWrapper(paramMappers []ParamMapper, bodyExtractor RequestBodyExtractor, ...) Wrapper
  • func (m Wrapper) Endpoint(f any) http.HandlerFunc
  • func (m Wrapper) WithMiddlewares(middlewares ...http2.Middleware) Wrapper

Functions

func ErrorHandler

func ErrorHandler(logger log.Logger) http2.Middleware

func MaxRequestBodySize

func MaxRequestBodySize(maxBytes int64) http2.Middleware

func Metrics

func Metrics(storage *http_metrics.ServerStorage) http2.Middleware

func Recovery

func Recovery() http2.Middleware

func RequestId

func RequestId() http2.Middleware

Types

type Caller

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

func NewCaller

func NewCaller(
	f any,
	bodyExtractor RequestBodyExtractor,
	bodyMapper ResponseBodyMapper,
	paramMappers map[string]ParamMapper,
) (*Caller, error)

func (*Caller) Handle

func (h *Caller) Handle(ctx context.Context, w http.ResponseWriter, r *http.Request) error

type HttpError

type HttpError interface {
	WriteError(w http.ResponseWriter) error
}

type JsonRequestExtractor

type JsonRequestExtractor struct {
	Validator Validator
}

func (JsonRequestExtractor) Extract

func (j JsonRequestExtractor) Extract(ctx context.Context, reader io.Reader, reqBodyType reflect.Type) (reflect.Value, error)

type JsonResponseMapper

type JsonResponseMapper struct {
}

func (JsonResponseMapper) Map

func (j JsonResponseMapper) Map(ctx context.Context, result any, w http.ResponseWriter) error

type LogMiddleware

type LogMiddleware http2.Middleware

func Log

func Log(logger log.Logger, logBody bool) LogMiddleware

func LogWithContentTypes

func LogWithContentTypes(logger log.Logger, logBody bool, logBodyContentTypes []string) LogMiddleware

func Noop

func Noop() LogMiddleware

type ParamBuilder

type ParamBuilder func(ctx context.Context, w http.ResponseWriter, r *http.Request) (any, error)

type ParamMapper

type ParamMapper struct {
	Type    string
	Builder ParamBuilder
}

func ContextParam

func ContextParam() ParamMapper

func RequestParam

func RequestParam() ParamMapper

func ResponseWriterParam

func ResponseWriterParam() ParamMapper

type RequestBodyExtractor

type RequestBodyExtractor interface {
	Extract(ctx context.Context, reader io.Reader, reqBodyType reflect.Type) (reflect.Value, error)
}

type ResponseBodyMapper

type ResponseBodyMapper interface {
	Map(ctx context.Context, result any, w http.ResponseWriter) error
}

type Validator

type Validator interface {
	Validate(value any) (bool, map[string]string)
}

type Wrapper

type Wrapper struct {
	ParamMappers  map[string]ParamMapper
	BodyExtractor RequestBodyExtractor
	BodyMapper    ResponseBodyMapper
	Middlewares   []http2.Middleware
	Logger        log.Logger
}

func DefaultWrapper

func DefaultWrapper(logger log.Logger, logMiddleware LogMiddleware, restMiddlewares ...http.Middleware) Wrapper

func NewWrapper

func NewWrapper(
	paramMappers []ParamMapper,
	bodyExtractor RequestBodyExtractor,
	bodyMapper ResponseBodyMapper,
	logger log.Logger,
) Wrapper

func (Wrapper) Endpoint

func (m Wrapper) Endpoint(f any) http.HandlerFunc

func (Wrapper) WithMiddlewares

func (m Wrapper) WithMiddlewares(middlewares ...http2.Middleware) Wrapper