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

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

  • 格式：

    1. NewOption(option Option) error

  • 示例：

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

fmt 格式化

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

格式符输出内容
%v, %s打印所有的层级错误信息，构成完成的字符串返回，多个层级使用:拼接。
%-v, %-s打印当前层级的错误信息，返回字符串。
%+s打印完整的堆栈信息列表。
%+v打印所有的层级错误信息字符串，以及完整的堆栈信息，等同于%s\n%+s。

使用示例：

  1. package main
  3. import (
  4.     "errors"
  5.     "fmt"
  6.     "github.com/gogf/gf/v2/errors/gerror"
  7. )
  9. func main() {
  10.     var err error
  11.     err = errors.New("sql error")
  12.     err = gerror.Wrap(err, "adding failed")
  13.     err = gerror.Wrap(err, "api calling failed")
  14.     fmt.Printf(" %%s: %s\n", err)
  15.     fmt.Printf("%%-s: %-s\n", err)
  16.     fmt.Println("%+s: ")
  17.     fmt.Printf("%+s\n", err)
  18. }
  20. // Output:
  21. //  %s: api calling failed: adding failed: sql error
  22. // %-s: api calling failed
  23. // %+s:
  24. // 1. api calling failed
  25. //     1).  main.main
  26. //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
  27. // 2. adding failed
  28. //     1).  main.main
  29. //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
  30. // 3. sql error

日志输出支持

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

使用示例：

  1. package main
  3. import (
  4.     "errors"
  5.     "github.com/gogf/gf/v2/frame/g"
  6.     "github.com/gogf/gf/v2/errors/gerror"
  7. )
  9. func main() {
  10.     var err error
  11.     err = errors.New("sql error")
  12.     err = gerror.Wrap(err, "adding failed")
  13.     err = gerror.Wrap(err, "api calling failed")
  14.     g.Log().Printf("%+v", err)
  15. }
  17. // Output:
  18. // 2020-10-17 15:22:26.793 api calling failed: adding failed: sql error
  19. // 1. api calling failed
  20. //     1).  main.main
  21. //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
  22. // 2. adding failed
  23. //     1).  main.main
  24. //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
  25. // 3. sql error