打开UIDocument时如何显示错误消息

Question

我有一个基于文档的iOS应用程序，当它第一次打开文档时，主视图控制器会调用UIDocument.open。

document.open { success in
if success { ... set up UI ... }
else { ??? }
}

这里的问题是，如果success为false，则我无法访问该错误。在这种情况下，苹果的API通常会向回调传递一个可选的Error参数，但由于某些原因，它们在这里没有。

我在应用程序的UIDocument:子类中找到了可以覆盖的方法

override func handleError(_ error: Error, userInteractionPermitted: Bool) {

现在，在该方法中，我有Error，但我无法轻松访问名为document.open的视图控制器，我需要显示类似UIAlertController的内容来显示错误消息。这个handleError方法也是在非主线程上调用的。

看起来我需要通过传递实例或全局变量中的信息来进行协调。因为这似乎比苹果公司通常的设计更尴尬——我预计错误会出现在open的完成处理程序中，我想我可能遗漏了一些东西。

是否有其他推荐的方法来获取错误对象并向用户显示消息？

Answer 1

Rob，

如果你真的想"快速"，你可以实现一个闭包来做到这一点，而不需要静态/全局变量。

我将首先定义一个枚举，该枚举对UIDocument的API调用的成功和失败案例进行建模。通用的Result枚举是一种非常常见的方法。

enum Result<T> {
case failure(Error)
case success(T)
}

从那里，我将在您的类中定义一个可选的闭包，用于处理UIDocument.open 的结果

我要做的实现是这样的：

class DocumentManager: UIDocument {
var onAttemptedDocumentOpen: ((Result<Bool>) -> Void)?
func open(document: UIDocument){
document.open { result in
guard result else { return } // We only continue if the result is successful
// Check to make sure someone has set a function that will handle the outcome
if let onAttemptedDocumentOpen = self.onAttemptedDocumentOpen {
onAttemptedDocumentOpen(.success(result))
}
}
}
override func handleError(_ error: Error, userInteractionPermitted: Bool) {
// Check to make sure someone has set a function that will handle the outcome
if let onAttemptedDocumentOpen = self.onAttemptedDocumentOpen {
onAttemptedDocumentOpen(.failure(error))
}
}
}

然后我从任何一个类将使用DocumentManager，你会做这样的事情：

class SomeOtherClassThatUsesDocumentManager {
let documentManger = DocumentManager()
let someViewController = UIViewController()
func someFunction(){
documentManger.onAttemptedDocumentOpen = { (result) in
switch result {
case .failure(let error):
DispatchQueue.main.async {
showAlert(target: self.someViewController, title: error.localizedDescription)
}
case .success(_):
// Do something
return
}
}
}
}

额外的好处：这是我写的一个静态函数，用于在一些视图控制器上显示UIAlertController

/** Easily Create, Customize, and Present an UIAlertController on a UIViewController
- Parameters:
- target: The instance of a UIViewController that you would like to present tye UIAlertController upon.
- title: The `title` for the UIAlertController.
- message: Optional `message` field for the UIAlertController. nil by default
- style: The `preferredStyle` for the UIAlertController. UIAlertControllerStyle.alert by default
- actionList: A list of `UIAlertAction`. If no action is added, `[UIAlertAction(title: "OK", style: .default, handler: nil)]` will be added.
*/
func showAlert(target: UIViewController, title: String, message: String? = nil, style: UIAlertControllerStyle = .alert, actionList: [UIAlertAction] = [UIAlertAction(title: "OK", style: .default, handler: nil)] ) {
let alert = UIAlertController(title: title, message: message, preferredStyle: style)
for action in actionList {
alert.addAction(action)
}
// Check to see if the target viewController current is currently presenting a ViewController
if target.presentedViewController == nil {
target.present(alert, animated: true, completion: nil)
}
}