README_zh.md

使用例子

错误记录器

本设计补充并实现了系统的error接口，

用于发生错误时附带发生错误的原因、位置等信息以便还原现场。

因本错误设计含有比较大的数据量信息，因此需要注意被调用的频率，以避免影响到系统效率。

• 使用例子

package main

import "github.com/gwaylib/errors"

func fn1(a int) error {
   if a == 0 {
       // 返回内置定义的无数据的错误
       return errors.ErrNoData.As(a)
   }
   // 返回其他错误
   return errors.New("not implements").As(a)
}

func fn2(b int) error {
   // 设置一个错误调用位置，若fn1返回nil, 则不设置位置信息
   return errors.As(fn1(b))
}

func main() {
   err := fn2(2)
   if err != nil {
 	  // 注意，errors.ErrNoData == err 会不一定成立, 应使用Equal方法
       if !errors.ErrNoData.Equal(err) {
           panic(err)
       }
       // 处理错误码相等的情况
       fmt.Println(err)
   }
}

• 定位信息解析

Output：
["test",["errors_test.go:90#errors.TestAs"],["errors_test.go:95#errors.TestAs",123,456]]

Decode: 
ErrData[0] -- errors.New()输入的值
ErrData[1:] -- 其他为辅助定位
ErrData[1][0] -- 第一次调用时的位置信息
ErrData[1][1:] -- 第一次调用时手动填写错误原因参数

错误处理建议

• 优先处理错误，再处理正常逻辑, 此时错误将不容易被忽略而使程序更健壮；
• 除非明确了错误处理结果，错误应总是向上一级返回给调用者；
• 若不能向上一级返回, 应给出用户提示或记录日志，而不是丢弃错误以便完整知道系统发生了什么。
• 正常逻辑尽可能不放在if中，以便于缩进阅读。

// 建议写法
rows, err := db.Query(...)
if err != nil{
    return errors.As(err)
}
defer rows.Close()
...

// 不建议写法
rows, err := db.Query(...)
if err == nil{
    defer rows.Close()
    // ...
} else {
    // 处理错误，或不处理错误
}

// 除非必要，应尽量定义错误在最小范围内，避免定义跨范围使用，它易将错误发散到整个函数而失去可控性
func Get() (err error){
    defer func(){
        if err != nil{
            // 处理错误
        }
    }()

    // ...
}