脱线道士维克多 - Go 的错误和异常处理

Go 的错误和异常处理 - 1 error

设计思想

Go 语言希望开发者将错误处理视为正常开发必须实现的环节。

Go 错误设计是通过返回值的方式，来强迫调用者对错误进行处理。你有两个选择：

忽略
处理(返回给调用者处也算处理)，返回给调用者可以跟踪 error 的路径信息

error 接口

error 类型是一个接口类型，这是它的定义：

// The error built-in interface type is the conventional interface for
// representing an error condition, with the nil value representing no error.
type error interface {
    Error() string
}

它只有一个方法 Error，只要实现了这个方法，就是实现了 error。

type fileError struct {
}

func (fe *fileError) Error() string {
    return "文件错误"
}

自定义 error

上面已经定义了一个 fileError 类型，实现了 error 接口。现在测试下看看效果。

func main() {
    conent, err := openFile()
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(string(conent))
    }
}

// 只是模拟一个错误
func openFile() ([]byte, error) {
    return nil, &fileError{}
}

在实际项目中，每个错误的信息提示都不一样，再修改一下，让错误文字可以设置。

type fileError struct {
    s string
}

func (fe *fileError) Error() string {
    return fe.s
}

//只是模拟一个错误
func openFile() ([]byte, error) {
    return nil, &fileError{"文件错误，自定义"}
}

接下来继续修改，把错误类型的名字改一下，再创建一个辅助函数，以便我们创建不同的错误类型。

type errorString struct {
    s string
}

func (e *errorString) Error() string {
    return e.s
}

func New(text string) error {
    return &errorString{text}
}

//只是模拟一个错误
func openFile() ([]byte, error) {
    return nil, New("文件错误，自定义")
}

错误处理

在下面的例子中，我们在调用 Sqrt 的时候传递的一个负数，然后就得到了 non-nil 的 error 对象，将此对象与 nil 比较，结果为 true，所以 fmt.Println fmt包在处理 error 时会调用 Error 方法，以输出错误，请看下面调用的示例代码：

result, err := Sqrt(-1)

if err != nil {
    fmt.Println(err)
}

实例

在 Go 语言中使用 errors 包进行错误的定义，errors.New 可返回一个错误信息：

func Sqrt(f float64) (float64, error) {
    if f < 0 {
        return 0, errors.New("math: square root of negative number")
    }
    // 实现
}

使用 errors.New 定义的错误字符串的错误类型无法提供丰富的错误信息，需要借助自定义结构体实现错误接口。所有符合 Error() string 格式的方法，都能实现错误接口。

package main

import (
    "fmt"
)

// 定义一个 DivideError 结构
type DivideError struct {
    dividee int
    divider int
}

// 实现 `error` 接口
func (de *DivideError) Error() string {
    strFormat := `
    Cannot proceed, the divider is zero.
    dividee: %d
    divider: 0
`
    return fmt.Sprintf(strFormat, de.dividee)
}

// 定义 `int` 类型除法运算的函数
func Divide(varDividee int, varDivider int) (result int, errorMsg string) {
    if varDivider == 0 {
            dData := DivideError{
                    dividee: varDividee,
                    divider: varDivider,
            }
            errorMsg = dData.Error()
            return
    } else {
            return varDividee / varDivider, ""
    }

}

func main() {

    // 正常情况
    if result, errorMsg := Divide(100, 10); errorMsg == "" {
            fmt.Println("100/10 = ", result)
    }
    // 当被除数为零的时候会返回错误信息
    if _, errorMsg := Divide(100, 0); errorMsg != "" {
            fmt.Println("errorMsg is: ", errorMsg)
    }

}

执以上程序，输出结果为：

100/10 =  10
errorMsg is:
    Cannot proceed, the divider is zero.
    dividee: 100
    divider: 0

Go 的错误和异常处理 - 1 error

设计思想

error 接口

自定义 error

错误处理

实例

相关链接

本文节选

延伸阅读