http

Documentation

Overview

Package http provides a registration interface for http services

Index

• Variables
• func AddFlags(flagSet *pflag.FlagSet)
• func AddFlagsPrefix(flagSet *pflag.FlagSet, prefix string, Opt *Options)
• func Mount(pattern string, h http.Handler) error
• func Restart() error
• func Route(pattern string, fn func(r chi.Router)) (chi.Router, error)
• func Router() (chi.Router, error)
• func SetOptions(opt Options)
• func Shutdown() error
• func URL() string
• func Wait()
• type Middleware
• type Options
  • func GetOptions() Options
• type Server
  • func NewServer(listeners, tlsListeners []net.Listener, opt Options) (Server, error)

Variables

var DefaultOpt = Options{
	ListenAddr:         "127.0.0.1:8080",
	ServerReadTimeout:  1 * time.Hour,
	ServerWriteTimeout: 1 * time.Hour,
	MaxHeaderBytes:     4096,
}

DefaultOpt is the default values used for Options

var Help = `` /* 1549-byte string literal not displayed */

Help contains text describing the http server to add to the command help.

Functions

func AddFlags

func AddFlags(flagSet *pflag.FlagSet)

AddFlags adds flags for the httplib

func AddFlagsPrefix

func AddFlagsPrefix(flagSet *pflag.FlagSet, prefix string, Opt *Options)

AddFlagsPrefix adds flags for the httplib

func Mount

func Mount(pattern string, h http.Handler) error

Mount attaches another http.Handler along ./pattern/*

func Restart

func Restart() error

Restart or start the default http server using the default options and no handlers

func Route

func Route(pattern string, fn func(r chi.Router)) (chi.Router, error)

Route mounts a sub-Router along a `pattern` string.

func Router

func Router() (chi.Router, error)

Router returns the server base router

func SetOptions

func SetOptions(opt Options)

SetOptions thread safe setter for the default server options

func Shutdown

func Shutdown() error

Shutdown gracefully shuts down the default http server

func URL

func URL() string

URL of default http server

func Wait

func Wait()

Wait blocks while the default http server is serving requests

Types

type Middleware

type Middleware func(http.Handler) http.Handler

Middleware function signature required by chi.Router.Use()

type Options

type Options struct {
	ListenAddr         string        // Port to listen on
	BaseURL            string        // prefix to strip from URLs
	ServerReadTimeout  time.Duration // Timeout for server reading data
	ServerWriteTimeout time.Duration // Timeout for server writing data
	MaxHeaderBytes     int           // Maximum size of request header
	SslCert            string        // SSL PEM key (concatenation of certificate and CA certificate)
	SslKey             string        // SSL PEM Private key
	ClientCA           string        // Client certificate authority to verify clients with
}

Options contains options for the http Server

func GetOptions

func GetOptions() Options

GetOptions thread safe getter for the default server options

type Server

type Server interface {
	Router() chi.Router
	Route(pattern string, fn func(r chi.Router)) chi.Router
	Mount(pattern string, h http.Handler)
	Shutdown() error
}

Server interface of http server

func NewServer

func NewServer(listeners, tlsListeners []net.Listener, opt Options) (Server, error)

NewServer instantiates a new http server using provided listeners and options This function is provided if the default http server does not meet a services requirements and should not generally be used A http server can listen using multiple listeners. For example, a listener for port 80, and a listener for port 443. tlsListeners are ignored if opt.SslKey is not provided