视频丨致敬传奇!“球王”贝利,一路走好
巴西知名运动员、球王贝利去世,终年82岁。三次世界杯冠军,1283次个人进球70秒回顾球王传奇人生。
2022-12-30预计将于 2023 年 2 月发布的 Go 1.20 有一个小的变化,对于那些大量使用错误包装的应用程序来说,可能会有效改进它们的错误处理方法。
让我们看一下它的用法,但首先,需要简要回顾一下什么是错误包装。如果你已经掌握了可以直接跳到下面的 “Go 1.20 新功能” 部分以获取新的信息。
Go 中的错误是实现一个非常简单的接口:
(资料图片仅供参考)
typeerrorinterface{Error()string}
错误类型可以是任何东西,从string本身到int,但通常它们是struct类型。下面这个例子来自标准库:
typeerrstruct{sstring}func(e*err)Error()string{returne.s}
要检查 Go 中的错误,你只需比较一个值(在本例中为int值):
iferr==io.EOF{//...}
第二种常见的用法是检查错误的类型,那也意味着要写更多的代码:
ifnerr,ok:=err.(net.Error){//...(usenerrwhichisanet.Error)}
在上面的例子中,类型断言测试类型net.Error的err值,并创建一个新变量nerr,它可以在 if 语句中使用。Go 中的错误方便理解、易于使用且非常高效。
错误包装从 Go 1.13 开始,引入了错误包装。包装允许将错误嵌入到其他错误中,就像在其他语言中包装异常一样。这非常实用,比如函数遇到 “record not found” 错误时,可以向错误信息中添加更多上下文信息,例如 “unknown user: record not found”。
Go 中错误包装设计背后的有趣想法是:契约不用关心错误类型、结构或它们是如何创建的。而唯一关注的是解包过程和转换为字符串,因为这两者是必须的。这就非常容易实现:支持解包的错误类型必须实现Unwrap() error方法。
标准库中没有(命名的)接口可以向您展示,因为接口是隐式实现的,没有必要单独写一个。这里我们写一个只是为了更好说明这篇文章:
typeWrappedErrorinterface{Unwrap()error}
我们来看看 Go 标准库(实际上是 package fmt)中是如何实现包装错误的:
typewrapErrorstruct{msgstringerrerror}func(e*wrapError)Error()string{returne.msg}func(e*wrapError)Unwrap()error{returne.err}
由于上面错误类型实现了Error() string方法,所以说 Go 中的错误实际上最终是字符串并没有错,因此需要一种创建这些字符串的良好机制。这就是标准库中的函数fmt.Errorf发挥作用的地方:
varRecordNotFoundErr=errors.New("notfound")constname,id="lzap",13werr:=fmt.Errorf("unknownuser%q(id%d):%w",name,id,recordNotFoundErr)fmt.Println(werr.Error())
一个特殊格式的动词%w,每次调用只能使用一次(稍后会详细介绍),用于错误参数。除此之外,该函数的工作方式类似于fmt.Printf函数。下面的例子打印了这个结果:
unknownuser"lzap"(id13):notfound
如你所见,错误包装本质上是一个链表。要解包错误,请使用errors.Unwrap函数,该函数将为链表中的最后一个错误值返回nil。要检查错误类型或值,需要遍历整个列表,这对于需要进行频繁的错误检查不太实用。幸运的是,有两个辅助函数可以做到这一点。
检查包装错误列表中的值:
iferrors.Is(err,RecordNotFoundErr){//...}
检查特定类型(下面例子是来自标准库的网络错误):
varnerr*net.Erroriferrors.As(err,&nerr){//...(usenerrwhichisa*net.Error)}
以上总结了 Go 1.13 及更高版本中的错误包装。
Go 1.20 新特性让我们看看 Go 1.20 中真正的新功能,从函数errors.Join开始,它通过可变参数包装错误列表:
err1:=errors.New("err1")err2:=errors.New("err2")err:=errors.Join(err1,err2)fmt.Println(err)
当事先不知道错误数量时,此功能可用于将错误连接在一起。一个很好的例子是从 goroutines 收集错误。值得一提的是,该函数将列表中的错误与换行符连接起来。上面的代码片段打印:
err1err2
对于许多应用程序或(日志记录)库来说,这可能会存在问题,它们期望错误通常只是没有换行符的字符串。幸运的是,Go 1.20 中的另一个变化改变了fmt.Errorf的行为:该函数现在接受多个%w格式说明符:
err1:=errors.New("err1")err2:=errors.New("err2")err:=fmt.Errorf("%w+%w",err1,err2)fmt.Println(err)
以前会导致格式错误的格式字符串现在可以正确打印:
err1+err2
同时包装多个错误实现Unwrap() error,这是可能的吗?
事实证明,在 Go 1.20 标准库中有一种新的机制: 实现Unwrap() []error函数的错误类型可以包装多个错误。让我们来看看这是如何在库中实现的:
typejoinErrorstruct{errs[]error}func(e*joinError)Error()string{//concatenateerrorswithanewlinecharacter}func(e*joinError)Unwrap()[]error{returne.errs}
一个理论上的接口,但标准库中实际不存在,如下所示:
typeMultiWrappedErrorinterface{Unwrap()[]error}
由于 Go 不允许方法重载,因此每种类型都可以实现Unwrap() error或Unwrap() []error,但不能同时实现。还记得我提到过包装错误本质上是一个链表吗?实现前一个(新引入的)方法的类型实际上形成了一个链接树,函数errors.Is和errors.As的工作方式相同,只是现在它们需要遍历树而不是列表。根据文档,该实现执行预排序、深度优先遍历。
这确实是 Go 1.20 带来的全部,它可能看起来是一个小的变化,但它提供了如何有效和干净地处理错误的新方法。在展示真实示例之前,让我总结一下新功能:
新的Unwrap []error函数契约允许遍历错误树。
新的errors.Join函数,这是一个方便的函数,用于连接两个错误字符串值(使用换行符)。
现有函数errors.Is和errors.As已更新,可以同时处理错误列表和错误树。
现有函数fmt.Errorf现在接受多个%w格式动词。实践上面这一切都很棒,但是你如何在实践中利用它呢?
在一个小型 REST API 微服务中,我们通过errors.New和fmt.Errorf处理来自 DAO 包(数据库)、REST 客户端(其他后端服务)和其他包的各种错误。返回的 HTTP 状态代码应该是 2xx、4xx 或 5xx,具体取决于错误状态以遵循最佳 REST API 实践。实现此过程的一种方法是解开主 HTTP 处理程序中的错误并找出它是哪种错误。
然而,通过多重错误包装,现在可以包装根本原因(例如数据库返回 “no records found” )和返回给用户 HTTP 代码(在本例中为 404)。
一个工作示例如下所示:
packagemainimport("errors""fmt")//commonHTTPstatuscodesvarNotFoundHTTPCode=errors.New("404")varUnauthorizedHTTPCode=errors.New("401")//databaseerrorsvarRecordNotFoundErr=errors.New("DB:recordnotfound")varAffectedRecordsMismatchErr=errors.New("DB:affectedrecordsmismatch")//HTTPclienterrorsvarResourceNotFoundErr=errors.New("HTTPclient:resourcenotfound")varResourceUnauthorizedErr=errors.New("HTTPclient:unauthorized")//applicationerrors(thenewfeature)varUserNotFoundErr=fmt.Errorf("usernotfound:%w(%w)",RecordNotFoundErr,NotFoundHTTPCode)varOtherResourceUnauthorizedErr=fmt.Errorf("unauthorizedcall:%w(%w)",ResourceUnauthorizedErr,UnauthorizedHTTPCode)funchandleError(errerror){iferrors.Is(err,NotFoundHTTPCode){fmt.Println("Willreturn404")}elseiferrors.Is(err,UnauthorizedHTTPCode){fmt.Println("Willreturn401")}else{fmt.Println("Willreturn500")}fmt.Println(err.Error())}funcmain(){handleError(UserNotFoundErr)handleError(OtherResourceUnauthorizedErr)}
这将打印:
Willreturn404usernotfound:DB:recordnotfound(404)Willreturn401unauthorizedtocallotherservice:HTTPclient:unauthorized(401)
从这样的人工代码片段中可能看起来不太明显的是,实际上的错误声明通常分布在许多包中,并且不容易跟踪所有可能的错误以确保所需的 HTTP 状态代码。在这种方法中,所有在一个地方声明的应用程序级包装错误也包含了 HTTP 代码。
请注意,这在 Go 1.19 或更早版本中是不可能的,因为fmt.Errorf函数只会包装第一个错误。该代码确实在 1.19 上可以编译,甚至不会产生运行时恐慌,但它实际上不会工作。
显然,常见的 HTTP 状态代码很容易成为一种新的错误类型(基于int类型),因此可以通过errors.As轻松提取实际代码,但我想让示例保持简单。
Feel free to play around with the code on Go Playground. Make sure to use “dev branch” or 1.20+ version of Go. 可以在 Go Playground 上自由运行上述代码。确保使用 “dev branch” 或 Go 的 1.20+ 版本。现有应用在你的应用程序中实施新功能时,请注意errors.Unwrap函数。对于具有Unwrap() []error的错误类型,它总是返回nil:
err1:=errors.New("err1")err2:=errors.New("err2")err:=errors.Join(err1,err2)unwrapped:=errors.Unwrap(err)fmt.Println(unwrapped)
由于 Go 1.X 兼容性承诺,这会打印出 “nil”。当你引入多个包装错误时,请确保检查展开代码。幸运的是,典型 Go 代码中的大部分错误检查都是使用errors.Is和errors.As完成的。
错误包装并不是 Go 中所有错误处理的最终解决方案。它只是提供了一种干净的方法来处理典型 Go 应用程序中的错误,对于简单应用程序来说也许就完全足够了。原文地址:https://lukas.zapletalovi.com/posts/2022/wrapping-multiple-errors/原文作者:Lukáš Zapletal本文永久链接:https://github.com/gocn/translator/blob/master/2022/w50_Wrapping_multiple_errors译者:haoheipi校对:watermelo
往期推荐
谷歌发布查找开源漏洞的Go工具OSV-Scanner最好的Go框架:没有框架?
「每周译Go」如何在Go中构造For 循环想要了解Go更多内容,欢迎扫描下方关注公众号,回复关键词 [实战群],就有机会进群和我们进行交流
分享、在看与点赞Go
标签:
巴西知名运动员、球王贝利去世,终年82岁。三次世界杯冠军,1283次个人进球70秒回顾球王传奇人生。
2022-12-30网贷逾期一般会上征信,有些借贷机构在用户逾期后一天后就会上报给征信机构,而有些借贷机构则是会在几天...
2022-12-302022郑好办APP消费券领取攻略(时间+使用)郑州目前正在发放的消费券活动中,其中多个消费券可在郑好办A...
2022-12-29人民网北京12月29日电(记者郭冠华)12月28日,由人民网、中国电影家协会联合主办的第三届“光影中国”...
2022-12-29皇城相府元旦开放吗?开放。皇城相府景区门票价格:根据山西省物价局晋价市函【2013】31号《山西省物价...
2022-12-29金融时报(FT)报道,NinepointPartnersLP的合伙人兼高级投资组合经理埃里克·纳托尔表示,油价将在2023年回到每
2022-12-29观点网讯:12月28日,众安集团有限公司公布,获众安智慧生活服务有限公司告知,众安智慧已就建议分拆向...
2022-12-291、精益求精,独具匠心。2、尽心尽力尽职尽责,缔造总装不朽传奇。3、卓越工匠,精密总装。4、执工匠精...
2022-12-28绵阳梓潼县接种点位:哪些人应该进行第二剂次加强接种?为了更好地保障人民群众身体健康和生命安全,感染...
2022-12-28(原标题:12月28日午后快讯)截至午后两点,上证指数报3084 30点,下跌0 36%,深证成指报11005 32点...
2022-12-28网贷逾期一般会上征信,有些借贷机构在用户逾期后一天后就会上报给征信机构,而有些借贷机构则是会在几天...
2022-12-28预计将于2023年2月发布的Go1 20有一个小的变化,对于那些大量使用错误包装的应用程序来说,可能会有效...
2022-12-282022年12月28日公告发布
2022-12-27理论上是夏天低档,冬天高档。实际上麻烦,还费电,而且还坏冰箱。解释:夏天调二挡的话,压缩机会不停的...
2022-12-27张小泉(301055)12月27日在投资者关系平台上答复了投资者关心的问题。
2022-12-27智通财经APP讯,中科创达公告,公司拟发行全球存托凭证(“GDR”)并申请在瑞士证券交易所挂牌上市。公司...
2022-12-26(原标题:新北洋:拟以5000万元-8000万元回购股份)证券时报e公司讯,新北洋(002376)12月26日晚间公告...
2022-12-26近年来,扶外小学在不断加强学校管理、提高教学质量的同时,重视书法特色教育,通过传统书法教育提升学...
2022-12-26参考消息网12月25日报道据俄罗斯卫星社网站12月23日报道,本周中国“汉语盘点2022”(由国家语言资源监...
2022-12-25网贷逾期一般会上征信,有些借贷机构在用户逾期后一天后就会上报给征信机构,而有些借贷机构则是会在几天...
2022-12-25截至2022年12月23日收盘,八方股份报收于99 5元,下跌2 75%,换手率0 46%,成交量5576 66手,成交额...
2022-12-24潘石屹清空300亿移居海外,满面堆笑现身宴会,人民日报没说错
2022-12-2312月23日盘中消息,13点59分中锐股份(002374)触及涨停板。目前价格5 92,上涨10 04%。其所属行业包...
2022-12-23【各地动态】中工网讯(工人日报-中工网记者吴铎思)日前,新疆维吾尔自治区和硕县人民法院做出终审判决...
2022-12-23Go-Goal数据挖掘机|12月22日机构关注度最高的潜力股都在这里
2022-12-2212月22日消息,天眼查App显示,近日,小米汽车科技有限公司“动力电池”专利获授权。摘要显示,该动力电...
2022-12-2212月21日,华安研究智选混合A最新单位净值为0 7054元,累计净值为0 7054元,较前一交易日上涨0 17%。...
2022-12-22同花顺F10数据显示,2022年12月21日天力锂能(301152)新增“储能”概念。 该公司常规概念还有:动力...
2022-12-21格隆汇12月21日丨渤海银行盘中一度直线拉升涨超10%,最高报1 51港元创10个月新高价,总市值重回250亿港...
2022-12-21抢劫罪(刑法第263条),是以非法占有为目的,对财物的所有人、保管人当场使用暴力、胁迫或其他方法,强...
2022-12-21澎湃新闻记者陈灿杰实习生孙雅楠李子旋张馨尹赵嘉欣郭思航如今再见着老顾客,梅姐会打招呼,“阳了吗?...
2022-12-20CQF报名属于是申请审核制的,报名条件对报考人员学历和行业没有额外的限制,具体的要求有以下几点:1、C...
2022-12-20北京市大地律师事务所 关于四川安控科技股份有限公司 调整资本公积金转增股本除权...
2022-12-19网贷逾期一般会上征信,有些借贷机构在用户逾期后一天后就会上报给征信机构,而有些借贷机构则是会在几天...
2022-12-19张娜(化名)和李明(化名)在一起六年,生下一男一女,由于张娜老家面临拆迁,她就和李明商量先别迁户...
2022-12-19读创 深圳商报首席记者包力通讯员张颖12月8日,深圳市正高级教师、罗湖区教育科学研究院中学教研室主任...
2022-12-19前瞻:詹眉威比拼卡椒快船力争送湖人开季2连败,湖人,快船队,沃尔,威少,勒布朗詹姆斯,安东尼·戴维斯
2022-12-18中国石油网消息(记者王志强)我们建立了全方位一体化的环境安全预警管理系统,对污水系统关键数据实时...
2022-12-17山东黄金:中信证券股份有限公司关于山东黄金矿业股份有限公司使用闲置募集资金暂时补充流动资金的核查意见
2022-12-16扬子晚报 紫牛新闻讯12月15日18时左右,浙江多地有市民反映观测到“火流星”。据了解,这颗燃烧并发出...
2022-12-16江阴银行(002807)12月16日在投资者关系平台上答复了投资者关心的问题。
2022-12-16证券代码:601878 证券简称:浙商证券 公告编号:2022-084转债代码:1...
2022-12-15截至2022年12月15日收盘,拱东医疗(605369)报收于104 71元,下跌2 87%,换手率1 1%,成交量0 31万手...
2022-12-15大连友谊(000679)12月15日在投资者关系平台上答复了投资者关心的问题。投资者:公司有多少免税店股份?...
2022-12-15无锡线上线下通讯信息技术股份有限公司 独立董事关于第二届董事会第十次会议相关事项的 ...
2022-12-144月26日,济源产城融合示范区管委会副主任、副市长卫祥玉到梨林镇中心小学调研指导复学工作。在梨林镇中...
2022-12-14个股亮点:公司从事“周大生”品牌珠宝首饰的设计、推广和连锁经营,是国内最具规模的珠宝品牌运营商之...
2022-12-14武汉华康世纪医疗股份有限公司独立董事 关于第二届董事会第二次会议相关事项的独立意见 ...
2022-12-13同花顺(300033)金融研究中心12月13日讯,有投资者向张家界(000430)提问,董秘你好,请问贵司与《阿...
2022-12-13证券代码:002511 证券简称:中顺洁柔 公告编号:202...
2022-12-12坚持普惠多元、方便可及,上海出台条例——推进学前教育和托育服务发展本报记者巨云鹏“学前教育与托育...
2022-12-12大地海洋(301068)12月11日在投资者关系平台上答复了投资者关心的问题。投资者:您好,公司截止12月10日...
2022-12-11亿利达(002686)12月09日在投资者关系平台上答复了投资者关心的问题。投资者:据了解,公司持有众泰汽车A...
2022-12-09截至2022年12月7日收盘,路维光电(688401)报收于47 79元,下跌1 99%,换手率5 57%,成交量1 58万手...
2022-12-08截至2022年12月6日收盘,*ST宜康(000150)报收于1 51元,下跌2 58%,换手率3 81%,成交量30 72万手,成交额4639 35万元。12
2022-12-06昨日,宁波市工商联与江厦智库经济研究院联合发布了《2022年宁波上规模民营企业调研报告》。参与调研的2...
2022-09-08近日,经全国水产原种和良种审定委员会审定,海益苗业海益丰11海湾扇贝、天源水产多宝2号大菱鲆入选新一...
2022-07-07这款交友App,把我们家闹得鸡飞狗跳。武汉市民刘女士说,家里老人看了网络广告下载了一款中老年社交App...
2022-03-18政府工作报告提出,增强区域发展平衡性协调性。推进京津冀协同发展、长江经济带发展、粤港澳大湾区建设...
2022-03-18山东适宜线下无理由退货的实体店大约35万家,今年将实现这些实体店无理由退货全覆盖。日前,记者从山东...
2022-03-182月18日,离岸人民币兑美元汇率大幅上调,盘中一度突破6 3200关口,触及近4年新高6 3144,创下2018年5...
2022-03-18近日,厦门海关对外发布消息称,RCEP实施首月,厦门海关签发RCEP原产地证书1013份,货值4 98亿元人民币...
2022-03-18在今天国新办举行的新闻发布会上,商务部部长王文涛表示,今年外贸形势严峻复杂,稳外贸压力增大,商务...
2022-03-18我们通过落实各项稳外资措施,积极促成亚洲硅业(青海)股份有限公司在甘河工业园区再投资建设年产60000吨...
2022-03-18近日,宝鸡2021年外贸数据公布:外贸进出口总值88 1亿元,同比增长10 9%,创历史新高。能取得这样的成...
2022-03-18中新网11月26日电 据厦门大学微信公众号消息,11月25日18:00,上海市召开新冠肺炎疫情防控新闻发布...
2021-11-26(抗击新冠肺炎) 江西本轮疫情新冠肺炎住院确诊病例“清零” 中新网南昌11月26日电 (记者 吴鹏...
2021-11-26中新网11月26日电 据“徐州发布”微博消息,江苏省徐州市疫情防控应急指挥部发布疫情防控工作进展...
2021-11-26(抗击新冠肺炎)上海逾5万名筛查对象核酸检测阴性 中新社上海11月26日电 (记者 陈静)上海25日新...
2021-11-26中新网湖州11月26日电(记者 施紫楠)今年是波兰姑娘杰西卡在中国乡村生活的第9年。对于她来说,中国...
2021-11-26中新网杭州11月26日电 题:浙大不眠夜:罕见亮起“灿烂星辰”灯 守护师生前行 作者 谢盼盼 ...
2021-11-26【聚焦2021中国网络媒体论坛展示会】 “宝鸡元素”备受追捧 11月24日—26日,2021中国网络媒体...
2021-11-26中新网杭州11月26日电(张煜欢)25日,杭州市新增两例无症状感染者。26日,杭州市新冠肺炎疫情防控指...
2021-11-26中新网11月26日电 据“杭州发布”微信公众号消息,在通报杭州2例无症状感染者后,杭州市加快推进流...
2021-11-26中新网兰州11月26日电 (陈强)“终于有稳定的水源供应了。”看着水管里流出的清澈山泉水,甘肃省平...
2021-11-26这两天,来自单亲家庭的山东青岛女孩刘郦微休学一年陪伴患病妈妈的视频感动无数网友。然而不幸的是...
2021-11-26中新网大连11月26日电 (记者 杨毅)大连市新冠肺炎疫情防控总指挥部26日发布通告,11月25日0时至24...
2021-11-26中新网11月26日电 据北京市卫健委微信公众号消息,截至2021年11月25日,北京市海淀区西三旗街道富...
2021-11-26记者从山西省临汾市吉县相关部门了解到,11月25日,临汾市吉县一在建乡村道路发生塌方,造成3人遇难...
2021-11-26中新网11月26日电 据河南省封丘县政府网站消息,11月25日,有媒体报道封丘县《学生餐后集体呕吐腹...
2021-11-26中新网杭州11月26日电(王逸飞 钱晨菲)11月25日,杭州市通报两名来杭返杭人员诊断为新冠病毒无症...
2021-11-26中新网南京11月26日电 (记者 钟升)苏州市政府新闻办公室25日深夜公布,截至当日22时,苏州市已累...
2021-11-26近日,“毒贩母亲”一事引发网友关注。河南郑州一名35岁的母亲李芳(化名)长期代购一款名为氯巴占的...
2021-11-26中新网11月26日电 据内蒙古自治区卫健委网站消息,11月25日0—24时,内蒙古自治区报告无新增确诊病...
2021-11-26中新网11月26日电 据江苏省卫健委官方微博消息,11月25日0-24时,江苏无新增确诊病例,新增本土无...
2021-11-26中新网11月26日电 据北京疾控中心微信公众号消息,11月25日18:00,上海市召开第107场新冠肺炎疫情...
2021-11-26上海瑞金医院、中山医院、同济医院、闵行区中心医院25日均发布消息称,根据国家和上海疫情防控要求...
2021-11-26走近年轻的视障工程师—— 为视障者点亮智慧生活(体验·新时代·追梦人·“急难愁盼这样解决”)...
2021-11-26中新网11月26日电 据“上海发布”微博消息,11月26日,上海市疫情防控工作领导小组办公室发布消息...
2021-11-26每逢求职季,不少应届毕业生心头难免萦绕迷茫与焦虑——学历够高吗?学校够牛吗? 在江苏省常熟...
2021-11-26中新网11月26日电 据辽宁省卫健委网站消息,11月25日0时至24时,辽宁省新增1例本土新冠肺炎确诊病...
2021-11-26规范性文件升格为部门规章拖欠农民工工资联合惩戒力度加大 列入失信惩戒名单期限内再次欠薪不予...
2021-11-26中新网11月26日电 据上海市卫健委官方微博消息,2021年11月25日0—24时,通过口岸联防联控机制,上...
2021-11-26中新网11月26日电 据“徐州发布”微信公众号消息,江苏省徐州市疫情防控应急指挥部25日发布《交通...
2021-11-26中新网11月26日电 据中央气象台网站消息,27日至28日,新疆、西北地区东部、川西高原、西藏东部等...
2021-11-262021年11月25日0—24时,通过口岸联防联控机制,报告1例新增境外输入性新冠肺炎确诊病例。新增治愈...
2021-11-26中国天气网讯 北京今天(11月26日)晴暖延续,最高气温12℃。周末气温略有下降,最高气温8℃至9℃,...
2021-11-262021-11-26
2021-11-26
中新网11月26日电 据“徐州发布”微信公众号消息,25日,徐州市疫情防控应急指挥部交通管控组发布...
2021-11-26Copyright © 2015-2022 欧洲水产网版权所有 备案号:沪ICP备2022005074号-23 联系邮箱: 58 55 97 3@qq.com