gerror

使用方式：

接口文档：

https://godoc.org/github.com/gogf/gf/errors/gerror

func New(value interface{}) error
func NewText(text string) error
func Cause(err error) error
func Stack(err error) string
func Wrap(err error, text string) error
func Wrapf(err error, format string, args ...interface{}) error
type Error
    func (err *Error) Cause() error
    func (err *Error) Error() string
    func (err *Error) Format(s fmt.State, verb rune)
    func (err *Error) Stack() string

标准库的error错误实现比较简单，无法进行堆栈追溯，对于产生错误时的上层调用者来讲不是很友好，无法获得错误的调用链详细信息。gerror支持错误堆栈记录，通过New*/Wrap*均会自动记录当前错误产生时的堆栈信息。

使用示例：

package main
import (
    "fmt"
    "github.com/gogf/gf/errors/gerror"
)
func OpenFile() error {
    return gerror.New("permission denied")
}
func OpenConfig() error {
    return gerror.Wrap(OpenFile(), "configuration file opening failed")
}
func ReadConfig() error {
    return gerror.Wrap(OpenConfig(), "reading configuration failed")
}
func main() {
    fmt.Printf("%+v", ReadConfig())
}

reading configuration failed: configuration file opening failed: permission denied
1. reading configuration failed
    1). main.ReadConfig
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:18
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:25
2. configuration file opening failed
    1). main.OpenConfig
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:14
    2). main.ReadConfig
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:18
    3). main.main
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:25
    1). main.OpenFile
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:10
    2). main.OpenConfig
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:14
    3). main.ReadConfig
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:18
    4). main.main
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror2.go:25

可以看到，调用端可以通过Wrap方法将底层的错误信息进行层级叠加，并且包含完整的错误堆栈信息。

通过以上示例我们可以看到，通过%+v的打印格式可以打印出完整的堆栈信息，当然gerror.Error对象支持多种fmt格式：

使用示例：

执行后，终端输出为：

test1, test1, test1
test1, test1, test1
test2, test2, 1.    test2
    1). main.Error2
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror1.go:15
    2). main.main
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror1.go:20
test2, test2, test2
1. test2
    1). main.Error2
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror1.go:15
    2). main.main
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror1.go:20

func Stack(err error) string

通过Stack方法我们可以获得error对象的完整堆栈信息，返回堆栈列表字符串。
注意参数为标准库error类型，当该参数为gerror模块生成的error时，
或者开发者自定义的error对象实现了gerror.ApiStack接口时支持打印，否则，返回空字符串。

package main
import (
    "errors"
    "fmt"
    "github.com/gogf/gf/errors/gerror"
)
func Error1() error {
    return errors.New("test1")
func Error2() error {
    return gerror.New("test2")
}
func main() {
    err1 := Error1()
    err2 := Error2()
    fmt.Println("err1:", gerror.Stack(err1))
    fmt.Println("err2:", gerror.Stack(err2))
}

执行后，终端输出：

func Cause(err error) error

通过Cause方法我们可以获得error对象的根错误信息（原始错误）。
注意参数为标准库error类型，当该参数为gerror模块生成的error时，
或者开发者自定义的error对象实现了gerror.ApiCause接口时支持打印，否则，返回输出的error对象。

使用示例：

package main
import (
    "fmt"
    "github.com/gogf/gf/errors/gerror"
)
func OpenFile() error {
    return gerror.New("permission denied")
}
func OpenConfig() error {
    return gerror.Wrap(OpenFile(), "configuration file opening failed")
}
func ReadConfig() error {
    return gerror.Wrap(OpenConfig(), "reading configuration failed")
}
func main() {
    fmt.Println(gerror.Cause(ReadConfig()))
}

执行后，终端输出：

permission denied

glog日志管理模块天然支持对gerror错误堆栈打印支持，这种支持不是强耦合性的，而是通过fmt格式化打印接口支持的。

执行后，终端输出：

2019-07-13 15:01:31.131 test1
2019-07-13 15:01:31.131 test2
1. test2
    1). main.Error2
        /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/errors/gerror/gerror5.go:16
    2). main.main