codes

package
v1.0.9 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 18, 2026 License: MIT Imports: 4 Imported by: 0

Documentation

Index

Constants

View Source
const (
	CategoryGeneral    = 0    // 通用错误起始
	CategoryNetwork    = 100  // 网络错误起始
	CategorySession    = 200  // 会话错误起始
	CategoryRoute      = 300  // 路由错误起始
	CategoryConfig     = 400  // 配置错误起始
	CategoryService    = 500  // 服务错误起始
	CategorySecurity   = 600  // 安全错误起始
	CategoryEncoding   = 700  // 编码错误起始
	CategoryCustomBase = 1000 // 用户自定义错误码起始
)

错误码分类范围

Variables

View Source
var (
	OK                = NewCode(0, "ok")
	Canceled          = NewCode(1, "canceled")
	Unknown           = NewCode(2, "unknown")
	InvalidArgument   = NewCode(3, "invalid argument")
	DeadlineExceeded  = NewCode(4, "deadline exceeded")
	NotFound          = NewCode(5, "not found")
	InternalError     = NewCode(6, "internal error")
	Unauthorized      = NewCode(7, "unauthorized")
	IllegalInvoke     = NewCode(8, "illegal invoke")
	IllegalRequest    = NewCode(9, "illegal request")
	TooManyRequests   = NewCode(10, "too many requests")
	InvalidPointer    = NewCode(11, "invalid pointer")
	InvalidFormat     = NewCode(12, "invalid format")
	PermissionDenied  = NewCode(13, "permission denied")
	ResourceExhausted = NewCode(14, "resource exhausted")
	Unavailable       = NewCode(15, "unavailable")
	Unimplemented     = NewCode(16, "unimplemented")
	InvalidSeekWhence = NewCode(17, "invalid seek whence")
	NegativePosition  = NewCode(18, "negative position")
	IndexOverflow     = NewCode(19, "index overflow")
	BadSyntax         = NewCode(20, "bad syntax")
)
View Source
var (
	ConnectionOpened    = NewCode(100, "connection is opened")
	ConnectionHanged    = NewCode(101, "connection is hanged")
	ConnectionClosed    = NewCode(102, "connection is closed")
	ConnectionNotOpened = NewCode(103, "connection is not opened")
	ConnectionNotHanged = NewCode(104, "connection is not hanged")
	TooManyConnections  = NewCode(105, "too many connections")
	NetworkError        = NewCode(106, "network error")
	ReadError           = NewCode(107, "read error")
	WriteError          = NewCode(108, "write error")
	InvalidReader       = NewCode(109, "invalid reader")
	UnexpectedEOF       = NewCode(110, "unexpected EOF")
)
View Source
var (
	SessionNotFound      = NewCode(200, "session not found")
	InvalidSessionKind   = NewCode(201, "invalid session kind")
	UserNotFound         = NewCode(202, "user not found")
	UserLocationNotFound = NewCode(203, "user location not found")
	InvalidGateID        = NewCode(204, "invalid gate id")
	InvalidNodeID        = NewCode(205, "invalid node id")
	ActorExists          = NewCode(206, "actor exists")
	ActorNotFound        = NewCode(207, "actor not found")
	ActorNotBound        = NewCode(208, "actor not bound")
)
View Source
var (
	RouteNotFound     = NewCode(300, "route not found")
	RouteUnregistered = NewCode(301, "route unregistered")
	RouteOverflow     = NewCode(302, "route overflow")
	EventNotFound     = NewCode(303, "event not found")
	InvalidMessage    = NewCode(304, "invalid message")
	MessageTooLarge   = NewCode(305, "message too large")
	SeqOverflow       = NewCode(306, "seq overflow")
	TargetEmpty       = NewCode(307, "receive target is empty")
	InvalidDecoder    = NewCode(308, "invalid decoder")
	InvalidScanner    = NewCode(309, "invalid scanner")
)
View Source
var (
	InvalidConfig           = NewCode(400, "invalid config")
	ConfigSourceNotFound    = NewCode(401, "config source not found")
	MissingComponent        = NewCode(402, "missing component")
	MissingTransporter      = NewCode(403, "missing transporter")
	MissingDiscovery        = NewCode(404, "missing discovery")
	MissingLocator          = NewCode(405, "missing locator")
	MissingResolver         = NewCode(406, "missing resolver")
	MissingDispatchStrategy = NewCode(407, "missing dispatch strategy")
	MissingCacheInstance    = NewCode(408, "missing cache instance")
	MissingEventbusInstance = NewCode(409, "missing eventbus instance")
	ComponentClosed         = NewCode(410, "component closed")
	ClientShut              = NewCode(411, "client is shut")
	ServerClosed            = NewCode(412, "server is closed")
	SyncerClosed            = NewCode(413, "syncer is closed")
	InvalidFilePath         = NewCode(414, "invalid file path")
	InvalidServerURL        = NewCode(415, "invalid server url")
)
View Source
var (
	EndpointNotFound        = NewCode(500, "endpoint not found")
	ServiceAddressNotFound  = NewCode(501, "service address not found")
	ServiceRegisterFailed   = NewCode(502, "service register failed")
	ServiceDeregisterFailed = NewCode(503, "service deregister failed")
	InvalidServiceDesc      = NewCode(504, "invalid service desc")
)
View Source
var (
	InvalidPublicKey  = NewCode(600, "invalid public key")
	InvalidPrivateKey = NewCode(601, "invalid private key")
	InvalidSignature  = NewCode(602, "invalid signature")
	InvalidCertFile   = NewCode(603, "invalid cert file")
	EncryptionError   = NewCode(604, "encryption error")
	DecryptionError   = NewCode(605, "decryption error")
	InvalidKeyFormat  = NewCode(606, "invalid key format")
	BlockSizeTooLarge = NewCode(607, "block size too large for RSA key")
)
View Source
var (
	CodecNotRegistered     = NewCode(700, "codec not registered")
	SignerNotRegistered    = NewCode(701, "signer not registered")
	EncryptorNotRegistered = NewCode(702, "encryptor not registered")
	ProtoMarshalError      = NewCode(703, "proto marshal error")
	ProtoUnmarshalError    = NewCode(704, "proto unmarshal error")
)

Functions

func CategoryOf added in v1.0.9

func CategoryOf(err error) int

CategoryOf 获取错误的分类

func IsCode added in v1.0.9

func IsCode(err error, code *Code) bool

IsCode 判断错误是否是指定错误码

func IsConfigErr added in v1.0.9

func IsConfigErr(err error) bool

IsConfigErr 判断错误是否是配置错误

func IsEncodingErr added in v1.0.9

func IsEncodingErr(err error) bool

IsEncodingErr 判断错误是否是编码错误

func IsNetworkErr added in v1.0.9

func IsNetworkErr(err error) bool

IsNetworkErr 判断错误是否是网络错误

func IsRouteErr added in v1.0.9

func IsRouteErr(err error) bool

IsRouteErr 判断错误是否是路由错误

func IsSecurityErr added in v1.0.9

func IsSecurityErr(err error) bool

IsSecurityErr 判断错误是否是安全错误

func IsServiceErr added in v1.0.9

func IsServiceErr(err error) bool

IsServiceErr 判断错误是否是服务错误

func IsSessionErr added in v1.0.9

func IsSessionErr(err error) bool

IsSessionErr 判断错误是否是会话错误

Types

type Code

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

func Convert

func Convert(err error) *Code

Convert 将错误信息转换为错误码

func NewCode

func NewCode(code int, message ...string) *Code

NewCode 新建一个错误码

func (*Code) Category added in v1.0.9

func (c *Code) Category() int

Category 返回错误码所属分类

func (*Code) Code

func (c *Code) Code() int

Code 返回错误码

func (*Code) Err

func (c *Code) Err() error

Err 转错误消息

func (*Code) Format

func (c *Code) Format(s fmt.State, verb rune)

Format 格式化输出 %s : 打印错误码和错误消息 %v : 打印错误码、错误消息、错误详情

func (*Code) IsConfigError added in v1.0.9

func (c *Code) IsConfigError() bool

IsConfigError 是否是配置错误

func (*Code) IsEncodingError added in v1.0.9

func (c *Code) IsEncodingError() bool

IsEncodingError 是否是编码错误

func (*Code) IsGeneral added in v1.0.9

func (c *Code) IsGeneral() bool

IsGeneral 是否是通用错误

func (*Code) IsNetworkError added in v1.0.9

func (c *Code) IsNetworkError() bool

IsNetworkError 是否是网络错误

func (*Code) IsRouteError added in v1.0.9

func (c *Code) IsRouteError() bool

IsRouteError 是否是路由错误

func (*Code) IsSecurityError added in v1.0.9

func (c *Code) IsSecurityError() bool

IsSecurityError 是否是安全错误

func (*Code) IsServiceError added in v1.0.9

func (c *Code) IsServiceError() bool

IsServiceError 是否是服务错误

func (*Code) IsSessionError added in v1.0.9

func (c *Code) IsSessionError() bool

IsSessionError 是否是会话错误

func (*Code) Message

func (c *Code) Message() string

Message 返回错误码消息

func (*Code) String

func (c *Code) String() string

String 格式化错误码

func (*Code) WithCode

func (c *Code) WithCode(code int) *Code

WithCode 替换新的错误码

func (*Code) WithMessage

func (c *Code) WithMessage(message string) *Code

WithMessage 替换新的错误码消息

func (*Code) WithMessagef added in v1.0.7

func (c *Code) WithMessagef(format string, a ...any) *Code

WithMessagef 格式化替换新的错误码消息

type Error

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

func (*Error) Code added in v1.0.9

func (e *Error) Code() *Code

Code 返回错误码

func (*Error) Error

func (e *Error) Error() string

Error error interface implementation

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL