restapi

README

Common Libraries used by other projects

This project is used as a common set of libraries to use on my other projects. this might not be as useful without them but feel free to use it as inspiration

Documentation

Index

• func CorrelationMiddlewareAdapter() controllers.Adapter
• func JsonContentMiddlewareAdapter() controllers.Adapter
• func LoggerMiddlewareAdapter() controllers.Adapter
• type DefaultHomepage
• type HttpListener
  • func GetHttpListener() *HttpListener
  • func NewHttpListener() *HttpListener
  • func (l *HttpListener) AddAuthorizedController(c controllers.Controller, path string, methods ...string)
  • func (l *HttpListener) AddAuthorizedControllerWithClaims(c controllers.Controller, path string, claims []string, methods ...string)
  • func (l *HttpListener) AddAuthorizedControllerWithRoles(c controllers.Controller, path string, roles []string, methods ...string)
  • func (l *HttpListener) AddAuthorizedControllerWithRolesAndClaims(c controllers.Controller, path string, roles []string, claims []string, ...)
  • func (l *HttpListener) AddController(c controllers.Controller, path string, methods ...string)
  • func (l *HttpListener) AddDefaultHomepage() *HttpListener
  • func (l *HttpListener) AddHealthCheck() *HttpListener
  • func (l *HttpListener) AddJsonContent() *HttpListener
  • func (l *HttpListener) AddLogger() *HttpListener
  • func (c *HttpListener) Probe() controllers.Controller
  • func (s *HttpListener) ShutdownHandler(w http.ResponseWriter, r *http.Request)
  • func (l *HttpListener) Start()
  • func (l *HttpListener) WaitAndShutdown()
  • func (l *HttpListener) WithAuthentication(prefix string, context interfaces.UserContextAdapter) *HttpListener
  • func (l *HttpListener) WithDefaultAuthentication() *HttpListener
• type HttpListenerOptions

Functions

func CorrelationMiddlewareAdapter

func CorrelationMiddlewareAdapter() controllers.Adapter

func JsonContentMiddlewareAdapter

func JsonContentMiddlewareAdapter() controllers.Adapter

func LoggerMiddlewareAdapter

func LoggerMiddlewareAdapter() controllers.Adapter

Types

type DefaultHomepage

type DefaultHomepage struct {
	CorrelationID string `json:"id" bson:"_id" yaml:"id"`
	Timestamp     string `json:"timestamp" bson:"timestamp" yaml:"timestamp"`
	Message       string `json:"message" bson:"message" yaml:"message"`
}

type HttpListener

type HttpListener struct {
	Router          *mux.Router
	Context         *execution_context.Context
	Logger          *logger.Logger
	Options         *HttpListenerOptions
	Controllers     []controllers.Controller
	DefaultAdapters []controllers.Adapter
	Servers         []*http.Server
	// contains filtered or unexported fields
}

HttpListener HttpListener structure

func GetHttpListener

func GetHttpListener() *HttpListener

func NewHttpListener

func NewHttpListener() *HttpListener

NewHttpListener Creates a new controller

func (*HttpListener) AddAuthorizedController

func (l *HttpListener) AddAuthorizedController(c controllers.Controller, path string, methods ...string)

func (*HttpListener) AddAuthorizedControllerWithClaims

func (l *HttpListener) AddAuthorizedControllerWithClaims(c controllers.Controller, path string, claims []string, methods ...string)

func (*HttpListener) AddAuthorizedControllerWithRoles

func (l *HttpListener) AddAuthorizedControllerWithRoles(c controllers.Controller, path string, roles []string, methods ...string)

func (*HttpListener) AddAuthorizedControllerWithRolesAndClaims

func (l *HttpListener) AddAuthorizedControllerWithRolesAndClaims(c controllers.Controller, path string, roles []string, claims []string, methods ...string)

func (*HttpListener) AddController

func (l *HttpListener) AddController(c controllers.Controller, path string, methods ...string)

func (*HttpListener) AddDefaultHomepage

func (l *HttpListener) AddDefaultHomepage() *HttpListener

func (*HttpListener) AddHealthCheck

func (l *HttpListener) AddHealthCheck() *HttpListener

func (*HttpListener) AddJsonContent

func (l *HttpListener) AddJsonContent() *HttpListener

func (*HttpListener) AddLogger

func (l *HttpListener) AddLogger() *HttpListener

func (*HttpListener) Probe

func (c *HttpListener) Probe() controllers.Controller

Login Generate a token for a valid user

func (*HttpListener) ShutdownHandler

func (s *HttpListener) ShutdownHandler(w http.ResponseWriter, r *http.Request)

func (*HttpListener) Start

func (l *HttpListener) Start()

func (*HttpListener) WaitAndShutdown

func (l *HttpListener) WaitAndShutdown()

func (*HttpListener) WithAuthentication

func (l *HttpListener) WithAuthentication(prefix string, context interfaces.UserContextAdapter) *HttpListener

func (*HttpListener) WithDefaultAuthentication

func (l *HttpListener) WithDefaultAuthentication() *HttpListener

type HttpListenerOptions

type HttpListenerOptions struct {
	ApiPrefix               string
	HttpPort                string
	EnableTLS               bool
	TLSPort                 string
	TLSCertificate          string
	TLSPrivateKey           string
	UseAuthBackend          bool
	MongoDbConnectionString string
	DatabaseName            string
	EnableAuthentication    bool
}