web

Documentation

Index

• Constants
• func IsShutdown(err error) bool
• func NewRequestError(err error, status int) error
• func NewShutdownError(message string) error
• func Respond(ctx context.Context, w http.ResponseWriter, data interface{}, statusCode int) error
• func RespondError(ctx context.Context, w http.ResponseWriter, err error) error
• type App
  • func NewApp() *App
  • func (a *App) Handle(verb, path string, handler Handler)
  • func (a *App) ServeHTTP(w http.ResponseWriter, r *http.Request)
• type Error
  • func (err *Error) Error() string
• type ErrorResponse
• type FieldError
• type Handler
• type Values

Constants

const KeyValues ctxKey = 1

KeyValues is how request values or stored/retrieved.

Functions

func IsShutdown

func IsShutdown(err error) bool

IsShutdown checks to see if the shutdown error is contained in the specified error value.

func NewRequestError

func NewRequestError(err error, status int) error

NewRequestError wraps a provided error with an HTTP status code. This function should be used when handlers encounter expected errors.

func NewShutdownError

func NewShutdownError(message string) error

NewShutdownError returns an error that causes the framework to signal a graceful shutdown.

func Respond

func Respond(ctx context.Context, w http.ResponseWriter, data interface{}, statusCode int) error

Respond converts a Go value to JSON and sends it to the client.

func RespondError

func RespondError(ctx context.Context, w http.ResponseWriter, err error) error

RespondError sends an error reponse back to the client.

Types

type App

type App struct {
	*httptreemux.TreeMux
	// contains filtered or unexported fields
}

App is the entry point

func NewApp

func NewApp() *App

NewApp creates an App value that handle a set of routes for the application.

func (*App) Handle

func (a *App) Handle(verb, path string, handler Handler)

Handle is our mechanism for mounting Handlers for a given HTTP verb and path pair, this makes for really easy, convenient routing.

func (*App) ServeHTTP

func (a *App) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP implements the http.Handler interface. It overrides the ServeHTTP of the embedded TreeMux by using the ochttp.Handler instead. That Handler wraps the TreeMux handler so the routes are served.

type Error

type Error struct {
	Err    error
	Status int
	Fields []FieldError
}

Error is used to pass an error during the request through the application with web specific context.

func (*Error) Error

func (err *Error) Error() string

Error implements the error interface. It uses the default message of the wrapped error. This is what will be shown in the services' logs.

type ErrorResponse

type ErrorResponse struct {
	Error  string       `json:"error"`
	Fields []FieldError `json:"fields,omitempty"`
}

ErrorResponse is the form used for API responses from failures in the API.

type FieldError

type FieldError struct {
	Field string `json:"field"`
	Error string `json:"error"`
}

FieldError is used to indicate an error with a specific request field.

type Handler

type Handler func(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error

Handler for our own framework

type Values

type Values struct {
	TraceID    string
	Now        time.Time
	StatusCode int
}

Values represent state for each request.