我如何在我的iPhone应用程序中使用NSError?
我正在努力捕捉我的应用程序中的错误,我正在研究使用NSError
。 我对如何使用它以及如何填充它稍有困惑。
有人可以提供一个例子,我如何填充,然后使用NSError
?
那么,我通常做的是让我的方法可以在运行时错误地引用一个NSError
指针。 如果在这个方法中确实出了问题,我可以用错误数据填充NSError
引用,并从方法返回nil。
例:
- (id) endWorldHunger:(id)largeAmountsOfMonies error:(NSError**)error { // begin feeding the world's children... // it's all going well until.... if (ohNoImOutOfMonies) { // sad, we can't solve world hunger, but we can let people know what went wrong! // init dictionary to be used to populate error object NSMutableDictionary* details = [NSMutableDictionary dictionary]; [details setValue:@"ran out of money" forKey:NSLocalizedDescriptionKey]; // populate the error object with the details *error = [NSError errorWithDomain:@"world" code:200 userInfo:details]; // we couldn't feed the world's children...return nil..sniffle...sniffle return nil; } // wohoo! We fed the world's children. The world is now in lots of debt. But who cares? return YES; }
然后我们可以使用这样的方法。 除非方法返回nil,否则甚至不打扰检查错误对象:
// initialize NSError object NSError* error = nil; // try to feed the world id yayOrNay = [self endWorldHunger:smallAmountsOfMonies error:&error]; if (!yayOrNay) { // inspect error NSLog(@"%@", [error localizedDescription]); } // otherwise the world has been fed. Wow, your code must rock.
我们能够访问错误的localizedDescription
因为我们为NSLocalizedDescriptionKey
设置了一个值。
苹果的文档是获取更多信息的最佳地点。 这真的很好。
cocoa是我的女朋友也有一个很好的,简单的教程。
我想根据我最近的实施来添加更多的build议。 我看了一些来自苹果的代码,我认为我的代码的行为方式大致相同。
上面的post已经解释了如何创buildNSError对象并返回它们,所以我不会为此而烦恼。 我只是试图build议一个很好的方式来整合错误(代码,消息)在你自己的应用程序。
我build议创build一个头,这将是您的域的所有错误(即应用程序,库等)的概述。 我目前的标题是这样的:
FSError.h
FOUNDATION_EXPORT NSString *const FSMyAppErrorDomain; enum { FSUserNotLoggedInError = 1000, FSUserLogoutFailedError, FSProfileParsingFailedError, FSProfileBadLoginError, FSFNIDParsingFailedError, };
FSError.m
#import "FSError.h" NSString *const FSMyAppErrorDomain = @"com.felis.myapp";
现在,当使用上面的错误值时,Apple会为您的应用程序创build一些基本的标准错误信息。 可以创build一个错误,如下所示:
+ (FSProfileInfo *)profileInfoWithData:(NSData *)data error:(NSError **)error { FSProfileInfo *profileInfo = [[FSProfileInfo alloc] init]; if (profileInfo) { /* ... lots of parsing code here ... */ if (profileInfo.username == nil) { *error = [NSError errorWithDomain:FSMyAppErrorDomain code:FSProfileParsingFailedError userInfo:nil]; return nil; } } return profileInfo; }
以上代码的标准Apple生成的错误消息( error.localizedDescription
)将如下所示:
Error Domain=com.felis.myapp Code=1002 "The operation couldn't be completed. (com.felis.myapp error 1002.)"
以上对于开发者来说已经相当有帮助,因为这个消息显示了发生错误的域和相应的错误代码。 最终用户将不知道什么错误代码1002
意思,所以现在我们需要为每个代码实现一些漂亮的消息。
对于错误消息,我们必须牢记本地化(即使我们没有立即实现本地化的消息)。 我在当前的项目中使用了以下方法:
1)创build一个包含错误的strings
文件。 string文件很容易本地化。 该文件可能如下所示:
FSError.strings
"1000" = "User not logged in."; "1001" = "Logout failed."; "1002" = "Parser failed."; "1003" = "Incorrect username or password."; "1004" = "Failed to parse FNID."
2)添加macros将整数代码转换为本地化的错误消息。 我在我的常量+ Macros.h文件中使用了2个macros。 为了方便起见,我总是将这个文件包含在前缀头文件( MyApp-Prefix.pch
)中。
常量+ Macros.h
// error handling ... #define FS_ERROR_KEY(code) [NSString stringWithFormat:@"%d", code] #define FS_ERROR_LOCALIZED_DESCRIPTION(code) NSLocalizedStringFromTable(FS_ERROR_KEY(code), @"FSError", nil)
3)现在很容易显示基于错误代码的用户友好的错误消息。 一个例子:
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Error" message:FS_ERROR_LOCALIZED_DESCRIPTION(error.code) delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil]; [alert show];
很好的回答Alex。 一个潜在的问题是NULL解除引用。 Apple 创build和返回NSError对象的参考
... [details setValue:@"ran out of money" forKey:NSLocalizedDescriptionKey]; if (error != NULL) { // populate the error object with the details *error = [NSError errorWithDomain:@"world" code:200 userInfo:details]; } // we couldn't feed the world's children...return nil..sniffle...sniffle return nil; ...
Objective-C的
NSError *err = [NSError errorWithDomain:@"some_domain" code:100 userInfo:@{ NSLocalizedDescriptionKey:@"Something went wrong" }];
Swift 3
let error = NSError(domain: "some_domain", code: 100, userInfo: [NSLocalizedDescriptionKey: "Something went wrong"])
请参考以下教程
我希望它会对你有所帮助,但之前你必须阅读NSError的文档
这是我最近发现的一个非常有趣的链接ErrorHandling
我会尝试总结一下Alex和jlmendezbonini的观点,并添加一个修改,使所有的ARC都兼容(到目前为止,这不是因为你应该返回id
,意思是“任何对象”,但是BOOL
不是一个对象types)。
- (BOOL) endWorldHunger:(id)largeAmountsOfMonies error:(NSError**)error { // begin feeding the world's children... // it's all going well until.... if (ohNoImOutOfMonies) { // sad, we can't solve world hunger, but we can let people know what went wrong! // init dictionary to be used to populate error object NSMutableDictionary* details = [NSMutableDictionary dictionary]; [details setValue:@"ran out of money" forKey:NSLocalizedDescriptionKey]; // populate the error object with the details if (error != NULL) { // populate the error object with the details *error = [NSError errorWithDomain:@"world" code:200 userInfo:details]; } // we couldn't feed the world's children...return nil..sniffle...sniffle return NO; } // wohoo! We fed the world's children. The world is now in lots of debt. But who cares? return YES; }
现在不是检查我们方法调用的返回值,而是检查error
是否仍然nil
。 如果不是我们有问题
// initialize NSError object NSError* error = nil; // try to feed the world BOOL success = [self endWorldHunger:smallAmountsOfMonies error:&error]; if (!success) { // inspect error NSLog(@"%@", [error localizedDescription]); } // otherwise the world has been fed. Wow, your code must rock.
我见过的另一种devise模式涉及使用块,这在asynchronous运行方法时特别有用。
假设我们定义了以下错误代码:
typedef NS_ENUM(NSInteger, MyErrorCodes) { MyErrorCodesEmptyString = 500, MyErrorCodesInvalidURL, MyErrorCodesUnableToReachHost, };
你会定义你的方法,可以引发这样的错误:
- (void)getContentsOfURL:(NSString *)path success:(void(^)(NSString *html))success failure:(void(^)(NSError *error))failure { if (path.length == 0) { if (failure) { failure([NSError errorWithDomain:@"com.example" code:MyErrorCodesEmptyString userInfo:nil]); } return; } NSString *htmlContents = @""; // Exercise for the reader: get the contents at that URL or raise another error. if (success) { success(htmlContents); } }
然后当你调用它时,你不需要担心声明NSError对象(代码完成会为你做),或者检查返回的值。 你可以提供两个块:一个在有exception时被调用,另一个在成功时被调用:
[self getContentsOfURL:@"http://google.com" success:^(NSString *html) { NSLog(@"Contents: %@", html); } failure:^(NSError *error) { NSLog(@"Failed to get contents: %@", error); if (error.code == MyErrorCodesEmptyString) { // make sure to check the domain too NSLog(@"You must provide a non-empty string"); } }];
那么这是有点出了问题的范围,但如果你没有一个NSError的选项,你总是可以显示低级别的错误:
NSLog(@"Error = %@ ",[NSString stringWithUTF8String:strerror(errno)]);