api

Documentation

Index

• func AddHandlerFunc(api string, h handlerFunc) error
• type Config
  • func DefaultConfig() Config
• type Server
  • func New(log *logp.Logger, mux *http.ServeMux, c *config.C) (*Server, error)
  • func NewWithDefaultRoutes(log *logp.Logger, c *config.C, ns lookupFunc) (*Server, error)
  • func (s *Server) AttachHandler(route string, h http.Handler) (err error)
  • func (s *Server) AttachPprof()
  • func (s *Server) Start()
  • func (s *Server) Stop() error

Functions

func AddHandlerFunc

func AddHandlerFunc(api string, h handlerFunc) error

AddHandlerFunc provides interface to add customized handlerFunc

Types

type Config

type Config struct {
	Enabled            bool   `config:"enabled"`
	Host               string `config:"host"`
	Port               int    `config:"port"`
	User               string `config:"named_pipe.user"`
	SecurityDescriptor string `config:"named_pipe.security_descriptor"`
}

Config is the configuration for the API endpoint.

func DefaultConfig

func DefaultConfig() Config

DefaultConfig is the default configuration used by the API endpoint.

type Server

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

Server takes cares of correctly starting the HTTP component of the API and will answers all the routes defined in the received ServeMux.

func New

func New(log *logp.Logger, mux *http.ServeMux, c *config.C) (*Server, error)

New creates a new API Server.

func NewWithDefaultRoutes

func NewWithDefaultRoutes(log *logp.Logger, c *config.C, ns lookupFunc) (*Server, error)

NewWithDefaultRoutes creates a new server with default API routes.

func (*Server) AttachHandler

func (s *Server) AttachHandler(route string, h http.Handler) (err error)

AttachHandler will attach a handler at the specified route and return an error instead of panicing.

func (*Server) AttachPprof

func (s *Server) AttachPprof()

func (*Server) Start

func (s *Server) Start()

Start starts the HTTP server and accepting new connection.

func (*Server) Stop

func (s *Server) Stop() error

Stop stops the API server and free any resource associated with the process like unix sockets.