百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程字典 > 正文

「GCTT 出品」Go 语言中的错误处理 - 第二部分

toyiye 2024-06-21 12:00 7 浏览 0 评论

简介

第一部分 中,我们学习了 error 接口以及标准库是如何通过 errors 包来创建 error 接口值的。我们也学习了如何使用 error 接口值,通过这些值来判断是否发生了错误。最后,我们学习了一些标准库是如何通过导出 error 接口变量来帮助我们确定发生错误的具体类型。

在 Go 语言中什么时候应该使用自定义错误类型是比较难把握的。大部分情况下,error 包提供的 error 接口值对于报告和处理错误已经足够了。但有时候,调用者可能希望知道错误发生时一些额外的上下文信息。在我看来,这种情况下就应该使用自定义错误类型。

在这篇文章里,我们将要学习自定义错误类型和标准库中两处使用自定义错误类型的实例。每个实例都提供了一个使用自定义错误类型的有趣的视角。之后我们会学习如何通过返回的 error 接口值确定具体的自定义错误类型以及获取存储在其中的指针信息,通过这些额外的信息怎样能帮助我们做出更加合适的错误处理决定。

net 包

net 包中声明了一个叫做 OpError 的自定义错误类型。指向这个结构的指针一般存储在 error 接口值中返回给调用者。net 包内的许多函数和方法都用到了这个错误类型。

清单 1.1

http://golang.org/src/pkg/net/dial.go

清单 1.1 列出的是 net 包中 Listen 函数的实现代码。我们可以看到,在第 4 行和第 13 行, 创建了 OpError 这个错误类型,并在返回语句中以 error 接口的方式返回给了调用者。由于 OpError 指针实现了 error 接口,所以它可以以 error 接口值返回。需要注意的是,在第 9 行和 11 行,对 ListenTCP 和 ListenUnix 函数的调用 ,同样也可以通过 error 接口返回 OpError 的指针。

接下来,我们看一下 OpError 的声明

清单 1.2

http://golang.org/pkg/net/#OpError

清单 1.2 显示的是 OpError 结构的声明。前三个字段提供了错误发生时相关网络操作的上下文信息。第 17 行声明了一个 error 接口类型。这个字段包含了实际发生的错误,通常情况下,这个值的具体类型是一个 errorString 的指针。

另一个需要注意的是自定义错误类型的命名规范,在 Go 语言中自定义错误类型通常以 Error 结尾。以后我们会在其它包中再次看到这样的命名

接下来,我们看一下 OpError 对 error 接口的实现。

清单 1.3

http://golang.org/src/pkg/net/net.go

清单 1.3 中列出的是 error 接口的实现代码,展示了如何用与错误发生时相关的信息构建建一个更加具体的错误信息。把上下文信息与错误绑定在一起可以提供额外的信息来帮助调用者做出更加合理的错误处理选择。

JSON 包

json 包提供了 JSON 格式与 Go 原生格式的相互转化的功能。所有可能产生的错误都是在内部生成的。维护与错误相关的上下文信息对于这个包是比较难的。json 包中有许多自定义错误类型,这些不同的错误类型可以被同一个函数或者方法返回。

让我们看一下其中的一个自定义错误类型

清单 1.4

http://golang.org/src/pkg/encoding/json/decode.go

清单 1.4 列出了 UnmarshalTypeError 结构的声明和对 error 接口的实现。这个自定义类型是用来说明发生了一个从 JSON 值到具体 Go 原生类型的转化错误。这个结构包含 2 个字段,一个是第 4 行声明的 Value,它包含了用于转换的 JSON 数据,另一个是第 5 行声明的 Type,它包含了将要转化为的 Go 类型。第 8 行对 error 接口的实现中,用相关的上下文信息构建了一个合理的错误信息。

在这个例子里,根据错误类型的名称就可以看出发生了什么错误,这个类型叫做 UnmarshalTypeError,这正是这个自定义错误类型发生时的上下文环境。当发生的错误与转化失败有关时,这个结构的指针就存储在 error 接口中返回。

当调用 unmarshal 时传入了一个非法的参数时,一个指向 InvalidUnmarshalError 的指针会存储在 error 接口中返回。

清单 1.5

http://golang.org/src/pkg/encoding/json/decode.go

清单 1.5 列出了 InvalidUnmarshalError 的声明和对 error 接口的实现。同样的,类型名称就明确了错误发生时的上下文信息。内部维护的状态可以用来构建合适的错误信息,从而帮助调用者做出更加合理的错误处理选择。

具体类型识别

在 net 包 Unmarshal 函数的例子中,随 error 接口返回的错误可能是 UnmarshalTypeError, InvalidUnmarshalError 或者 errorString 中的一个。

清单 1.6

http://golang.org/src/pkg/encoding/json/decode.go

清单 1.6 显示了对 Unmarshal 的调用返回的 error 接口中,是如何包含不同的具体错误类型指针的。在第 27 行中,unmarshal 方法返回了 InvalidUnmarshalError 的指针, 第 34 行,decodeState 变量中的 savedError 被返回,这个字段可能指向好几个不同的具体错误类型。

我们已经知道 JSON 包是用自定义错误类型做为错误发生时的上下文信息的,那我们如何识别包含在 error 接口中的具体错误类型,从而做出更加合理的错误处理选择呢?

让我们从一个使 Unmarshal 函数的调用返回一个包含 UnmarshalTypeError: 自定义类型错误的程序开始。

清单 1.7

http://play.golang.org/p/FVFo8mJLBV

清单 1.7 是一个尝试调用 unmarshal 把一段 JSON 文档转化为 Go 类型的例子,第 15 行的 JSON 文档包含一个 name 字段,其中包含一个 bill 的字符串值。由于 user 类型中的 Name 字段在第 9 行被声明为了 integer, 所以对 Unmarshal 的调用返回一个具体的错误类型 UnmarshalTypeError。

现在我们稍微修改一下 表 1.7 中的代码,使 UNmarshal 的调用通过 error 接口返回不同的错误。

清单 1.8

http://play.golang.org/p/n8dQFeHYVp

清单 1.8 中的代码在 表 1.7 的基础上做了一些改动。在第 15 行,我们把传给 Unmarshal 函数的参数换成了 u ,而不是之前它的地址。这个变化会使对 UNmarshal 函数的调用返回一个包含 InvalidUnmarshalError 具体错误的 error 接口值。

然后是在程序的第 17 行到第 24 行,添加了些有趣的代码:

清单 1.9

第 17 行添加了一个 switch 语句来识别存储在 error 接口中的具体错误类型。注意关键字 type 用在接口变量时的语法。同时我们也可以取得存储在具体错类型的的值,并在每个分支语句中使用这些值。

第 18 行和第 20 行的分支语句检测具体的错误类型,然后执行相应的错误处理逻辑。这是识别存储在 error 接口的具体错误类型的典型方式。

结论

返回的 error 接口值应该包含对调用者有影响的,错误发生时作用域内一些具体信息。它必须包含足够的信息以便让调用者做出合理的选择,通常来说一个简单的字符串信息就够了,不过有时需要的会更多。

我们在 net 包中看到了一个使用实例:它声明了一个自定义错误类型,用来封装原始的 errro 类型和一些相关的上下文信息。在 JSON 包中,我们看到了如何用自定义错误类型在提供上下文信息和相关的状态。在这两个例子中,维护错误发生时的相关上下文信息是一个决定性因素

如果 errors 包中中 error 类型可以提供足够的上下文信息,就用它。整个标准库中到处用到了它, 通常这个就是你需要的。如果需要给调用者提供额外的信息来帮助他们做出更别合理的错误物理选择,从标准库代码中找一些线索,然后创建你自己的自定义错误类型。


via: https://www.ardanlabs.com/blog/2014/11/error-handling-in-go-part-ii.html

作者:William Kennedy 译者:jettyhan 校对:polaris1119

本文由 GCTT 原创编译,Go语言中文网 荣誉推出

  • 本文由 GCTT 原创翻译,Go语言中文网 首发。
  • 翻译工作和译文发表仅用于学习和交流目的,翻译工作遵照 CC-BY-NC-SA 协议规定,如果我们的工作有侵犯到您的权益,请及时联系我们。
  • 欢迎遵照 CC-BY-NC-SA 协议规定 转载,敬请在正文中标注并保留原文/译文链接和作者/译者等信息。
  • 文章仅代表作者的知识和看法,如有不同观点,请评论排队吐槽

相关推荐

为何越来越多的编程语言使用JSON(为什么编程)

JSON是JavascriptObjectNotation的缩写,意思是Javascript对象表示法,是一种易于人类阅读和对编程友好的文本数据传递方法,是JavaScript语言规范定义的一个子...

何时在数据库中使用 JSON(数据库用json格式存储)

在本文中,您将了解何时应考虑将JSON数据类型添加到表中以及何时应避免使用它们。每天?分享?最新?软件?开发?,Devops,敏捷?,测试?以及?项目?管理?最新?,最热门?的?文章?,每天?花?...

MySQL 从零开始:05 数据类型(mysql数据类型有哪些,并举例)

前面的讲解中已经接触到了表的创建,表的创建是对字段的声明,比如:上述语句声明了字段的名称、类型、所占空间、默认值和是否可以为空等信息。其中的int、varchar、char和decimal都...

JSON对象花样进阶(json格式对象)

一、引言在现代Web开发中,JSON(JavaScriptObjectNotation)已经成为数据交换的标准格式。无论是从前端向后端发送数据,还是从后端接收数据,JSON都是不可或缺的一部分。...

深入理解 JSON 和 Form-data(json和formdata提交区别)

在讨论现代网络开发与API设计的语境下,理解客户端和服务器间如何有效且可靠地交换数据变得尤为关键。这里,特别值得关注的是两种主流数据格式:...

JSON 语法(json 语法 priority)

JSON语法是JavaScript语法的子集。JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔花括号保存对象方括号保存数组JS...

JSON语法详解(json的语法规则)

JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔大括号保存对象中括号保存数组注意:json的key是字符串,且必须是双引号,不能是单引号...

MySQL JSON数据类型操作(mysql的json)

概述mysql自5.7.8版本开始,就支持了json结构的数据存储和查询,这表明了mysql也在不断的学习和增加nosql数据库的有点。但mysql毕竟是关系型数据库,在处理json这种非结构化的数据...

JSON的数据模式(json数据格式示例)

像XML模式一样,JSON数据格式也有Schema,这是一个基于JSON格式的规范。JSON模式也以JSON格式编写。它用于验证JSON数据。JSON模式示例以下代码显示了基本的JSON模式。{"...

前端学习——JSON格式详解(后端json格式)

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScriptProgrammingLa...

什么是 JSON:详解 JSON 及其优势(什么叫json)

现在程序员还有谁不知道JSON吗?无论对于前端还是后端,JSON都是一种常见的数据格式。那么JSON到底是什么呢?JSON的定义...

PostgreSQL JSON 类型:处理结构化数据

PostgreSQL提供JSON类型,以存储结构化数据。JSON是一种开放的数据格式,可用于存储各种类型的值。什么是JSON类型?JSON类型表示JSON(JavaScriptO...

JavaScript:JSON、三种包装类(javascript 包)

JOSN:我们希望可以将一个对象在不同的语言中进行传递,以达到通信的目的,最佳方式就是将一个对象转换为字符串的形式JSON(JavaScriptObjectNotation)-JS的对象表示法...

Python数据分析 只要1分钟 教你玩转JSON 全程干货

Json简介:Json,全名JavaScriptObjectNotation,JSON(JavaScriptObjectNotation(记号、标记))是一种轻量级的数据交换格式。它基于J...

比较一下JSON与XML两种数据格式?(json和xml哪个好)

JSON(JavaScriptObjectNotation)和XML(eXtensibleMarkupLanguage)是在日常开发中比较常用的两种数据格式,它们主要的作用就是用来进行数据的传...

取消回复欢迎 发表评论:

请填写验证码