ecode

背景

错误码一般被用来进行异常传递，且需要具有携带message文案信息的能力。

错误码之Codes

在sky_blue里，错误码被设计成Codes接口，声明如下代码位置：

// Codes ecode error interface which has a code & message.
type Codes interface {
	// sometimes Error return Code in string form
	// NOTE: don't use Error in monitor report even it also work for now
	Error() string
	// Code get error code.
	Code() int
	// Message get code message.
	Message() string
	//Detail get error detail,it may be nil.
	Details() []interface{}
}

// A Code is an int error code spec.
type Code int

可以看到该接口一共有四个方法，且type Code int结构体实现了该接口。

注册message

一个Code错误码可以对应一个message，默认实现会从全局变量_messages中获取，业务可以将自定义Code对应的message通过调用Register方法的方式传递进去，如：

cms := map[int]string{
    0: "success",
    101: "param is error",
}
ecode.Register(cms)

fmt.Println(ecode.OK.Message()) // 输出：很好很强大！

注意：map[int]string类型并不是绝对，比如有业务要支持多语言的场景就可以扩展为类似map[int]LangStruct的结构，因为全局变量_messages是atomic.Value类型，只需要修改对应的Message方法实现即可。

Details

Details接口为gRPC预留

转换为ecode

错误码转换有以下两种情况：

1. 因为框架传递错误是靠ecode错误码，比如bm框架返回的code字段默认就是数字，那么客户端接收到如{"code":404}的话，可以使用ec := ecode.Int(404)或ec := ecode.String("404")来进行转换。
2. 在项目中dao层返回一个错误码，往往返回参数类型建议为error而不是ecode.Codes，因为error更通用，那么上层service就可以使用ec := ecode.Cause(err)进行转换。

判断

错误码判断是否相等：

1. ecode与ecode判断使用：ecode.Equal(ec1, ec2)
2. ecode与error判断使用：ecode.EqualError(ec, err)

package ecode

import (
    "github.com/zdao-pro/sky_blue/pkg/ecode"
)

var _ ecode.Codes

// UserErrCode
var (
    UserNotLogin = ecode.New(144, 'user no login');
)