Foundation中的斷言處理
Foundation中的斷言處理
經(jīng)常在看一些第三方庫的代碼時(shí)，或者自己在寫一些基礎(chǔ)類時(shí)，都會用到斷言。所以在此總結(jié)一下Objective-C中關(guān)于斷言的一些問題。
Foundation中定義了兩組斷言相關(guān)的宏，分別是：
- NSAssert / NSCAssert
- NSParameterAssert / NSCParameterAssert
這兩組宏主要在功能和語義上有所差別，這些區(qū)別主要有以下兩點(diǎn)：
如果我們需要確保方法或函數(shù)的輸入?yún)?shù)的正確性，則應(yīng)該在方法(函數(shù))的頂部使用NSParameterAssert / NSCParameterAssert；而在其它情況下，使用NSAssert / NSCAssert。
另一個(gè)不同是介于C和Objective-C之間。NSAssert / NSParameterAssert應(yīng)該用于Objective-C的上下文(方法)中，而NSCAssert / NSCParameterAssert應(yīng)該用于C的上下文(函數(shù))中。
當(dāng)斷言失敗時(shí)，通常是會拋出一個(gè)如下所示的異常：
- *** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'true is not equal to false'
Foundation為了處理斷言，專門定義了一個(gè)NSAssertionHandler來處理斷言的失敗情況。NSAssertionHandler對象是自動創(chuàng)建的，用于處理失敗的斷言。當(dāng)斷言失敗時(shí)，會傳遞一個(gè)字符串給NSAssertionHandler對象來描述失敗的原因。每個(gè)線程都有自己的NSAssertionHandler對象。當(dāng)調(diào)用時(shí)，一個(gè)斷言處理器會打印包含方法和類(或函數(shù))的錯(cuò)誤消息，并引發(fā)一個(gè)NSInternalInconsistencyException異常。就像上面所看到的一樣。
我們很少直接去調(diào)用NSAssertionHandler的斷言處理方法，通常都是自動調(diào)用的。
NSAssertionHandler提供的方法并不多，就三個(gè)，如下所示：
- // 返回與當(dāng)前線程的NSAssertionHandler對象。
- // 如果當(dāng)前線程沒有相關(guān)的斷言處理器，則該方法會創(chuàng)建一個(gè)并指定給當(dāng)前線程
- + (NSAssertionHandler *)currentHandler
- // 當(dāng)NSCAssert或NSCParameterAssert斷言失敗時(shí)，會調(diào)用這個(gè)方法
- - (void)handleFailureInFunction:(NSString *)functionName file:(NSString *)object lineNumber:(NSInteger)fileName description:(NSString *)line, format,...
- // 當(dāng)NSAssert或NSParameterAssert斷言失敗時(shí)，會調(diào)用這個(gè)方法
- - (void)handleFailureInMethod:(SEL)selector object:(id)object file:(NSString *)fileName lineNumber:(NSInteger)line description:(NSString *)format, ...
另外，還定義了一個(gè)常量字符串，
- NSString * const NSAssertionHandlerKey;
主要是用于在線程的threadDictionary字典中獲取或設(shè)置斷言處理器。
關(guān)于斷言，還需要注意的一點(diǎn)是在Xcode 4.2以后，在release版本中斷言是默認(rèn)關(guān)閉的，這是由宏NS_BLOCK_ASSERTIONS來處理的。也就是說，當(dāng)編譯release版本時(shí)，所有的斷言調(diào)用都是無效的。
我們可以自定義一個(gè)繼承自NSAssertionHandler的斷言處理類，來實(shí)現(xiàn)一些我們自己的需求。如Mattt Thompson的NSAssertionHandler實(shí)例一樣：
- @interface LoggingAssertionHandler : NSAssertionHandler
- @end
- @implementation LoggingAssertionHandler
- - (void)handleFailureInMethod:(SEL)selector
- object:(id)object
- file:(NSString *)fileName
- lineNumber:(NSInteger)line
- description:(NSString *)format, ...
- {
- NSLog(@"NSAssert Failure: Method %@ for object %@ in %@#%i", NSStringFromSelector(selector), object, fileName, line);
- }
- - (void)handleFailureInFunction:(NSString *)functionName
- file:(NSString *)fileName
- lineNumber:(NSInteger)line
- description:(NSString *)format, ...
- {
- NSLog(@"NSCAssert Failure: Function (%@) in %@#%i", functionName, fileName, line);
- }
- @end
上面說過，每個(gè)線程都有自己的斷言處理器。我們可以通過為線程的threadDictionary字典中的NSAssertionHandlerKey指定一個(gè)新值，來改變線程的斷言處理器。
如下代碼所示：
- - (BOOL)application:(UIApplication *)application
- didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
- {
- NSAssertionHandler *assertionHandler = [[LoggingAssertionHandler alloc] init];
- [[[NSThread currentThread] threadDictionary] setValue:assertionHandler
- forKey:NSAssertionHandlerKey];
- // ...
- return YES;
- }
而什么時(shí)候應(yīng)該使用斷言呢？通常我們期望程序按照我們的預(yù)期去運(yùn)行時(shí)，如調(diào)用的參數(shù)為空時(shí)流程就無法繼續(xù)下去時(shí)，可以使用斷言。但另一方面，我們也需要考慮，在這加斷言確實(shí)是需要的么？我們是否可以通過更多的容錯(cuò)處理來使程序正常運(yùn)行呢？
Mattt Thompson在NSAssertionHandler中的倒數(shù)第二段說得挺有意思，在此摘抄一下：
But if we look deeper into NSAssertionHandler—and indeed, into our own hearts, there are lessons to be learned about our capacity for kindness and compassion; about our ability to forgive others, and to recover from our own missteps. We can't be right all of the time. We all make mistakes. By accepting limitations in ourselves and others, only then are we able to grow as individuals.
參考
NSAssertionHandler
NSAssertionHandler Class Reference
