app

Documentation

Overview

Package app provides a preconfigured HTTP server.

Index

• func NewMuxRouter() *mux.Router
• type AuthorizeService
• type Authorizer
• type CreateAppService
• type CreateOrgService
• type Driver
  • func NewDriver() *Driver
  • func (d *Driver) ListenAndServe(addr string, h http.Handler) error
  • func (d *Driver) Shutdown(ctx context.Context) error
• type FindAppService
• type FindOrgService
• type FindUserService
• type LoggerService
• type MiddlewareServices
• type Oauth2TokenConverter
• type PingService
• type SeedService
• type Server
  • func New(rtr *mux.Router, params *ServerParams) *Server
  • func (s *Server) ListenAndServe() error
  • func (s *Server) Shutdown(ctx context.Context) error
• type ServerParams
• type Services
• type UpdateOrgService

Functions

func NewMuxRouter

func NewMuxRouter() *mux.Router

NewMuxRouter initializes a gorilla/mux router and adds the /api subroute to it

Types

type AuthorizeService

type AuthorizeService interface {
	Authorize(lgr zerolog.Logger, r *http.Request, sub audit.Audit) error
}

AuthorizeService determines whether an app and a user can perform an action against a resource

type Authorizer

type Authorizer interface {
	Authorize(lgr zerolog.Logger, sub user.User, obj string, act string) error
}

Authorizer interface authorizes access to a resource given a user and action

type CreateAppService

type CreateAppService interface {
	Create(ctx context.Context, r *service.CreateAppRequest, adt audit.Audit) (service.AppResponse, error)
}

CreateAppService creates an App

type CreateOrgService

type CreateOrgService interface {
	Create(ctx context.Context, r *service.CreateOrgRequest, adt audit.Audit) (service.OrgResponse, error)
}

CreateOrgService creates an Org

type Driver

type Driver struct {
	Server http.Server
}

Driver implements the driver.Server interface. The zero value is a valid http.Server.

func NewDriver

func NewDriver() *Driver

NewDriver creates a Driver with an http.Server with default timeouts.

func (*Driver) ListenAndServe

func (d *Driver) ListenAndServe(addr string, h http.Handler) error

ListenAndServe sets the address and handler on Driver's http.Server, then calls ListenAndServe on it.

func (*Driver) Shutdown

func (d *Driver) Shutdown(ctx context.Context) error

Shutdown gracefully shuts down the server without interrupting any active connections, by calling Shutdown on Driver's http.Server

type FindAppService

type FindAppService interface {
	// FindAppByAPIKey finds an app given its External ID and determines
	// if the given API key is a valid key for it
	FindAppByAPIKey(ctx context.Context, realm, appExtlID, apiKey string) (app.App, error)
}

FindAppService retrieves an App

type FindOrgService

type FindOrgService interface {
	FindAll(ctx context.Context) ([]service.OrgResponse, error)
	FindByExternalID(ctx context.Context, extlID string) (service.OrgResponse, error)
}

FindOrgService retrieves Org information from the datastore

type FindUserService

type FindUserService interface {
	FindUserByOauth2Token(ctx context.Context, params service.FindUserParams) (user.User, error)
}

FindUserService retrieves a User

type LoggerService

type LoggerService interface {
	Read() service.LoggerResponse
	Update(r *service.LoggerRequest) (service.LoggerResponse, error)
}

LoggerService reads and updates the logger state

type MiddlewareServices

type MiddlewareServices struct {
	FindAppService   FindAppService
	FindUserService  FindUserService
	AuthorizeService AuthorizeService
}

MiddlewareServices are used by middleware handlers

type Oauth2TokenConverter

type Oauth2TokenConverter interface {
	Convert(ctx context.Context, token oauth2.Token) (user.User, error)
}

Oauth2TokenConverter interface converts an Oauth2 token to a User

type PingService

type PingService interface {
	Ping(ctx context.Context, logger zerolog.Logger) service.PingResponse
}

PingService pings the database and responds whether it is up or down

type SeedService

type SeedService interface {
	Seed(ctx context.Context, r *service.SeedRequest) (service.SeedResponse, error)
}

SeedService initializes the database with dependent data

type Server

type Server struct {
	Driver driver.Server

	// all logging is done with a zerolog.Logger
	Logger zerolog.Logger

	// Addr optionally specifies the TCP address for the server to listen on,
	// in the form "host:port". If empty, ":http" (port 80) is used.
	// The service names are defined in RFC 6335 and assigned by IANA.
	// See net.Dial for details of the address format.
	Addr string

	// Services used by middleware handlers
	MiddlewareServices

	// Services used by the various HTTP routes.
	Services
	// contains filtered or unexported fields
}

Server represents an HTTP server.

func New

func New(rtr *mux.Router, params *ServerParams) *Server

New initializes a new Server and registers routes to the given router

func (*Server) ListenAndServe

func (s *Server) ListenAndServe() error

ListenAndServe is a wrapper to use wherever http.ListenAndServe is used.

func (*Server) Shutdown

func (s *Server) Shutdown(ctx context.Context) error

Shutdown gracefully shuts down the server without interrupting any active connections.

type ServerParams

type ServerParams struct {
	// Logger is used for app logging
	Logger zerolog.Logger

	// Driver serves HTTP requests.
	Driver driver.Server
}

ServerParams is the set of configuration parameters for a Server

type Services

type Services struct {
	//CreateMovieService CreateMovieService
	//UpdateMovieService UpdateMovieService
	//DeleteMovieService DeleteMovieService
	//FindMovieService   FindMovieService
	SeedService      SeedService
	PingService      PingService
	LoggerService    LoggerService
	CreateOrgService CreateOrgService
	UpdateOrgService UpdateOrgService
	FindOrgService   FindOrgService
	CreateAppService CreateAppService
}

Services are used by the application service handlers

type UpdateOrgService

type UpdateOrgService interface {
	Update(ctx context.Context, r *service.UpdateOrgRequest, adt audit.Audit) (service.OrgResponse, error)
}

UpdateOrgService updates an Org