Go 1.13的errors挺香

前段时间Go发布了1.13,但是因为还没有进Arch的官方库,所以没去尝试。今天抽空试了一下,非常香。我们先来看个例子,然后 看看源码:

package main

import (
	"errors"
	"fmt"
)

func doSomethingWrong(o error) error {
	return fmt.Errorf("%w wrapped error", o)
}

func main() {
	// o: original
	// n: new error
	o := errors.New("original error")

	fmt.Printf("error: %s\n", o)
	n := doSomethingWrong(o)
	fmt.Printf("error: %s\n", n)

	fmt.Printf("n is o: %t\n", errors.Is(n, o))
}

这次增加了四个函数:

  • errors.Is 判断是否a错误是否是b错误的后代
  • errors.Unwrap 将a错误的包装剔除一层
  • errors.As 将a错误一直剔除到错误类型为 B 类型为止
  • fmt.Errorf("%w", err) 将err错误包装一层

我们来看看实现:

func Errorf(format string, a ...interface{}) error {
	p := newPrinter()
	p.wrapErrs = true
	p.doPrintf(format, a)
	s := string(p.buf)
	var err error
	if p.wrappedErr == nil {
		err = errors.New(s)
	} else {
		err = &wrapError{s, p.wrappedErr}
	}
	p.free()
	return err
}

type wrapError struct {
	msg string
	err error
}

func (e *wrapError) Error() string {
	return e.msg
}

func (e *wrapError) Unwrap() error {
	return e.err
}

这是 fmt.Errorf 的实现。原理很简单,就是将 err 放到 wrapErrorerr 属性里,将错误信息放到 msg 里。

func Unwrap(err error) error {
	u, ok := err.(interface {
		Unwrap() error
	})
	if !ok {
		return nil
	}
	return u.Unwrap()
}

就是调用 wrapError.Unwrap 方法。

func Is(err, target error) bool {
	if target == nil {
		return err == target
	}

	isComparable := reflectlite.TypeOf(target).Comparable()
	for {
		if isComparable && err == target {
			return true
		}
		if x, ok := err.(interface{ Is(error) bool }); ok && x.Is(target) {
			return true
		}
		// TODO: consider supporing target.Is(err). This would allow
		// user-definable predicates, but also may allow for coping with sloppy
		// APIs, thereby making it easier to get away with them.
		if err = Unwrap(err); err == nil {
			return false
		}
	}
}

就是一层一层往上检查看是否能匹配。

func As(err error, target interface{}) bool {
	if target == nil {
		panic("errors: target cannot be nil")
	}
	val := reflectlite.ValueOf(target)
	typ := val.Type()
	if typ.Kind() != reflectlite.Ptr || val.IsNil() {
		panic("errors: target must be a non-nil pointer")
	}
	if e := typ.Elem(); e.Kind() != reflectlite.Interface && !e.Implements(errorType) {
		panic("errors: *target must be interface or implement error")
	}
	targetType := typ.Elem()
	for err != nil {
		if reflectlite.TypeOf(err).AssignableTo(targetType) {
			val.Elem().Set(reflectlite.ValueOf(err))
			return true
		}
		if x, ok := err.(interface{ As(interface{}) bool }); ok && x.As(target) {
			return true
		}
		err = Unwrap(err)
	}
	return false
}

As 就是一层一层网上剥离,然后看哪一层能够和给定的错误类型匹配,然后把值放进去。

真香。


参考资料:


更多文章
  • Python中优雅的处理文件路径
  • Go语言MySQL时区问题
  • 我的技术栈选型
  • 为什么我要用Linux作为桌面?
  • disqus获取评论时忽略query string
  • MySQL性能优化指南
  • 网络编程所需要熟悉的那些函数
  • DNSCrypt简明教程
  • SQLAlchemy简明教程
  • 这些年,我们错过的n个亿
  • 给Linux用户的FreeBSD快速指南
  • 旧电脑也不能闲着:家用备份方案
  • 将SQLite的数据迁移到MySQL
  • Linux托管Windows虚拟机最佳实践
  • 为什么gRPC难以推广