公众号:程序员读书,欢迎关注
Go
语言函数(或方法)是支持多个返回值的,因此在Go
语言的编程哲学中,函数的返回值的最后一个通常都是error
类型:
go
//标准os包下的函数
func Open(name string) (*File, error) {
return OpenFile(name, O_RDONLY, 0)
}
把error
类型作为函数的最后一个返回值,其作用在于告诉调用者函数在执行过程是否发生错误,当返回的error
值为nil
,表示函数正常执行。
其实,error
类型本质上是一个Go
内置的接口,其定义如下:
go
type error interface {
Error() string
}
从上面error
的定义可以看到error
接口只有一个Error()
方法。
遵循着Go
语言的编程哲学,当我们开发自己的函数时最好也把error
作为函数的最后一个返回值。
即然要返回error
类型,那么就必须先创建error
类型,怎么创建呢?在这篇文章我们简单学习三种创建error
类型的方式。
使用errors包
Go
标准库errors
包为了我们提供了一个最简单的error
接口实现:
go
//errors包errors.go文件
type errorString struct {
s string
}
func (e *errorString) Error() string {
return e.s
}
从上面的定义可以看到errorString
实现了error
接口,且参数非常简单,只有一个文本信息,通过errors.New()
函数可以创建一个errorString
类型:
go
package school
import "errors"
type Student struct {
ID int
Name string
Score int
}
func NewStudent(id int, name string, score int) (*Student, error) {
if id <= 0 {
return nil, errors.New("id could not less than 0")
}
if score < 0 || score > 100 {
return nil, errors.New("score must between 0 and 100")
}
return &Student{id, name, score}, nil
}
fmt.Errorf()函数
有时候我们需要复杂的错误信息,如果直接调用errors.New()
方法的话,需要自己拼接字符串,而标准库fmt
包的Errorf()
函数可以格式化文本并返回一个error
类型:
go
package school
import (
"fmt"
)
type Student struct {
ID int
Name string
Score int
}
func NewStudent(id int, name string, score int) (*Student, error) {
if id <= 0 {
return nil, fmt.Errorf("%d is less than 0", id)
}
if score < 0 || score > 100 {
return nil, fmt.Errorf("%d is not between 0 and 100", score)
}
return &Student{id, name, score}, nil
}
自己实现error接口
上述的两种创建error
类型方式,本质上包内部有一个error
接口的实现,所以如果我们希望返回更详细的错误类型,方便调用者判断,可以实现自己的错误类型:
go
package main
import (
"fmt"
"net/http"
)
type ResponseError struct {
code int
message string
}
func (r ResponseError) Error() string {
return fmt.Sprintf(`{"code":%d,"message":"%s"}`, r.code, r.message)
}
func getUser(id string) (map[string]string, error) {
if len(id) == 0 {
return nil, &ResponseError{1, "id不能为空"}
}
return map[string]string{"id": id, "name": "测试"}, nil
}
func main() {
http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
id := r.FormValue("id")
user, err := getUser(id)
if err != nil {
fmt.Fprint(w, err)
return
}
fmt.Fprint(w, user)
})
http.ListenAndServe(":80", nil)
}
小结
error
类型是Go
语言的内置类型,其本质是一个只有Error()
方法的接口,因此只要实现该方法就可以作为error
类型使用。