server

Documentation

Index

• Constants
• func NewServer(configuration *configs.Configuration) *server
• func Shutdown(e *echo.Echo, idleConnectionClosed chan struct{})
• func Start(e *echo.Echo)
• type Config
• type CustomBinder
  • func NewBinder() *CustomBinder
  • func (cb *CustomBinder) Bind(i interface{}, c echo.Context) error
• type ErrorHandler
  • func NewErrorHandler(e *echo.Echo) *ErrorHandler
  • func (ce *ErrorHandler) Handle(err error, c echo.Context)
• type ErrorResponse
• type HTTPError
  • func NewHTTPError(code int, etype string, message ...string) *HTTPError
  • func NewHTTPGenericError(message string) *HTTPError
  • func NewHTTPInternalError(message string) *HTTPError
  • func NewHTTPValidationError(message string) *HTTPError
  • func (he *HTTPError) Error() string
  • func (he *HTTPError) SetInternal(err error) *HTTPError

Constants

const (
	// InternalErrorType type of common errors
	InternalErrorType = "INTERNAL"
	// GenericErrorType type of common errors
	GenericErrorType = "GENERIC"
	// ValidationErrorType type of common errors
	ValidationErrorType = "VALIDATION"
)

Functions

func NewServer

func NewServer(configuration *configs.Configuration) *server

func Shutdown

func Shutdown(e *echo.Echo, idleConnectionClosed chan struct{})

func Start

func Start(e *echo.Echo)

Types

type Config

type Config func(*config)

type CustomBinder

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

CustomBinder struct

func NewBinder

func NewBinder() *CustomBinder

NewBinder initializes custom server binder

func (*CustomBinder) Bind

func (cb *CustomBinder) Bind(i interface{}, c echo.Context) error

Bind tries to bind request into interface, and if it does then validate it

type ErrorHandler

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

ErrorHandler represents the custom http error handler

func NewErrorHandler

func NewErrorHandler(e *echo.Echo) *ErrorHandler

NewErrorHandler returns the ErrorHandler instance

func (*ErrorHandler) Handle

func (ce *ErrorHandler) Handle(err error, c echo.Context)

Handle is a centralized HTTP error handler.

type ErrorResponse

type ErrorResponse struct {
	Error *HTTPError `json:"error"`
}

ErrorResponse represents the error response

type HTTPError

type HTTPError struct {
	Code     int    `json:"code"`
	Type     string `json:"type"`
	Message  string `json:"message"`
	Internal error  `json:"-"`
}

HTTPError represents an error that occurred while handling a request

func NewHTTPError

func NewHTTPError(code int, etype string, message ...string) *HTTPError

NewHTTPError creates a new HTTPError instance

func NewHTTPGenericError

func NewHTTPGenericError(message string) *HTTPError

NewHTTPGenericError creates a new HTTPError instance for generic error

func NewHTTPInternalError

func NewHTTPInternalError(message string) *HTTPError

NewHTTPInternalError creates a new HTTPError instance for internal error

func NewHTTPValidationError

func NewHTTPValidationError(message string) *HTTPError

NewHTTPValidationError creates a new HTTPError instance for validation error

func (*HTTPError) Error

func (he *HTTPError) Error() string

Error makes it compatible with `error` interface

func (*HTTPError) SetInternal

func (he *HTTPError) SetInternal(err error) *HTTPError

SetInternal sets actual internal error for more details