NSError分析

寫在前面

在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所對應的頭文件如下:

  1. <Foundation/FoundationErrors.h> -- Generic Foundation error codes
  2. <CoreData/CoreDataErrors.h> -- Core Data error codes
  3. <Foundation/NSURLError.h> -- 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》

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,182評論 6 543
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,489評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,290評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,776評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,510評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,866評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,860評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,036評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,585評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,331評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,536評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,058評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,754評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,154評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,469評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,273評論 3 399
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,505評論 2 379

推薦閱讀更多精彩內容

  • NSError分析 寫在前面 在iOS開發中,NSError的使用非常常見,使用也比較簡單,也正因為簡單,所以對這...
    Goplayer王布斯閱讀 363評論 0 1
  • A型人的祖先是最早從事農耕作物生產的,因而對以素食為主的食譜比較能夠適應他們最佳的健康食品是植物蛋白質如大豆蛋白質...
    淡出生活123閱讀 340評論 1 1
  • 第2天 www.kekenet.com/cet6/201408/315407_3.shtml Q: What’s ...
    123逍遙游閱讀 213評論 0 0
  • 總體難度概括:難 文章介紹: 標題: Musecum of fine art and their public ...
    造物家英語閱讀 1,734評論 0 0