server

Documentation

Index

• func IsPrivateIP(address string) (bool, error)
• func RealIP(r *http.Request) string
• type Option
  • func WithAccessLog(enabled bool) Option
  • func WithAddr(addr string) 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()
  • func (s *Server) RunContext(ctx context.Context)
• type Service

Functions

func IsPrivateIP

func IsPrivateIP(address string) (bool, error)

IsPrivateIP works by checking if the address is under private CIDR blocks. List of private CIDR blocks can be seen on :

https://en.wikipedia.org/wiki/Private_network

https://en.wikipedia.org/wiki/Link-local_address

func RealIP

func RealIP(r *http.Request) string

RealIP return client's real public IP address from http request headers.

Types

type Option

type Option func(s *Server)

func WithAccessLog

func WithAccessLog(enabled bool) Option

func WithAddr

func WithAddr(addr string) Option

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()

func (*Server) RunContext

func (s *Server) RunContext(ctx context.Context)

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