http

Documentation

Index

• Variables
• func Handler[Req any, Res any](pattern string, errorer Errorer[Res], fn Handle[Req, Res])
• func NewServeMux() *http.ServeMux
• func RegisterHandler(mu *http.ServeMux, ma *marshaller.Map)
• type Config
• type Errorer
• type Handle
• type Server
  • func NewServer(server *http.Server, cfg *Config) (*Server, error)
  • func (s *Server) IsEnabled() bool
  • func (s *Server) Serve() error
  • func (s *Server) Shutdown(ctx context.Context) error
  • func (s *Server) String() string

Variables

var (
	// ErrReadAll for HTTP.
	ErrReadAll = errors.New("invalid body read")

	// ErrUnmarshal for HTTP.
	ErrUnmarshal = errors.New("invalid unmarshal")

	// ErrHandle for HTTP.
	ErrHandle = errors.New("invalid handle")

	// ErrMarshal for HTTP.
	ErrMarshal = errors.New("invalid marshal")
)

Functions

func Handler

func Handler[Req any, Res any](pattern string, errorer Errorer[Res], fn Handle[Req, Res])

Handler for HTTP.

func NewServeMux

func NewServeMux() *http.ServeMux

NewServeMux for http.

func RegisterHandler

func RegisterHandler(mu *http.ServeMux, ma *marshaller.Map)

RegisterHandler for HTTP.

Types

type Config

type Config struct {
	TLS  *tls.Config
	Port string
}

Config for HTTP.

type Errorer

type Errorer[Res any] interface {
	// Error for this handler.
	Error(ctx context.Context, err error) *Res

	// Status code from error.
	Status(err error) int
}

Errorer for HTTP.

type Handle

type Handle[Req any, Res any] func(context.Context, *Req) (*Res, error)

Handle func for request/response.

type Server

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

Server for HTTP.

func NewServer

func NewServer(server *http.Server, cfg *Config) (*Server, error)

NewServer for HTTP.

func (*Server) IsEnabled

func (s *Server) IsEnabled() bool

IsEnabled for server.

func (*Server) Serve

func (s *Server) Serve() error

Serve the underlying server.

func (*Server) Shutdown

func (s *Server) Shutdown(ctx context.Context) error

Shutdown the underlying server.

func (*Server) String

func (s *Server) String() string