microapp

README

microapp

Simple microservice framework in go

Documentation

Index

• type App
  • func New(appName string, appConfigOverride map[string]string, appLog *log.Logger, ...) *App
  • func (app *App) DispatchEvent(token string, topic string, payload interface{})
  • func (app *App) Initialize(routeSpecifiers []RouteSpecifier)
  • func (app *App) Logger(module string) *log.Entry
  • func (app *App) NewUnitOfWork(readOnly bool) *repository.UnitOfWork
  • func (app *App) Start()
  • func (app *App) Stop()
• type RouteSpecifier
• type TestApp
  • func NewTestApp(appName string, controllerRouteProvider func(*App) []RouteSpecifier, ...) *TestApp
  • func (testApp *TestApp) CheckResponseCode(t *testing.T, expected, actual int)
  • func (testApp *TestApp) ExecuteRequest(req *http.Request) *httptest.ResponseRecorder
  • func (testApp *TestApp) GetAdminToken(tenantID string, userID string, scope []string) string
  • func (testApp *TestApp) GetToken(tenantID string, userID string, scope []string) string
  • func (testApp *TestApp) Initialize()
  • func (testApp *TestApp) PrepareEmptyTables()
  • func (testApp *TestApp) Stop()

Types

type App

type App struct {
	Name   string
	Config *config.Config
	DB     *gorm.DB
	Router *mux.Router
	// contains filtered or unexported fields
}

App structure for tenant microservice

func New

func New(appName string, appConfigOverride map[string]string, appLog *log.Logger, appDB *gorm.DB, appEventDispatcher event.EventDispatcher) *App

New creates a new microApp

func (*App) DispatchEvent

func (app *App) DispatchEvent(token string, topic string, payload interface{})

DispatchEvent delegates to eventDispatcher.

func (*App) Initialize

func (app *App) Initialize(routeSpecifiers []RouteSpecifier)

Initialize initializes properties of the app

func (*App) Logger

func (app *App) Logger(module string) *log.Entry

Logger returns logger for specified module

func (*App) NewUnitOfWork

func (app *App) NewUnitOfWork(readOnly bool) *repository.UnitOfWork

NewUnitOfWork creates new UnitOfWork

func (*App) Start

func (app *App) Start()

Start http server and start listening to the requests

func (*App) Stop

func (app *App) Stop()

Stop http server

type RouteSpecifier

type RouteSpecifier interface {
	RegisterRoutes(router *mux.Router)
}

RouteSpecifier should be implemented by the class that sets routes for the API endpoints

type TestApp

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

TestApp Provides convinience methods for test

func NewTestApp

func NewTestApp(appName string, controllerRouteProvider func(*App) []RouteSpecifier, dbInitializer func(db *gorm.DB), verbose bool) *TestApp

NewTestApp returns new instance of TestApp

func (*TestApp) CheckResponseCode

func (testApp *TestApp) CheckResponseCode(t *testing.T, expected, actual int)

CheckResponseCode checks if the http response is as expected

func (*TestApp) ExecuteRequest

func (testApp *TestApp) ExecuteRequest(req *http.Request) *httptest.ResponseRecorder

ExecuteRequest executes the http request

func (*TestApp) GetAdminToken

func (testApp *TestApp) GetAdminToken(tenantID string, userID string, scope []string) string

GetAdminToken returns a test token

func (*TestApp) GetToken

func (testApp *TestApp) GetToken(tenantID string, userID string, scope []string) string

GetToken gets a token to connect to API

func (*TestApp) Initialize

func (testApp *TestApp) Initialize()

Initialize prepares the app for testing

func (*TestApp) PrepareEmptyTables

func (testApp *TestApp) PrepareEmptyTables()

PrepareEmptyTables clears all table of data

func (*TestApp) Stop

func (testApp *TestApp) Stop()

Stop the app