errors

Documentation

Index

• type APIError
  • func AppAlreadyKnown(app string) APIError
  • func AppIsNotKnown(app string) APIError
  • func BadRequest(err error, details ...string) APIError
  • func InternalError(err error, details ...string) APIError
  • func NamespaceAlreadyKnown(namespace string) APIError
  • func NamespaceIsNotKnown(namespace string) APIError
  • func NewAPIError(title string, details string, status int) APIError
  • func NewBadRequest(msg string, details ...string) APIError
  • func NewInternalError(msg string, details ...string) APIError
  • func NewNotFoundError(msg string, details ...string) APIError
  • func ServiceAlreadyBound(service string) APIError
  • func ServiceAlreadyKnown(service string) APIError
  • func ServiceIsNotBound(service string) APIError
  • func ServiceIsNotKnown(service string) APIError
  • func UserNotFound() APIError
  • func (a APIError) Error() string
  • func (a APIError) Errors() []APIError
  • func (a APIError) FirstStatus() int
• type APIErrors
• type ErrorResponse
• type MultiError
  • func NewMultiError(errs []APIError) MultiError
  • func (m MultiError) Error() string
  • func (m MultiError) Errors() []APIError
  • func (m MultiError) FirstStatus() int

Types

type APIError

type APIError struct {
	Status  int    `json:"status"`
	Title   string `json:"title"`
	Details string `json:"details"`
}

APIError fulfills the error and APIErrors interfaces. It contains a single error.

func AppAlreadyKnown

func AppAlreadyKnown(app string) APIError

AppAlreadyKnown constructs an API error for when we have a conflict with an existing app

func AppIsNotKnown

func AppIsNotKnown(app string) APIError

AppIsNotKnown constructs an API error for when the desired app does not exist

func BadRequest

func BadRequest(err error, details ...string) APIError

BadRequest constructs an API error for general issues with a request, from a lower-level error

func InternalError

func InternalError(err error, details ...string) APIError

InternalError constructs an API error for server internal issues, from a lower-level error

func NamespaceAlreadyKnown

func NamespaceAlreadyKnown(namespace string) APIError

NamespaceAlreadyKnown constructs an API error for when we have a conflict with an existing namespace

func NamespaceIsNotKnown

func NamespaceIsNotKnown(namespace string) APIError

NamespaceIsNotKnown constructs an API error for when the desired namespace does not exist

func NewAPIError

func NewAPIError(title string, details string, status int) APIError

NewAPIError constructs an APIerror from basics

func NewBadRequest

func NewBadRequest(msg string, details ...string) APIError

NewBadRequest constructs an API error for general issues with a request, from a message

func NewInternalError

func NewInternalError(msg string, details ...string) APIError

NewInternalError constructs an API error for server internal issues, from a message

func NewNotFoundError

func NewNotFoundError(msg string, details ...string) APIError

NewNotFoundError constructs a general API error for when something desired does not exist

func ServiceAlreadyBound

func ServiceAlreadyBound(service string) APIError

ServiceAlreadyBound constructs an API error for when the service to bind is already bound to the app

func ServiceAlreadyKnown

func ServiceAlreadyKnown(service string) APIError

ServiceAlreadyKnown constructs an API error for when we have a conflict with an existing service instance

func ServiceIsNotBound

func ServiceIsNotBound(service string) APIError

ServiceIsNotBound constructs an API error for when the service to unbind is actually not bound to the app

func ServiceIsNotKnown

func ServiceIsNotKnown(service string) APIError

ServiceIsNotKnown constructs an API error for when the desired service instance does not exist

func UserNotFound

func UserNotFound() APIError

UserNotFound constructs an API error for when the user name is not found in the header

func (APIError) Error

func (a APIError) Error() string

Error satisfies the error interface

func (APIError) Errors

func (a APIError) Errors() []APIError

Errors satisfies the APIErrors interface

func (APIError) FirstStatus

func (a APIError) FirstStatus() int

FirstStatus (APIErrors interface) returns the stored error's status

type APIErrors

type APIErrors interface {
	Errors() []APIError
	FirstStatus() int
}

APIErrors is the interface used by all handlers to return one or more errors

type ErrorResponse

type ErrorResponse struct {
	Errors []APIError `json:"errors"`
}

ErrorResponse is the response's JSON, that is send in case of an error

type MultiError

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

MultiError fulfills the APIErrors interface. It contains multiple errors.

func NewMultiError

func NewMultiError(errs []APIError) MultiError

NewMultiError constructs an APIerror from basics

func (MultiError) Error

func (m MultiError) Error() string

Error satisfies the error interface

func (MultiError) Errors

func (m MultiError) Errors() []APIError

Errors satisfies the APIErrors interface

func (MultiError) FirstStatus

func (m MultiError) FirstStatus() int

FirstStatus (APIErrors interface) returns the status of the first error stored