- 原文地址:Part 30: Error Handling
- 原文作者:Naveen R
- 译者:咔叽咔叽
转载请注明出处。
什么是Error?
Error表示程序中的异常情况。假设我们正在尝试打开文件,文件系统中不存在该文件,那么这是一种异常情况,它就代表一种error
。
Go中使用内置的error
类型表示错误。
就像任何其他的内置类型,如int,float64,... error
可以存储在变量中,从函数返回等等。
例子
用打开了一个不存在的文件的示例程序来解释一下。
package main
import (
"fmt"
"os"
)
func main() {
f, err := os.Open("/test.txt")
if err != nil {
fmt.Println(err)
return
}
fmt.Println(f.Name(), "opened successfully")
}
上面的程序中,我们试图在路径/test.txt中打开文件。 os包的Open函数定义如下,
func Open(name string) (file *File, err error)
如果文件被成功打开,则Open函数将会返回打开的文件,同时err为nil。如果在打开文件时出错,err将返回非nil的错误。
如果一个函数或者方法返回错误,那么按照惯例,函数返回值的最后面那一个值就是err。所以,Open函数返回的最后一个值是err。
在Go中处理错误的惯用方法是将返回的错误与nil进行比较。 如果返回的err是nil,则表示没有发生错误,非nil值则表示存在错误。在我们的例子中,我们在第10行检查错误的返回值,如果它不是nil,我们只需打印错误并从main函数返回。
运行上述程序将打印,
open /test.txt: No such file or directory
完美????。我们打印了一条错误消息,显示了该文件不存在。
Error type
让我们再深入一点,看看如何定义内置的错误类型。 error是具有以下定义的接口类型,
type error interface {
Error() string
}
它包含一个Error方法,实现此接口的Error
就可以被用作error
。此方法提供了error
的描述
当打印error
时,fmt.Println
函数在内部调用Error
方法以获取error
的描述。上述例子的第11行就展示了error
描述的打印。
如何从error中提取更多的信息
在上面的例子中我们看到打印了错误的描述。如果我们想要导致error
的文件的实际路径,该怎么办?一种可能的方法是解析错误字符串。这是输出,
open /test.txt: No such file or directory
我们可以获得错误内容并获取导致错误的文件的文件路径为“/test.txt”,但这不是一种很好的方式。在有些情况下,我们应该捕获更多的错误信息,然后根据不同的错误去做区别处理。(类似其他的语言catch多个错误)
有没有办法可靠地获取文件名?答案是肯定的,标准的Go库使用不同的方式来提供有关error
的更多信息。让我们逐一看看它们。
1. 从底层结构类型的字段中获取更多信息
如果仔细阅读Open函数的文档,可以看到其error
返回类型为*PathError
。 PathError
是一种结构类型,它在标准库中的实现如下,
type PathError struct {
Op string
Path string
Err error
}
func (e *PathError) Error() string { return e.Op + " " + e.Path + ": " + e.Err.Error() }
如果有兴趣知道上述源代码的位置,可以在此处找到https://golang.org/src/os/error.go?s=653:716#L11
从上面的代码中,可以知道* PathError
通过声明Error
方法来实现error
的接口。此方法返回一个包含路径,实际错误拼接的字符串并返回。因此我们收到了这个错误内容,
open /test.txt: No such file or directory
PathError struct
的Path
字段包含导致错误的文件的路径。让我们修改上面编写的程序并打印路径。
package main
import (
"fmt"
"os"
)
func main() {
f, err := os.Open("/test.txt")
if err, ok := err.(*os.PathError); ok {
fmt.Println("File at path", err.Path, "failed to open")
return
}
fmt.Println(f.Name(), "opened successfully")
}
在上面的程序中,我们在第10行从结构字段中去获取error
的基础值。然后我们在11行使用err.Path
打印路径。 输出如下,
File at path /test.txt failed to open
我们已成功使用结构字段从错误中获取文件路径。
2. 使用基础结构类型的方法获取更多信息
第二种方法是通过调用struct类型的方法获取更多信息。
让我们通过一个例子更好地理解这一点。
标准库中的DNSError
结构类型定义如下,
type DNSError struct {
...
}
func (e *DNSError) Error() string {
...
}
func (e *DNSError) Timeout() bool {
...
}
func (e *DNSError) Temporary() bool {
...
}
从上面的代码中可以看出,DNSError
结构有两个方法Timeout
和Temporary
,它们返回一个布尔值,指示error
是由于超时还是暂时的。
让我们编写一个包含* DNSError
类型的程序,并调用这些方法来确定error
是暂时错误类型还是超时错误类型。
package main
import (
"fmt"
"net"
)
func main() {
addr, err := net.LookupHost("golangbot123.com")
if err, ok := err.(*net.DNSError); ok {
if err.Timeout() {
fmt.Println("operation timed out")
} else if err.Temporary() {
fmt.Println("temporary error")
} else {
fmt.Println("generic error: ", err)
}
return
}
fmt.Println(addr)
}
注意:LookupHost
在playground上不起作用。请在本地计算机上运行此程序。
在上面的程序中,我们在第9行试图获取一个无效域名golangbot123.com
的IP地址。我们通过* net.DNSError
来获取错误的基础值。然后我们在第10和13行分别检查error
是由于超时还是临时引起的。
在我们的例子中,错误既不是暂时的也不是由于超时,因此程序将打印,
generic error: lookup golangbot123.com: no such host
如果错误是临时的或由于超时,则执行相应的if语句,这样就可以分情况适当地处理它了。
3. 直接比较
获取有关错误的更多详细信息的第三种方法是直接与类型错误的变量进行比较。让我们通过一个例子来理解这一点。
filepath
包的Glob
函数用于返回与正则模式匹配的所有文件的名称。格式错误时,此函数返回错误ErrBadPattern
。
ErrBadPattern
在filepath
包中定义如下,
var ErrBadPattern = errors.New("syntax error in pattern")
errors.New
用于创建一个新的error
。我们将在下一个教程中详细讨论这个问题。
当匹配发生格式错误时,Glob
函数返回ErrBadPattern
。
让我们编写一个小程序来检查这个error
。
package main
import (
"fmt"
"path/filepath"
)
func main() {
files, error := filepath.Glob("[")
if error != nil && error == filepath.ErrBadPattern {
fmt.Println(error)
return
}
fmt.Println("matched files", files)
}
在上面的程序中,我们匹配带有[
的文件,这是一个格式错误的方式。我们检查error
是否为nil
。要获得有关error
的更多信息,我们在第10行直接将它与filepath.ErrBadPattern
进行比较。如果条件满足,则是因为格式错误。所以该程序将输出,
syntax error in pattern
标准库使用上述方法提供有关error
的更多信息。我们将在下一个教程中使用这些方法来创建自己的自定义错误。
不要忽视Error
永远不要忽视error
。忽略error
会引发麻烦。让我重写一个示例,该示例忽略了error
处理。
package main
import (
"fmt"
"path/filepath"
)
func main() {
files, _ := filepath.Glob("[")
fmt.Println("matched files", files)
}
我们从前面的例子中已经知道匹配是无效的。我在第9行通过使用_
标识符忽略了Glob
函数返回的error
。然后在第10行打印该匹配的文件。程序将打印,
matched files []
由于我们忽略了error
,似乎没有输出匹配文件,但实际上是模式本身的格式不正确,这样就不知道到底是什么导致泐该 error
的产生。所以不要忽视error
。
在本教程中,我们讨论了如何处理程序中发生的error
以及如何检查error
以从中获取更多信息。
在下一个教程中,我们将创建自己的自定义 error
,并为标准error
添加更多上下文。
有疑问加站长微信联系(非本文作者)