iOS技术文档No.21 Foundation_NSAssertionHandler

简介

NSAssertionHandler，断言。
NSAssertionHandler实例是自动创建的，用于处理错误断言。断言宏，比如NSAssert和NSCAssert，用于评估一个条件，如果条件评估为错误，这个宏向NSAssertionHandler实例发送一个表示错误的字符串。每个线程都有它自己的NSAssertionHandler实例。断言处理程序调用的时候，会打印一条错误信息，包含断言的方法或类，并抛出一个NSInternalInconsistencyException。

注意：一般情况下我们精良不要使用这个类，他可能导致不能预测的错误，尤其是在你的线上的版本中

方法

+ currentHandler//返回当前线程的断言处理实例。
如果当前线程没有相关联的断言处理实例，这个方法会创建一个并将它分配给这个线程。
- handleFailureInFunction:file:lineNumber:description:
记录错误信息日志（使用NSLog），包含函数名，文件名和行号。
- (void)handleFailureInFunction:(NSString *)functionName file:(NSString *)fileName lineNumber:(NSInteger)line description:(NSString *)format,...
参数  
functionName:失败的函数
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串

抛出NSInternalInconsistencyException。
- (void)handleFailureInMethod:(SEL)selector object:(id)object file:(NSString *)fileName lineNumber:(NSInter)line description:(NSString *)format,...
参数
selector:失败的方法的选择器
object:失败的对象
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串

如果你需要自定义NSAssertionHandler的行为，创建子类，重写handleFailureInMethod:object:file:lineNumber:description:和handleFailureInFunction:file:lineNumber:description:方法，然后将你的实例用这个键安装到当前的线程属性字典。

@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

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  NSAssertionHandler *assertionHandler = [[LoggingAssertionHandler alloc] init];
  [[[NSThread currentThread] threadDictionary] setValue:assertionHandler
                                                 forKey:NSAssertionHandlerKey];
  // ...

  return YES;
}