ecode

Documentation

Index

• Constants
• Variables
• func New(code int, err error) error
• func Transform(err error) int
• type ErrorV2
  • func AnalyseErrorV2(err error) *ErrorV2
  • func DeepClone(err *ErrorV2) *ErrorV2
  • func FromError(err error) *ErrorV2
  • func NewV2(code int, message string) *ErrorV2
  • func NewV2WithReason(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
	SystemErrorCode = -1
	// 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(1, "success")
	SystemError = NewV2(SystemErrorCode, "system error")
)

var DefaultConverter = statusConverter{}

DefaultConverter default converter.

var File_errors_proto protoreflect.FileDescriptor

Functions

func New

func New(code int, err error) error

New 注册Error异常

func Transform

func Transform(err error) int

Transform 通过error获取对应的code码

Types

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, message string) *ErrorV2

NewV2 returns an error object for the code, message.

func NewV2WithReason

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

NewV2WithReason 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