Некоторые методы делегата предупреждают Вас к ошибкам

Если Вы реализуете объект делегата для использования с классом платформы, выполняющим определенную задачу, как загрузка информации от удаленного веб-сервиса, то Вы будете обычно находить, что необходимо реализовать по крайней мере один связанный с ошибкой метод. NSURLConnectionDelegate протокол, например, включает a connection:didFailWithError: метод:

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error;

Если ошибка произойдет, то этот метод делегата вызовут для обеспечения Вас NSError объект описать проблему.

NSError объект содержит числовой код ошибки, домен и описание, а также другую релевантную информацию, упакованную в пользовательском информационном словаре.

Вместо того, чтобы делать требование, чтобы каждая возможная ошибка имела уникальный числовой код, Какао и Сенсорные ошибки Какао разделены на домены. Если ошибка происходит в NSURLConnection, например, connection:didFailWithError: метод выше обеспечит ошибку от NSURLErrorDomain.

Ошибочный объект также включает локализованное описание, такое как “Сервер с указанным именем хоста не мог быть найден”.

Некоторые ошибки передачи методов ссылкой

Некоторое Касание Какао и Какао API пасует назад ошибки ссылкой. Как пример, Вы могли бы решить хранить данные, которые Вы получаете от веб-сервиса путем записи его в диск, с помощью NSData метод writeToURL:options:error:. Последний параметр к этому методу является ссылкой на NSError указатель:

- (BOOL)writeToURL:(NSURL *)aURL

           options:(NSDataWritingOptions)mask

             error:(NSError **)errorPtr;

Перед вызовом этого метода необходимо будет создать подходящий указатель так, чтобы можно было передать его адрес:

    NSError *anyError;

    BOOL success = [receivedData writeToURL:someLocalFileURL

                                    options:0

                                      error:&anyError];

    if (!success) {

        NSLog(@"Write failed with error: %@", anyError);

        // present error to user

    }

Если ошибка происходит, writeToURL:... метод возвратится NO, и обновление Ваш anyError указатель для указания на ошибочный объект на описание проблемы.

При контакте с ошибками, переданными ссылкой, важно протестировать возвращаемое значение метода, чтобы видеть, произошла ли ошибка, как показано выше. Только протестируйте, чтобы видеть, был ли ошибочный указатель установлен указать на ошибку.

Восстановитесь если Возможный или Дисплей Ошибка Пользователю

Лучший пользовательский опыт для Вашего приложения для восстановления прозрачно с ошибки. При создании удаленного веб-запроса, например, Вы могли бы попытаться обратиться с просьбой снова с различным сервером. Также Вы, возможно, должны были бы запросить дополнительную информацию от пользователя, такого как допустимые учетные данные имени пользователя или пароля перед тем, чтобы попробовать еще раз.

Если не возможно восстановиться с ошибки, необходимо предупредить пользователя. Если Вы разработаете с Касанием Какао для iOS, то необходимо будет создать и сконфигурировать a UIAlertView вывести на экран ошибку. Если Вы разрабатываете с Какао для OS X, можно вызвать presentError: на любом NSResponder объект (как представление, окно или даже сам объект приложения) и ошибка распространит цепочку респондента для дальнейшей конфигурации или восстановления. Когда это достигает объекта приложения, приложение представляет ошибку пользователю через предупредительную панель.

Для получения дополнительной информации о представлении ошибок пользователю посмотрите информацию об Отображении От Ошибочных Объектов.

Генерация собственных ошибок

Для создания собственного NSError объекты необходимо будет определить собственный ошибочный домен, который должен иметь форму:

com.companyName.appOrFrameworkName.ErrorDomain

Необходимо будет также выбрать уникальный код ошибки для каждой ошибки, которая может произойти в домене, вместе с подходящим описанием, которое сохранено в пользовательском информационном словаре для ошибки, как это:

    NSString *domain = @"com.MyCompany.MyApplication.ErrorDomain";

    NSString *desc = NSLocalizedString(@"Unable to…", @"");

    NSDictionary *userInfo = @{ NSLocalizedDescriptionKey : desc };

    NSError *error = [NSError errorWithDomain:domain

                                         code:-101

                                     userInfo:userInfo];

Этот пример использует NSLocalizedString функция для поиска локализованной версии описания ошибки от a Localizable.strings файл, как описано в Локализации Строковых ресурсов.

Если необходимо пасовать назад ошибку ссылкой, как описано ранее, сигнатура метода должна включать параметр для указателя на указатель на NSError объект. Необходимо также использовать возвращаемое значение для указания успешности или неуспешности, как это:

- (BOOL)doSomethingThatMayGenerateAnError:(NSError **)errorPtr;

Если ошибка происходит, необходимо запустить путем проверки ли не -NULL указатель был предоставлен для параметра ошибок, прежде чем Вы попытаетесь разыменовать его для установки ошибки перед возвратом NO указать отказ, как это:

- (BOOL)doSomethingThatMayGenerateAnError:(NSError **)errorPtr {

    ...

    // error occurred

    if (errorPtr) {

        *errorPtr = [NSError errorWithDomain:...

                                        code:...

                                    userInfo:...];

    }

    return NO;

}