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

相关文章

来自专栏我和未来有约会

Silverlight第三方控件专题

这里我收集整理了目前网上silverlight第三方控件的专题,若果有所遗漏请告知我一下。 名称 简介 截图 telerik 商 RadC...

4425
来自专栏杨龙飞前端

scrollto 到指定位置

2994
来自专栏一个会写诗的程序员的博客

Spring Reactor 项目核心库Reactor Core

Non-Blocking Reactive Streams Foundation for the JVM both implementing a Reactiv...

2862
来自专栏Golang语言社区

【Golang语言社区】GO1.9 map并发安全测试

var m sync.Map //全局 func maintest() { // 第一个 YongHuomap := make(map[st...

5538
来自专栏跟着阿笨一起玩NET

c#实现打印功能

3832
来自专栏一个爱瞎折腾的程序猿

sqlserver使用存储过程跟踪SQL

USE [master] GO /****** Object: StoredProcedure [dbo].[sp_perfworkload_trace_s...

3000
来自专栏张善友的专栏

Silverlight + Model-View-ViewModel (MVVM)

     早在2005年,John Gossman写了一篇关于Model-View-ViewModel模式的博文,这种模式被他所在的微软的项目组用来创建Expr...

3318
来自专栏闻道于事

js登录滑动验证,不滑动无法登陆

js的判断这里是根据滑块的位置进行判断,应该是用一个flag判断 <%@ page language="java" contentType="text/html...

8868
来自专栏魂祭心

原 canvas绘制clock

5184
来自专栏陈仁松博客

ASP.NET Core 'Microsoft.Win32.Registry' 错误修复

今天在发布Asp.net Core应用到Azure的时候出现错误InvalidOperationException: Cannot find compilati...

5258

扫码关注云+社区