goframe文档 GoFrame 错误处理-其他特性

NewOption自定义配置的错误对象创建

• 说明：用于自定义配置的错误对象创建。
• 格式：

NewOption(option Option) error

• 示例：

func ExampleNewOption() {
 	err := gerror.NewOption(gerror.Option{
		Text: "this feature is disabled in this storage",
		Code: gcode.CodeNotSupported,
	})
}

fmt 格式化

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

使用示例：

package main

import (
	"errors"
	"fmt"
	"github.com/gogf/gf/v2/errors/gerror"
)

func main() {
	var err error
	err = errors.New("sql error")
	err = gerror.Wrap(err, "adding failed")
	err = gerror.Wrap(err, "api calling failed")
	fmt.Printf(" %%s: %sn", err)
	fmt.Printf("%%-s: %-sn", err)
	fmt.Println("%+s: ")
	fmt.Printf("%+sn", err)
}

// Output:
//  %s: api calling failed: adding failed: sql error
// %-s: api calling failed
// %+s:
// 1. api calling failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
// 2. adding failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
// 3. sql error

日志输出支持

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

使用示例：

package main

import (
	"errors"
	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/errors/gerror"
)

func main() {
	var err error
	err = errors.New("sql error")
	err = gerror.Wrap(err, "adding failed")
	err = gerror.Wrap(err, "api calling failed")
	g.Log().Printf("%+v", err)
}

// Output:
// 2020-10-17 15:22:26.793 api calling failed: adding failed: sql error
// 1. api calling failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
// 2. adding failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
// 3. sql error