ecode

Documentation

Index

• Constants
• Variables
• type Error
  • func AnalyseError(err error) *Error
  • func New(code int, msg string) *Error
  • func (e *Error) Code() int
  • func (e *Error) Error() string
  • func (e *Error) GRPCStatus() *status.Status
  • func (e *Error) Message() string
• type ErrorV2
  • func AnalyseErrorV2(err error) *ErrorV2
  • func DeepClone(err *ErrorV2) *ErrorV2
  • func FromError(err error) *ErrorV2
  • func NewV2(code int, reason string, message string) *ErrorV2
  • func (e *ErrorV2) Code() int
  • func (e *ErrorV2) Equal(code int, reason ...string) bool
  • func (e *ErrorV2) Error() string
  • func (e *ErrorV2) GRPCStatus() *status.Status
  • func (e *ErrorV2) Is(err error) bool
  • func (e *ErrorV2) Message() string
  • func (e *ErrorV2) Reason() string
  • func (e *ErrorV2) Unwrap() error
  • func (e *ErrorV2) WithCause(cause error) *ErrorV2
  • func (e *ErrorV2) WithMetadata(md map[string]string) *ErrorV2
• type Status
  • func (*Status) Descriptor() ([]byte, []int)
  • func (x *Status) GetCode() int32
  • func (x *Status) GetMessage() string
  • func (x *Status) GetMetadata() map[string]string
  • func (x *Status) GetReason() string
  • func (*Status) ProtoMessage()
  • func (x *Status) ProtoReflect() protoreflect.Message
  • func (x *Status) Reset()
  • func (x *Status) String() string

Constants

const (
	// UnknownCode is unknown code for error info.
	UnknownCode = http.StatusInternalServerError
	// UnknownReason is unknown reason for error info.
	UnknownReason = ""
	// ClientClosed is non-standard http status code,
	// which defined by nginx.
	// https://httpstatus.in/499/
	ClientClosed = 499
)

Variables

var (
	// base error
	Success               = NewV2(http.StatusOK, "SUCCESS", "success")
	RequestErr            = NewV2(http.StatusBadRequest, "PARAM_ERROR", "request param error")
	UnauthorizedErr       = NewV2(http.StatusUnauthorized, "SIGN_ERROR", "sign error")
	ForbiddenErr          = NewV2(http.StatusForbidden, "NO_AUTH", "no auth")
	NotFoundErr           = NewV2(http.StatusNotFound, "RESOURCE_NOT_FOUND", "resource not found")
	TooManyRequestErr     = NewV2(http.StatusTooManyRequests, "RATELIMIT_EXCEEDED", "ratelimit exceeded")
	ServerErr             = NewV2(http.StatusInternalServerError, "SERVER_ERROR", "server error")
	BadGatewayErr         = NewV2(http.StatusBadGateway, "SERVICE_UNAVAILABLE", "service offline, unavailable")
	ServiceUnavailableErr = NewV2(http.StatusServiceUnavailable, "SERVICE_UNAVAILABLE", "service protected, unavailable")
)

var DefaultConverter = statusConverter{}

DefaultConverter default converter.

var File_ecode_errors_proto protoreflect.FileDescriptor

Types

type Error

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

Error struct

func AnalyseError

func AnalyseError(err error) *Error

analyse error info

func New

func New(code int, msg string) *Error

New error code and msg

func (*Error) Code

func (e *Error) Code() int

Code return error code

func (*Error) Error

func (e *Error) Error() string

func (*Error) GRPCStatus

func (e *Error) GRPCStatus() *status.Status

func (*Error) Message

func (e *Error) Message() string

Message return error message

type ErrorV2

type ErrorV2 struct {
	Status
	// contains filtered or unexported fields
}

ErrorV2 struct

func AnalyseErrorV2

func AnalyseErrorV2(err error) *ErrorV2

analyse error info

func DeepClone

func DeepClone(err *ErrorV2) *ErrorV2

DeepClone deep clone error to a new error.

func FromError

func FromError(err error) *ErrorV2

FromError try to convert an error to *ErrorV2. It supports wrapped errors.

func NewV2

func NewV2(code int, reason string, message string) *ErrorV2

NewV2 returns an error object for the code, message.

func (*ErrorV2) Code

func (e *ErrorV2) Code() int

Code returns the code of the error.

func (*ErrorV2) Equal

func (e *ErrorV2) Equal(code int, reason ...string) bool

Equal matches error from code and reason.

func (*ErrorV2) Error

func (e *ErrorV2) Error() string

func (*ErrorV2) GRPCStatus

func (e *ErrorV2) GRPCStatus() *status.Status

GRPCStatus returns the Status represented by error.

func (*ErrorV2) Is

func (e *ErrorV2) Is(err error) bool

Is matches each error in the chain with the target value.

func (*ErrorV2) Message

func (e *ErrorV2) Message() string

Message returns the message of the error.

func (*ErrorV2) Reason

func (e *ErrorV2) Reason() string

Reason returns the reason of the error.

func (*ErrorV2) Unwrap

func (e *ErrorV2) Unwrap() error

Unwrap provides compatibility for Go 1.13 error chains.

func (*ErrorV2) WithCause

func (e *ErrorV2) WithCause(cause error) *ErrorV2

WithCause with the underlying cause of the error.

func (*ErrorV2) WithMetadata

func (e *ErrorV2) WithMetadata(md map[string]string) *ErrorV2

WithMetadata with an MD formed by the mapping of key, value.

type Status

type Status struct {
	Code     int32             `protobuf:"varint,1,opt,name=code,proto3" json:"code,omitempty"`
	Reason   string            `protobuf:"bytes,2,opt,name=reason,proto3" json:"reason,omitempty"`
	Message  string            `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
	Metadata map[string]string `` /* 157-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*Status) Descriptor

func (*Status) Descriptor() ([]byte, []int)

Deprecated: Use Status.ProtoReflect.Descriptor instead.

func (*Status) GetCode

func (x *Status) GetCode() int32

func (*Status) GetMessage

func (x *Status) GetMessage() string

func (*Status) GetMetadata

func (x *Status) GetMetadata() map[string]string

func (*Status) GetReason

func (x *Status) GetReason() string

func (*Status) ProtoMessage

func (*Status) ProtoMessage()

func (*Status) ProtoReflect

func (x *Status) ProtoReflect() protoreflect.Message

func (*Status) Reset

func (x *Status) Reset()

func (*Status) String

func (x *Status) String() string