Как я могу использовать NSError в своем приложении для iPhone?

228

Я работаю над обнаружением ошибок в моем приложении и пытаюсь их использовать NSError. Я немного запутался в том, как его использовать и как его заполнить.

Может ли кто-нибудь привести пример того, как я заполняю, а затем использую NSError?

Ник Хаббард
источник

Ответы:

473

Хорошо, что я обычно делаю, так это чтобы мои методы, которые могли вызывать ошибки во время выполнения, брали ссылку на 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 .

Alex
источник
37
это пример смешная, когда - либо
мина Yeow
это довольно удивительный ответ, хотя в ARC есть некоторые проблемы и приведение idк a BOOL. Любая небольшая ARC-совместимая вариация будет высоко оценена.
NSTJ
6
@ TomJowett Я был бы очень зол, если бы мы не смогли покончить с голодом в мире просто потому, что Apple подтолкнула нас перейти в новый мир ARC only.
Манав
1
тип возврата может быть BOOL. Возврат NOв случае ошибки и вместо проверки возвращаемого значения, просто проверьте error. Если nilидти вперед, если != nilсправиться.
Габриэле Петронелла
8
-1: вам действительно нужно включить код, который проверяет **errorне ноль. В противном случае программа выдаст ошибку, которая совершенно недружественная и не дает понять, что происходит.
FreeAsInBeer
58

Я хотел бы добавить еще несколько предложений, основанных на моей последней реализации. Я посмотрел на некоторый код от 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) Добавьте макросы для преобразования целочисленных кодов в локализованные сообщения об ошибках. Я использовал 2 макроса в моем файле Constants + Macros.h. Я всегда включаю этот файл в заголовок префикса ( 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];
Вольфганг Шреурс
источник
9
Отличный ответ! Но почему бы не поместить локализованное описание в пользовательский информационный словарь, к которому оно относится? [NSError errorWithDomain: FSMyAppErrorDomain код: FSProfileParsingFailedError userInfo: @ {NSLocalizedDescriptionKey: FS_ERROR_LOCALIZED_DESCRIPTION (error.code)}];
Ричард Венейбл
1
Есть ли какое-то конкретное место, куда я должен поместить строковый файл? От FS_ERROR_LOCALIZED_DESCRIPTION () я получаю только номер (код ошибки).
Хагги
@ Huggie: не совсем уверен, что вы имеете в виду. Я обычно помещаю эти макросы, которые я использую по всему приложению, в файл с именем Constants+Macros.hи импортирую этот файл в заголовок префикса ( .pchфайл), чтобы он был доступен везде. Если вы имеете в виду, что вы используете только 1 из 2 макросов, это может сработать. Возможно преобразование из intв NSStringне действительно необходимо, хотя я не проверял это.
Вольфганг Шреурс
@ Huggie: Ой, я думаю, что понимаю тебя сейчас. Строки должны быть в локализуемом файле ( .stringsфайле), поскольку именно здесь будет выглядеть макрос Apple. Прочтите об использовании NSLocalizedStringFromTableздесь: developer.apple.com/library/mac/documentation/cocoa/conceptual/…
Вольфганг Шреурс
1
@huggie: Да, я использовал локализованные строковые таблицы. Код макрофайлов FS_ERROR_LOCALIZED_DESCRIPTIONпроверок localisable строки в файле FSError.strings. Возможно, вы захотите проверить руководство Apple по локализации .stringsфайлов, если оно вам не чуждо.
Вольфганг Шреурс
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;
...
jlmendezbonini
источник
30

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"])
AlBeebe
источник
9

Пожалуйста, обратитесь к следующему учебнику

Я надеюсь, что это будет полезно для вас, но прежде чем вы должны прочитать документацию NSError

Это очень интересная ссылка, которую я нашел недавно ErrorHandling

Tirth
источник
3

Я постараюсь обобщить отличный ответ Алекса и точку зрения jlmendezbonini, добавив модификацию, которая сделает все ARC-совместимым (пока это не так, поскольку ARC будет жаловаться, так как вы должны вернуться 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.
Габриэле Петронелла
источник
3
@Gabriela: Apple заявляет, что при использовании переменных косвенности для возврата ошибок сам метод всегда должен иметь возвращаемое значение в случае успеха или неудачи. Apple призывает разработчиков сначала проверять возвращаемое значение, и только если возвращаемое значение каким-то образом недействительно, проверять наличие ошибок. Смотрите следующую страницу: developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/…
Вольфганг Шреурс
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");
    }
}];
Senseful
источник
0

Что ж, это немного выходит за рамки возможного, но если у вас нет опции для NSError, вы всегда можете отобразить ошибку низкого уровня:

 NSLog(@"Error = %@ ",[NSString stringWithUTF8String:strerror(errno)]);
Mike.R
источник
0
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.
Hemang
источник