不该缺少的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 条评论
登录 后参与评论

相关文章

来自专栏码农阿宇

国内开源社区巨作AspectCore-Framework入门

在软件业,AOP为Aspect Oriented Programming的缩写,意为:面向切面编程,通过预编译方式和运行期动态代理实现程序功能的统一维护的一种技...

1521
来自专栏ppjun专栏

Retrofit 使用笔记

在使用retrofit之前,你需要导入retrofit gsonconverter这些库。详情可以查看相关资料。https://github.com/squar...

872
来自专栏冰霜之地

Realm数据库 从入门到“放弃”

Realm是由Y Combinator公司孵化出来的一款可以用于iOS(同样适用于Swift&Objective-C)和Android的跨平台移动数据库。目前最...

1322
来自专栏IMWeb前端团队

在NodeJS中玩转Protocol Buffer

本文作者:IMWeb link 原文出处:IMWeb社区 未经同意,禁止转载 这篇文章的代码都是基于Protobuf.js 4.x的API写的,已经...

3718
来自专栏腾讯IVWEB团队的专栏

在 NodeJS 中玩转 Protocol Buffer

Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据序列化,很适合做数据存储或 RPC 数据交换格式。

1.1K0
来自专栏逸鹏说道

Python3 与 C# 并发编程之~ 上篇

其实逆天现在Coding已经是80%变成Python了,20%才是Net,也不确定是否一直在Net界干下去,所以只能尽可能的在说新知识的同时,尽量把脑子里面Ne...

1014
来自专栏个人随笔

C#图解教程第一章 C#和.NET框架

1.1 在.NET之前  C#发音:see shap  1.1.1 20世纪90年代后期的Windows编程   20世纪90年代后期各语言缺点:    1.纯...

31811
来自专栏lulianqi

一个基于.NET平台的自动化/压力测试系统设计简述

AutoTest是一个基于.NET平台实现的自动化/压力测试的系统,可独立运行于windows平台下,支持分布式部署,不需要其他配置或编译器的支持。(本质是一个...

981
来自专栏Java呓语

设计模式开篇

设计模式这玩意平日里让我思绪万千,可真要提起笔来却顾头顾尾、不得要义。于是乎就有了书写设计模式系列的想法,一来是彻头彻尾的归纳总结一遍,二来也希望尽自己力量生产...

1072
来自专栏青玉伏案

iOS开发之SQLite--C语言接口规范(五)——iOS开发使用SQLite实例

  本篇博客就使用前面操作SQLite的知识来实现如何去插入,删除和更新数据。然后再把操作SQlite数据库常用的方法进行一个封装。把常用方法进行封装后,把Ca...

1986

扫码关注云+社区