不该缺少的Error体系

导语: 几乎所有APP在开发过程中都会遇到错误,一些错误是在控制之外,例如磁盘空间不足或网络连接失败。而一些错误是可以预料得到的,例如视频正在处理中无法播放、传入的参数非法等。而这些错误的信息如果友好的告诉业务方或者用户呢?

前言

几乎所有APP在开发过程中都会遇到错误,一些错误是在控制之外,例如磁盘空间不足或网络连接失败。而一些错误是可以预料得到的,例如视频正在处理中无法播放、传入的参数非法等。而这些错误的信息如果友好的告诉业务方或者用户呢?

在iOS开发中最常见的方式之一是使用NSError,比如使用很广的AFNetworking,它就会常常返回一些错误信息告诉用户。而在手Q或者兴趣部落的项目中都没有一套整齐的Error体系,所以我们得需要进一步了解NSerror是什么东西才能制定出我们想要的东西。

NSError包括什么

在整个Error体系中主要包括三块内容,如下:

  • Error Domain
  • Error Code
  • The User Info Dictionary

Domain

Error Domain是指区域,它是由一个字符串组成的。比如OS X系统Carbon框架的domain(NSOSStatusErrorDomain)POSIX框架为(NSPOSIXErrorDomain),除此之外不同的framework也定义了自己的domain,比如对于Web Kit framework,定义了WebKitErrorDomain

而我们也应该在自己的项目中定义属于自己Error区域,官方推荐的命名规则如下: com.company.XXX.ErrorDomain

Code

code就是我们俗称的错误码了,比如访问文件资源时返回的NSFileNoSuchFileError(4)等的错误码。 oc开发时使用到的系统库对应的各个error code可以到相应的地方查,他们所在的位置都有一个相应规范:

  • Foundation/FoundationErrors.h - Generic Foundation error codes
  • CoreData/CoreDataErrors.h - Core Data error codes
  • Foundation/NSURLError.h - URL error codes

那么在自己的项目中也应该按照这样的规范来定义:XXXErrors.h

User Info Dictionary

User info可以包含很多自定义信息,系统给定义好了一些键名:

键名作用 | 键名定义 | 获取值方法 —|—|— 通用键 | NSUnderlyingErrorKey | 详细描述键 | NSLocalizedDescriptionKey | - (NSString *)localizedDescription; 失败原因键 | NSLocalizedFailureReasonErrorKey | - (NSString *)localizedFailureReason; 恢复建议键 | NSLocalizedRecoverySuggestionErrorKey | - (NSString *)localizedRecoverySuggestion; 恢复选项键 | NSLocalizedRecoveryOptionsErrorKey | - (NSArray *)localizedRecoveryOptions; 其他键 | NSRecoveryAttempterErrorKey | 其他键 | NSHelpAnchorErrorKey | 其他键 | NSStringEncodingErrorKey | 其他键 | NSURLErrorKey | 其他键 | NSFilePathErrorKey |

基础用法:

NSDictionary *userInfo = [NSDictionary dictionaryWithObjectsAndKeys:@"这是错误详细的描述信息", NSLocalizedDescriptionKey, error, NSUnderlyingErrorKey, nil]];

NSError主要的初始化方法:

- (id)initWithDomain:(NSString *)domain code:(NSInteger)code userInfo:(NSDictionary *)dict;
+ (id)errorWithDomain:(NSString *)domain code:(NSInteger)code userInfo:(NSDictionary *)dict;

总结

在了解到NSError的强大之后,我们的项目也应该有一套Error体系,为了能在开发期就能定位问题,那么在项目中就需要做到以下几点:

  1. 建立属于项目的错误码表 XXXErrors.h
  2. 定义属于项目的错误区域 com.company.XXX.ErrorDomain
  3. 在一些数据接口或者更底层的一些接口都应该提供NSError的结果返回参数,以便业务层能更快定位问题

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏智能大石头

开发板通用刷机教程

    这是STM通用的刷固件方法,不仅仅适用于.Net Micro Framework,支持我们当前所有板子,包括阿波罗、探索者和雅典娜三个系列。     ...

2486
来自专栏安智客

Android8.0中对指纹的新要求

Android O版本对指纹有啥特别要求? 我们前面也介绍过《Android O新特性之Treble介绍》,在Android O以及以后的版本当中,Androi...

2516
来自专栏程序员宝库

设计和实现一款轻量级的爬虫框架

作者:王爵nice 链接:https://blog.biezhi.me/2018/01/design-and-implement-a-crawler-fram...

3138
来自专栏Seebug漏洞平台

TCTF/0CTF2018 XSS Writeup

刚刚4月过去的TCTF/0CTF2018一如既往的给了我们惊喜,其中最大的惊喜莫过于多道xss中Bypass CSP的题目,其中有很多应用于现代网站的防御思路。

6678
来自专栏魏琼东

DotNET企业架构应用实践 - 用服务定位器(SL)完成服务的多种实现的统一调用

        前面的文章服务定位器(SL)与AgileEAS.NET中的实现介绍了服务定位器的一些概念、应用场景与AgileEAS.NET平台中SL的实现,本...

20710
来自专栏大史住在大前端

webpack4.0各个击破(4)—— Javascript & splitChunk

javascript之所以需要打包合并,是因为模块化开发的存在。开发阶段我们需要将js文件分开写在很多零碎的文件中,方便调试和修改,但如果就这样上线,那首页的h...

713
来自专栏hotqin888的专栏

beego利用casbin进行权限管理——第四节 策略更新

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/hotqin888/article/det...

571
来自专栏码神联盟

网络爬虫 | Java 实现 AI人工智能技术 - 网络爬虫功能

目前网络上充斥着越来越多的网页数据,包含海量的数据,但是很多时候,不管是出于对产品需求还是数据分析的需要,我们需要从这些网站上搜索一些相关的、有价值的数...

1614
来自专栏嵌入式程序猿

一步步学习MQX实时操作系统(4)

启动流程分析 学习任何一种操作系统,我们都要分析它的启动流程,MQX实时操作系统启动分为芯片硬件启动和MQX操作系统启动。硬件芯片启动过程和裸机启动一样...

2495
来自专栏Seebug漏洞平台

TCTF/0CTF2018 XSS Writeup

刚刚4月过去的TCTF/0CTF2018一如既往的给了我们惊喜,其中最大的惊喜莫过于多道xss中Bypass CSP的题目,其中有很多应用于现代网站的防御思路。...

793

扫码关注云+社区