server

Documentation

Index

• type Option
  • func WithAddress(address string) Option
  • func WithCORS(enabled bool) Option
  • func WithDebug(debug bool) Option
  • func WithLogger(logger *zap.Logger) Option
  • func WithMiddleware(middleware func(http.Handler) http.Handler) Option
  • func WithPathPrefix(prefix string) Option
  • func WithPort(port int) Option
  • func WithShutdownTimeout(timeout time.Duration) Option
  • func WithStartupTimeout(timeout time.Duration) Option
  • func WithStripQueryString(enabled bool) Option
• type Server
  • func New(app Service, options ...Option) *Server
  • func (s *Server) Run()
• type Service

Types

type Option

type Option func(s *Server)

func WithAddress

func WithAddress(address string) Option

func WithCORS

func WithCORS(enabled bool) Option

func WithDebug

func WithDebug(debug bool) Option

func WithLogger

func WithLogger(logger *zap.Logger) Option

func WithMiddleware

func WithMiddleware(middleware func(http.Handler) http.Handler) Option

func WithPathPrefix

func WithPathPrefix(prefix string) Option

func WithPort

func WithPort(port int) Option

func WithShutdownTimeout

func WithShutdownTimeout(timeout time.Duration) Option

func WithStartupTimeout

func WithStartupTimeout(timeout time.Duration) Option

func WithStripQueryString

func WithStripQueryString(enabled bool) Option

type Server

type Server struct {
	http.Server
	App             Service
	Address         string
	Port            int
	CertFile        string
	KeyFile         string
	PathPrefix      string
	StartupTimeout  time.Duration
	ShutdownTimeout time.Duration
	Logger          *zap.Logger
	Debug           bool
}

Server wraps the Service with additional http and app lifecycle handling

func New

func New(app Service, options ...Option) *Server

New create new Server

func (*Server) Run

func (s *Server) Run()

type Service

type Service interface {
	http.Handler

	// Startup controls app startup
	Startup(ctx context.Context) error

	// Shutdown controls app shutdown
	Shutdown(ctx context.Context) error
}

Service is a http.Handler with Startup and Shutdown lifecycle