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) MigrateDB(connectionString string)
  • 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) AssertEqualWithFieldsToCheck(t *testing.T, expected interface{}, actual interface{}, fieldsToChk []string, ...)
  • func (testApp *TestApp) AssertEqualWithFieldsToIgnore(t *testing.T, expected interface{}, actual interface{}, ...)
  • func (testApp *TestApp) AssertErrorResponse(t *testing.T, response *httptest.ResponseRecorder, expectedErrorKey string, ...)
  • func (testApp *TestApp) AssertXTotalCount(t *testing.T, response *httptest.ResponseRecorder, expectedXTotalCount int)
  • 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) GetByID(ID string, preloads []string, entity interface{}) error
  • func (testApp *TestApp) GetFullAdminToken(tenantID string, userID string, username string, name string, ...) string
  • func (testApp *TestApp) GetFullToken(tenantID string, userID string, username string, name string, ...) string
  • func (testApp *TestApp) GetToken(tenantID string, userID string, scope []string) string
  • func (testApp *TestApp) Initialize()
  • func (testApp *TestApp) PrepareEmptyTables()
  • func (testApp *TestApp) SaveToDB(entity interface{}) error
  • func (testApp *TestApp) SetControllerRouteProviderAndInitialize(controllerRouteProvider func(*App) []RouteSpecifier)
  • 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) MigrateDB

func (app *App) MigrateDB(connectionString string)

MigrateDB Looks for migrations directory and runs the migrations scripts in that directory

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

func (testApp *TestApp) AssertEqualWithFieldsToCheck(t *testing.T, expected interface{}, actual interface{}, fieldsToChk []string, mapOfExpectedToActualField map[string]string)

AssertEqualWithFieldsToCheck asserts whether two objects are equal

func (*TestApp) AssertEqualWithFieldsToIgnore

func (testApp *TestApp) AssertEqualWithFieldsToIgnore(t *testing.T, expected interface{}, actual interface{}, fieldsToIgnore []string, mapOfExpectedToActualField map[string]string)

AssertEqualWithFieldsToIgnore asserts whether two objects are equal

func (*TestApp) AssertErrorResponse

func (testApp *TestApp) AssertErrorResponse(t *testing.T, response *httptest.ResponseRecorder, expectedErrorKey string, expectedErrorField string, expectedError string)

AssertErrorResponse checks if the http response contains expected errorKey, errorField and errorMessage

func (*TestApp) AssertXTotalCount

func (testApp *TestApp) AssertXTotalCount(t *testing.T, response *httptest.ResponseRecorder, expectedXTotalCount int)

AssertXTotalCount checks if the http response header contains expected x-total-count

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

func (testApp *TestApp) GetByID(ID string, preloads []string, entity interface{}) error

GetByID saves the entity to database

func (*TestApp) GetFullAdminToken

func (testApp *TestApp) GetFullAdminToken(tenantID string, userID string, username string, name string, externalID string, externalIDType string, scope []string) string

GetFullAdminToken returns a test token with all the fields along with different external IDs for types such as Appliance, Session, User. These external IDs are used with REST api is invoked from another REST API service as opposed to the getting hit from UI by the user.

func (*TestApp) GetFullToken

func (testApp *TestApp) GetFullToken(tenantID string, userID string, username string, name string, externalID string, externalIDType string, scope []string) string

GetFullToken returns a test token with all the fields along with different external IDs for types such as Appliance, Session, User. These external IDs are used with REST api is invoked from another REST API service as opposed to the getting hit from UI by the user.

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

func (testApp *TestApp) SaveToDB(entity interface{}) error

SaveToDB saves the entity to database

func (*TestApp) SetControllerRouteProviderAndInitialize

func (testApp *TestApp) SetControllerRouteProviderAndInitialize(controllerRouteProvider func(*App) []RouteSpecifier)

SetControllerRouteProviderAndInitialize sets the controllerRouteProvider and initializes application

func (*TestApp) Stop

func (testApp *TestApp) Stop()

Stop the app