if (error) { // TODO }

In diesem Vortrag soll der Status Quo von Fehlerbehandlungen unter iOS analysiert werden und ein Vorschlag gemacht werden, wie die Responder Chain genutzt werden kann, um den Fluss von Fehlern durch die App zu steuern. Durch eine zentralisierte Fehlerbehandlung sollte nach diesem Talk kein if (error) { // TODO. } im Code mehr nötig sein.

Transcript

1. if (error) { // TODO } Sven Titgemeyer 15.09.2018
2. Wer bin ich? • iOS Enthusiast • Freelancer • große Projekte • Student • kleine Projekte • Open Source (iCarambaa) @s_titgemeyer
3. - (void)someMethod { NSURLSession *session = [NSURLSession sharedSession]; [session dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { if (error) { // TODO return; } // Continue with success case. }]; }
4. func someFunction() { URLSession.shared.dataTask(with: url) { (data, response, error) in guard let data = data else { // TODO return } // Continue... } }
5. func someFunction() { URLSession.shared.dataTask(with: url) { (data, response, error) in guard let data = data else { print("Error: \(error!)") return } // Continue... } }
7. Agenda • Error Handling Patterns • Was macht der Mac? • Error erstellen • Error weiterreichen • Error anzeigen Metal Systemframeworks Andere Frameworks Eigene Frameworks App Error Error
8. UIAlertView
9. UIAlertView ^(NSData *data, NSURLResponse *response, NSError *error) { if (data) { // Success case... } else { dispatch_async(dispatch_get_main_queue(), ^{ UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Error" message:error.localizedDescription delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil]; [alert show]; }); } }
10. UIAlertView ✗
11. UIAlertController
12. UIAlertController -[UIAlertController show] ✗
13. UIAlertController •Ein Alert ist ein View Controller •Wollen wir einen View Controller an x verschiedenen Stellen initialisieren? •… oder innerhalb eines Models? •Fragen wir Stackoverflow! •“Present UIAlertController without View Controller”
14. UIAlertController
15. UIAlertController • Eigene Alert über oder unter Systemalerts? • Window teilen oder kriegt jedes ein eigenes? • Mehrere Alerts übereinander? Kurz: Don’t
16. macOS
17. macOS @interface NSResponder(NSErrorPresentation) - (BOOL)presentError:(NSError *)error; - (NSError *)willPresentError:(NSError *)error; @end
18. macOS dispatch_async(dispatch_get_main_queue(), ^{ BOOL didRecover = [self presentError:error]; if (didRecover) { // Retry. } }
19. macOS
20. NSError Code Domain NSLocalizedDescriptionKey NSLocalizedFailureErrorKey NSLocalizedFailureReasonErrorKey NSLocalizedRecoverySuggestionErrorKey … Beispiel: NSFileWriteOutOfSpaceError “The image library could not be saved.” “The volume Macintosh HD is out of space.” NSLocalizedRecoveryOptionsErrorKey NSRecoveryAttempterErrorKey
21. Localized Description • Beschreibung aus dem Inhalt des Errors • “The image library could not be saved. The volume Macintosh HD is out of space.” • Mehrere Regeln, je nachdem, welche Informationen gesetzt sind. • Dokumentation nur in den Foundation Release Notes: 
 https://developer.apple.com/library/archive/releasenotes/Foundation/RN-Foundation/index.html
22. Responder Chain UIResponder UIView UIApplication UIViewController
23. UIView UIApplication UIViewController Superview UIViewController
24. UIResponder erweitern @interface UIResponder (STIErrorPresentation) - (void)presentError:(NSError *)error completionHandler:(nullable void (^)(BOOL didRecover))completionHandler; - (nullable NSError *)willPresentError:(NSError *)error; @end
25. UIApplication UIViewController UIViewController AppDelegate willPresentError: willPresentError: willPresentError: willPresentError: presentError: presentError: presentError: presentError: Achtung: Niemals [UIResponder presentError:] überschreiben
27. Erneut versuchen
28. NSError Code Domain NSLocalizedDescriptionKey NSLocalizedFailureErrorKey NSLocalizedFailureReasonErrorKey NSLocalizedRecoverySuggestionErrorKey … Beispiel: NSFileWriteOutOfSpaceError “The image library could not be saved.” “The volume Macintosh HD is out of space.” NSLocalizedRecoveryOptionsErrorKey NSRecoveryAttempterErrorKey
29. @interface NSObject(NSErrorRecoveryAttempting) - (BOOL)attemptRecoveryFromError:(NSError *)error optionIndex:(NSUInteger)recoveryOptionIndex; @end
30. STIRecoveryAttempter *a = [STIRecoveryAttempter new]; [a addOkayRecoveryOption]; [a addRecoveryOptionWithTitle: @"Retry" recoveryAttempt:^BOOL{ return YES; }]; NSError *_error = [error addingObject:a forUserInfoKey:NSRecoveryAttempterErrorKey]; [self presentError:_error completionHandler:^(BOOL didRecover) { if (didRecover) { [self loadFlightStatusUsingFlightnumber]; } }];
31. Problem • Error Fall wird komplizierter • Duplizierter Code • Retry Option wird an jeden Error angehangen • Besser: Konfiguriere Errors an zentraler Stelle!
32. UIApplication UIViewController UIViewController AppDelegate willPresentError: willPresentError: willPresentError: willPresentError: presentError: presentError: presentError: presentError:
33. UIApplication UIViewController UIViewController AppDelegate willPresentError: willPresentError: willPresentError: willPresentError:
34. UIApplication UIViewController UIViewController willPresentError: willPresentError: willPresentError: STIErrorConfigurator willPresentError: STIErrorConfigurator STIErrorConfigurator NSError -domain -code
35. UIApplication UIViewController UIViewController willPresentError: willPresentError: willPresentError: STIErrorConfigurator willPresentError: STIErrorConfigurator STIErrorConfigurator NSError -domain -code Recovery Attempter
36. UIApplication UIViewController UIViewController willPresentError: willPresentError: willPresentError: STIErrorConfigurator willPresentError: STIErrorConfigurator STIErrorConfigurator NSError -domain -code Recovery Attempter
37. UIApplication UIViewController UIViewController willPresentError: willPresentError: willPresentError: STIErrorConfigurator willPresentError: STIErrorConfigurator STIErrorConfigurator NSError -domain -code Recovery Attempter
38. Abfangen
39. @interface UIResponder (STIErrorPresentation) - (BOOL)canInterceptError:(NSError *)error; - (void)interceptError:(NSError *)error completionHandler:(void (^)(BOOL didRecover))completionHandler; @end Error Domains nutzen
40. STIErrorHandling • Open Source • Fork von HRSCustomErrorHandling • Schlank • Optimal auch für kleine Projekte • https://github.com/iCarambaa/STIErrorHandling
41. Demo
42. Zusammenfassung • Jeder Error der auftreten kann, tritt auch auf • Informationen aus NSError nutzen • Responder Chain kann den Fluss übernehmen • Besonders in kleinen Projekten eine einfache Lösung
43. Q&A • Error erstellen • Responder Chain • Error-Präsentation • Error Configurator @s_titgemeyer • STIErrorHandling • Swift