个人中心
gpt4 book ai didi

Go应用中优雅处理Error的技巧总结

转载 作者：qq735679552 更新时间：2022-09-29 22:32:09 30 4
gpt4 key购买 nike

CFSDN坚持开源创造价值，我们致力于搭建一个资源共享平台，让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章Go应用中优雅处理Error的技巧总结由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.

前言

Go语言很强大并且现在也十分流行 — 许多项目都是用Go语言来实现的，如Kubernetes。Go语言的一个有趣特性是它的多值返回功能提供了一种与其他编程语言不同的错误处理方法。 Go将error视为具有预定义类型的值，其本身是一个interface类型。然而，编写多层体系结构应用程序并使用api暴露应用的特性需要有包含更多上下文信息的error处理，而不仅仅是一个值。 本文我们将探讨如何封装Go的error类型以在应用程序中带来更大的价值.

用户自定义类型

我们将重写的Go里自带的error类型，首先从一个自定义的错误类型开始，该错误类型将在程序中识别为error类型。因此，我们引入一个封装了Go的 error的新自定义Error类型.

?
1
2
3
type GoError struct {
    error
}

上下文数据

当我们在Go中说error是一个值时，它是字符串值 - 任何实现了Error() string函数的类型都可以视作error类型。将字符串值视为error会使跨层的error处理复杂化，因此处理error字符串信息并不是正确的方法。所以我们可以把字符串和错误码解耦:

?
1
2
3
4
type GoError struct {
    error
    Code    string
}

现在对error的处理将基于错误码Code字段而不是字符串。让我们通过上下文数据进一步对错误字符串进行解耦，在上下文数据中可以使用i18n包进行国际化.

?
1
2
3
4
5
type GoError struct {
    error
    Code    string
    Data    map[string]interface{}
}

Data包含用于构造错误字符串的上下文数据。错误字符串可以通过数据模板化

//i18N def "InvalidParamValue": "Invalid parameter value '{{.actual}}', expected '{{.expected}}' for '{{.name}}'" 。

在i18N定义文件中，错误码Code将会映射到使用Data构建的模板化的错误字符串中.

原因(Causes)

error可能发生在任何一层，有必要为每一层提供处理error的选项，并在不丢失原始error值的情况下进一步使用附加的上下文信息对error进行包装。GoError结构体可以用Causes进一步封装，用来保存整个错误堆栈.

?
1
2
3
4
5
6
type GoError struct {
    error
    Code    string
    Data    map[string]interface{}
    Causes  []error
}

如果必须保存多个error数据，则causes是一个数组类型，并将其设置为基本error类型，以便在程序中包含该原因的第三方错误.

组件(Component)

标记层组件将有助于识别error发生在哪一层，并且可以避免不必要的error wrap。例如，如果service类型的error组件发生在服务层，则可能不需要wrap error。检查组件信息将有助于防止暴露给用户不应该通知的error，比如数据库error:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
type GoError struct {
    error
    Code      string
    Data      map[string]interface{}
    Causes    []error
    Component ErrComponent
}
 
type ErrComponent string
const (
    ErrService  ErrComponent = "service"
    ErrRepo     ErrComponent = "repository"
    ErrLib      ErrComponent = "library"
)

响应类型(ResponseType)

添加一个错误响应类型这样可以支持error分类，以便于了解什么错误类型。例如，可以根据响应类型(如NotFound)对error进行分类，像DbRecordNotFound、ResourceNotFound、UserNotFound等等的error都可以归类为 NotFound error。这在多层应用程序开发过程中非常有用，而且是可选的封装:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
type GoError struct {
    error
    Code         string
    Data         map[string]interface{}
    Causes       []error
    Component    ErrComponent
    ResponseType ResponseErrType
}
 
type ResponseErrType string
 
const (
    BadRequest    ResponseErrType = "BadRequest"
    Forbidden     ResponseErrType = "Forbidden"
    NotFound      ResponseErrType = "NotFound"
    AlreadyExists ResponseErrType = "AlreadyExists"
)

重试

在少数情况下，出现error会进行重试。retry字段可以通过设置Retryable标记来决定是否要进行error重试

?
1
2
3
4
5
6
7
8
9
10
type GoError struct {
    error
    Code         string
    Message      string
    Data         map[string]interface{}
    Causes       []error
    Component    ErrComponent
    ResponseType ResponseErrType
    Retryable    bool
}

GoError 接口

通过定义一个带有GoError实现的显式error接口，可以简化error检查

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
package goerr
 
type Error interface {
    error
 
    Code() string
    Message() string
    Cause() error
    Causes() []error
    Data() map[string]interface{}
    String() string
    ResponseErrType() ResponseErrType
    SetResponseType(r ResponseErrType) Error
    Component() ErrComponent
    SetComponent(c ErrComponent) Error
    Retryable() bool
    SetRetryable() Error
}

抽象error

有了上述的封装方式，更重要的是对error进行抽象，将这些封装保存在同一地方，并提供error函数的可重用性 。

?
1
2
3
4
5
6
7
8
9
10
11
func ResourceNotFound(id, kind string, cause error) GoError {
    data := map[string]interface{}{ "kind" : kind, "id" : id}
    return GoError{
       Code:         "ResourceNotFound" ,
       Data:         data,
       Causes:       []error{cause},
       Component:    ErrService,
       ResponseType: NotFound,
       Retryable:    false ,
    }
}

这个error函数抽象了ResourceNotFound这个error，开发者可以使用这个函数来返回error对象而不是每次创建一个新的对象:

?
1
2
3
4
5
6
7
8
//UserService
user, err := u.repo.FindUser(ctx, userId)
if err != nil {
    if err.ResponseType == NotFound {
       return ResourceNotFound(userUid, "User" , err)
    }
    return err
}

结论

我们演示了如何使用添加上下文数据的自定义Go的error类型，从而使得error在多层应用程序中更有意义。你可以在这里[1]看到完整的代码实现和定义.

到此这篇关于Go应用中优雅处理Error的文章就介绍到这了,更多相关Go优雅处理Error内容请搜索我以前的文章或继续浏览下面的相关文章希望大家以后多多支持我！ 。

参考资料 。

[1] 这里: https://gist.github.com/prathabk/744367cbfc70435c56956f650612d64b 。

原文链接：https://mp.weixin.qq.com/s/q2VrY8ksNsmYzvqhUNv72A 。

最后此篇关于Go应用中优雅处理Error的技巧总结的文章就讲到这里了,如果你想了解更多关于Go应用中优雅处理Error的技巧总结的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。

30 4 0
文章推荐： python django框架中使用FastDFS分布式文件系统的安装方法
文章推荐： Linux 修复 Spectre V1 SWAPGS 漏洞，代码来自阿里工程师
文章推荐： KDE 从 12 月开始进行大量问题修复和桌面易用性改进
文章推荐： python三大神器之fabric使用教程
qq735679552
个人简介

我是一名优秀的程序员,十分优秀！

滴滴打车优惠券免费领取
滴滴打车优惠券
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com