美文网首页程序员
NSError浅析+自定义

NSError浅析+自定义

作者: senpaiLi | 来源:发表于2017-10-25 12:13 被阅读107次

写在前面:

在iOS开发中,NSError的使用非常常见,使用也比较简单,也正因为简单,所以对这一部分知识不甚注重。但是近期在做app底层网络封装时发现了一些问题。我使用的网络框架是AFNetworking,AFNetworking常常会返回一些错误信息,有时需要将这些错误信息告诉用户,通常做法是将error.localizedDescription以弹框的形式原原本本展现给用户(譬如“网络不畅”之类的),但是这样非常不友好,一是这些信息往往是英文,二是这些信息过于冗长,不够简洁。所以自然想到了对这些error信息进行包装。这就迫使我不得不去了解更多关于NSError相关的信息,本文着重叙述Error Domain和Error Code。

Error Domain

首先,error domain是一个字符串。因为历史原因,在OS X中将errors分为不同的domains。譬如,对于Carbon框架的Error,归于OSStatus domain(NSOSStatusErrorDomain),对于POSIX error,归于NSPOSIXErrorDomain,而对于我们的iOS开发,一般使用NSCocoaErrorDomain。NSError.h定义了四个domain,如下:

// Predefined domain for errors from most AppKit and Foundation APIs.

FOUNDATION_EXPORT NSString *const NSCocoaErrorDomain;

// Other predefined domains; value of "code" will correspond to preexisting values in these domains.

FOUNDATION_EXPORT NSString *const NSPOSIXErrorDomain;

FOUNDATION_EXPORT NSString *const NSOSStatusErrorDomain;

FOUNDATION_EXPORT NSString *const NSMachErrorDomain;

除了上述的四个domain之外,不同的framework甚至一些classes group(相关的几个classes)也定义了自己的domain,譬如对于Web Kit framework,定义了WebKitErrorDomain,而更常见的,URL相关的classes定义了NSURLErrorDomain。

Domains非常有用,特别当程序非常复杂庞大时,官方文档是这么说的:

Domains serve several useful purposes. They give Cocoa programs a way to identify the OS X subsystem that is detecting an error. They also help to prevent collisions between error codes from different subsystems with the same numeric value. In addition, domains allow for a causal relationship between error codes based on the layering of subsystems; for example, an error in the NSOSStatusErrorDomain may have an underlying error in the NSMachErrorDomain.

用户也可以为自己的framework或者app定义自己的domain,官方推荐的domain命名是:

com.company.framework_or_app .ErrorDomain

Error Code

Error Code的类型是signed integer。Error Code指定了特殊的错误。这个信息对于程序开发来说极为有用。比如访问URL资源timeout错误对应的是NSURLErrorTimedOut(-1001)。

那么如何知道各个error code对应什么样的值呢?iOS开发中常用的error code所对应的头文件如下:

-- Generic Foundation error codes

-- Core Data error codes

-- URL error codes

以Foundation/NSURLError.h为例,其中的URLError Code值从NSURLErrorDataLengthExceedsMaximum到NSURLErrorCancelled,二者分别对应-1103和-999。如果对所有网络error笼统处理,这两个值可以为我所用。

The User Info Dictionary

Every NSError object has a “user info” dictionary to hold error information beyond domain and code.

user info可以包含很多自定义信息,最常用的或许是localized error information。访问localized error information有两种方式,其一是访问error的localizedDescription属性,其二是访问error.userInfo的NSLocalizedDescriptionKey域。

关于user info dictionary,比较常见,这里不多讲了,更多内容参考:

《Error Handling Programming Guide》

相关文章

  • NSError浅析+自定义

    写在前面: 在iOS开发中,NSError的使用非常常见,使用也比较简单,也正因为简单,所以对这一部分知识不甚注重...

  • 你真的了解NSError吗?

    NSError是什么? NSError是系统提供的错误类,它继承于NSObject,用于获取系统错误或者自定义错误...

  • AFNetworking-NSError错误码,中文提示

    NSError 中文提示 使用AFNetworking 网络请求失败,返回NSError对象,通常去error.l...

  • NSError对照码

    前言整理一下在iOS开发中NSError的错误代码 NSError NSError是系统错误信息类 初始化方法两个...

  • 嵌套滑动

    浅析NestedScrolling嵌套滑动机制之实践篇-自定义Behavior实现小米音乐歌手详情[https:/...

  • AFNetworking解析错误信息

    如果请求失败则NSError不为空这时候可以解析NSError来获得失败信息

  • NSError

    NSErro :错误域,错误码,错误信息

  • NSError

    参考文档 Using and Creating Error Objects

  • NSError

    非作者原著 来自摘抄 参考文献 J_Knight_ NSError 三种信息 Error domain 错误范围 ...

  • 使用AFN解析服务器返回的错误

    +(id)codeWithError:(NSError *)error{ // NSUInteger...

网友评论

    本文标题:NSError浅析+自定义

    本文链接:https://www.haomeiwen.com/subject/kududxtx.html