235

我正在努力在我的应用程序中捕获错误，并且正在研究使用NSError. 我对如何使用它以及如何填充它感到有些困惑。

有人可以提供一个关于我如何填充然后使用的例子NSError吗？

4

9 回答 9

483

好吧，我通常做的是让我的可能在运行时出错的方法引用一个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 的文档。这真的很好。

还有一个关于Cocoa Is My Girlfriend的不错的简单教程。

于 2011-01-11T06:15:51.150 回答
60

我想根据我最近的实施添加更多建议。我查看了 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];
于 2012-12-29T21:50:34.727 回答
38

很好的答案亚历克斯。一个潜在的问题是 NULL 取消引用。Apple 关于创建和返回 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;
...
于 2011-05-10T20:11:58.807 回答
32

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"])
于 2014-01-09T19:43:03.423 回答
9

请参考以下教程

我希望它对您有所帮助，但在您必须阅读NSError文档之前

这是我最近发现的非常有趣的链接ErrorHandling

于 2011-01-11T06:01:41.580 回答
3

我将尝试总结 Alex 和 jlmendezbonini 的观点的最佳答案，添加一个修改，使所有 ARC 都兼容（到目前为止，不是因为 ARC 会抱怨，因为你应该 return id，这意味着“任何对象”，但BOOL不是对象类型）。

- (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.
于 2012-12-30T15:51:16.893 回答
3

我见过的另一种设计模式涉及使用块，这在异步运行方法时特别有用。

假设我们定义了以下错误代码：

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");
    }
}];
于 2013-07-08T03:44:50.843 回答
1 
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.
于 2020-04-02T16:10:38.990 回答
0

好吧，范围有点问题，但是如果您没有 NSError 选项，您可以随时显示低级错误：

 NSLog(@"Error = %@ ",[NSString stringWithUTF8String:strerror(errno)]);
于 2014-02-14T14:18:58.633 回答