我正在处理我的应用程序中的错误,并且正在考虑使用 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
设置了一个值。
了解更多信息的最佳位置是 Apple's documentation。这真的很好。
Cocoa Is My Girlfriend 上还有一个不错的简单教程。
我想根据我最近的实施添加更多建议。我查看了 Apple 的一些代码,我认为我的代码的行为方式大致相同。
上面的帖子已经解释了如何创建 NSError 对象并返回它们,所以我不会打扰那部分。我将尝试提出一种在您自己的应用程序中集成错误(代码、消息)的好方法。
我建议创建 1 个标头,以概述您的域(即应用程序、库等)的所有错误。我当前的标题如下所示:
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 将为您的应用程序创建一些基本的标准错误消息。可能会创建如下错误:
+ (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) 创建一个包含错误的 strings
文件。字符串文件很容易本地化。该文件可能如下所示:
FSError.strings
"1000" = "User not logged in.";
"1001" = "Logout failed.";
"1002" = "Parser failed.";
"1003" = "Incorrect username or password.";
"1004" = "Failed to parse FNID."
2) 添加宏以将整数代码转换为本地化错误消息。我在我的 Constants+Macros.h 文件中使用了 2 个宏。为方便起见,我总是将此文件包含在前缀标头 (MyApp-Prefix.pch
) 中。
常量+宏.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];
Constants+Macros.h
的文件中,然后将此文件导入前缀标头(.pch
文件)中,以便它在任何地方都可用。如果您的意思是您只使用 2 个宏中的 1 个,那可能会起作用。也许从 int
到 NSString
的转换并不是真正必要的,尽管我没有对此进行测试。
.strings
文件)中,因为那是 Apple 的宏所在的位置。在此处阅读有关使用 NSLocalizedStringFromTable
的信息:developer.apple.com/library/mac/documentation/cocoa/conceptual/…
FS_ERROR_LOCALIZED_DESCRIPTION
中的代码检查名为 FSError.strings
的文件中的可本地化字符串。如果您对 .strings
文件不熟悉,您可能需要查看 Apple 的本地化指南。
很好的答案亚历克斯。一个潜在的问题是 NULL 取消引用。 Apple 在 Creating and Returning NSError objects 上的参考
...
[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"
}];
斯威夫特 3
let error = NSError(domain: "some_domain",
code: 100,
userInfo: [NSLocalizedDescriptionKey: "Something went wrong"])
我将尝试总结 Alex 和 jlmendezbonini 的观点的最佳答案,添加一个修改,使所有 ARC 都兼容(到目前为止,还不是因为 ARC 会抱怨,因为你应该返回 id
,这意味着“任何对象”,但是 { 2} 不是对象类型)。
- (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.
我见过的另一种设计模式涉及使用块,这在异步运行方法时特别有用。
假设我们定义了以下错误代码:
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 对象(代码完成会为您完成)或检查返回值。您可以只提供两个块:一个在出现异常时调用,另一个在成功时调用:
[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");
}
}];
extension NSError {
static func defaultError() -> NSError {
return NSError(domain: "com.app.error.domain", code: 0, userInfo: [NSLocalizedDescriptionKey: "Something went wrong."])
}
}
只要我没有有效的错误对象,我就可以使用 NSError.defaultError()
。
let error = NSError.defaultError()
print(error.localizedDescription) //Something went wrong.
好吧,范围有点问题,但是如果您没有 NSError 选项,您可以随时显示低级错误:
NSLog(@"Error = %@ ",[NSString stringWithUTF8String:strerror(errno)]);
不定期副业成功案例分享
id
转换为BOOL
。任何轻微的 ARC 兼容变化将不胜感激。BOOL
。如果出错则返回NO
,而不是检查返回值,只需检查error
。如果nil
继续,如果!= nil
处理它。**error
不为零的代码。否则,程序将抛出一个完全不友好的错误,并且不会使正在发生的事情变得明显。