翻译:JaceFu ChildhoodAndy

校正:LunaticM ChildhoodAndy

采用Cocoa设计模式


本页包含内容:

使用 Cocoa 现有的一些设计模式,是帮助开发者开发一款拥有合理设计思路、稳定的性能、良好的可扩展性应用的有效方法之一。这些模式都依赖于在 Objective-C 中定义的类。因为 Swift 与 Objective-C 的互用性,所以你依然可以在 Swift 代码中使用这些设计模式。在一些情况下,你甚至可以使用 Swift 语言的特性扩展或简化这些 Cocoa 设计模式,使这些设计模式更强大、更易于使用。

委托

在 Swift 和 Objective-C 中,委托通常由一个定义交互方法和遵循规范的委托属性的协议表示。与 Objective-C 相比,当你在 Swift 中继承一个委托时,虽然继承模式不变,但是内部的实现已经改变了。就像在 Objective-C 中,在你向委托发送消息之前,不管它是不是 nil 你都会去查看,如果定义的方法是非必须实现的方法,不管委托有没有实现这个方法,你也都会去查看。而在 Swift 中,通过保持类型安全的特性,可以有效的消除这些繁琐、不必要的行为问题。

下面列出的代码可以说明这个过程:

  1. 检查 myDelegate 不为 nil
  2. 检查 myDelegate 是否实现了继承的 window:willUseFullScreenContentSize: 方法。
  3. 如果myDelegate 不为 nil 并且实现了 window:willUseFullScreenContentSize: 方法,那么调用该方法,将该方法的返回值分配给名为 fullScreenSize 的属性。
  4. 将该方法的返回值输出在控制台。
  1. // @inteface MyObject : NSObject
  2. // @property (nonatomic, weak) id<NSWindowDelegate> delegate;
  3. // @end
  4. if let fullScreenSize = myDelegate?.window?(myWindow, willUseFullScreenContentSize: mySize) {
  5. println(NSStringFromSize(fullScreenSize))
  6. }

注意: 在一个完全使用 Swift 编写的 app 中,在定义 delegate 属性时,它作为一个不定值的 NSWindowDelegate 对象,并将初始值设为 nil

错误处理

在 Cocoa 中,产生错误的方法将NSError指针参数作为最后一个参数,当错误产生时,该参数会被NSError对象填充。Swift 自动的将 Objective-C 中产生错误的方法转换为 Swift 的原生错误处理功能。

注意

产生错误的方法,例如代理方法或者采用一个NSError对象作为参数的完成处理函数,不会被 Swift 处理为throw的方法。

例如,考虑下面的来自于NSFileManager的 Objective-C 方法:

  1. - (BOOL)removeItemAtURL:(NSURL *)URL
  2. error:(NSError **)error;

在 Swift 中,它会被这样的导入:

  1. func removeItemAtURL(URL: NSURL) throws

注意到removeItemAtURL(_:)方法被 Swift 导入时,返回值类型为 Void,没有错误参数,而是一个throws声明。

如果 Objective-C 方法的最后一个非闭包参数是NSError **类型,Swift 则会将之替换为throws关键字,以表明该方法可以抛出一个错误。如果 Objective-C 方法的错误参数也是它的第一个参数,Swift 则会尝试通过删除选择器的第一部分中的AndReturnError后缀来进一步简化方法的名称,如果存在的话。如果另一种方法是用所得选择器声明的,那么该方法名将不可改变。

如果产生错误的 Objective-C 的方法返回一个用来表示方法调用成功或失败的BOOL值,Swift 会把函数的返回值转换为Void。同样的,如果产生错误的 Objective-C 方法返回一个nil值来表明方法调用的失败,Swift 会把函数的返回值转换为非可选值类型。

否则,如果没有约定可以推断,该方法保持不变。

捕获和处理错误

在 Objective-C 中,错误处理是可选的,意味着方法产生的错误会被忽略除非你提供了一个错误指针。在 Swift 中,调用一个会抛出错误的方法要求显示的进行错误处理。

下面是如何在 Objective-C 中处理调用方法产生的错误:

  1. NSFileManager *fileManager = [NSFileManager defaultManager];
  2. NSURL *URL = [NSURL fileURLWithPath:@"/path/to/file"];
  3. NSError *error = nil;
  4. BOOL success = [fileManager removeItemAtURL:URL error:&error];
  5. if (!success && error) {
  6. NSLog(@"Error: %@", error.domain);
  7. }

下面是 Swift 中等同的代码:

  1. let fileManager = NSFileManager.defaultManager()
  2. let URL = NSURL.fileURLWithPath("/path/to/file")
  3. do {
  4. try fileManager.removeItemAtURL(URL)
  5. } catch let error as NSError {
  6. print("Error: \(error.domain)")
  7. }

抛出错误

如果一个错误出现在了 Objective-C 方法中,那么该错误被用来填充方法的错误指针参数。

  1. // an error occurred
  2. if (errorPtr) {
  3. *errorPtr = [NSError errorWithDomain:NSURLErrorDomain
  4. code:NSURLErrorCannotOpenFile
  5. userInfo:nil];
  6. }

如果一个错误出现在了 Swift 方法中,那么该错误便会被抛出,并且会自动的传递给调用者:

  1. // an error occurred
  2. throw NSError(domain: NSURLErrorDomain, code: NSURLErrorCannotOpenFile, userInfo: nil)

如果 Objective-C 代码调用 Swift 方法抛出了错误,那么该错误会被自动的传递给桥接的 Objective-C 方法的错误指针参数。

例如,考虑NSDocument中的readFromFileWrapper(_:ofType:)方法。在 Objective-C 中,这个方法的最后一个参数是NSError **。当在 Swift 的NSDocument的子类中重写该方法时,该方法会用throws替代错误指针参数。

  1. class SerializedDocument: NSDocument {
  2. static let ErrorDomain = "com.example.error.serialized-document"
  3. var representedObject: [String: AnyObject] = [:]
  4. override func readFromFileWrapper(fileWrapper: NSFileWrapper, ofType typeName: String) throws {
  5. guard let data = fileWrapper.regularFileContents else {
  6. throw NSError(domain: NSURLErrorDomain, code: NSURLErrorCannotOpenFile, userInfo: nil)
  7. }
  8. if case let JSON as [String: AnyObject] = try NSJSONSerialization.JSONObjectWithData(data, options: []) {
  9. self.representedObject = JSON
  10. } else {
  11. throw NSError(domain: SerializedDocument.ErrorDomain, code: -1, userInfo: nil)
  12. }
  13. }
  14. }

如果方法不能够使用常规的文件的内容来创建一个对象,则会抛出一个NSError对象。如果方法是从 Swift 代码中调用的,那么该错误会被传递到它的调用域。如果该方法是在 Objective-C 代码中被调用,错误将会传递到错误指针参数里。

在 Objective-C 中,错误处理是可选的,意味着方法产生的错误会被忽略除非你提供了一个错误指针。在 Swift 中,调用一个会抛出错误的方法要求显式的进行错误处理。

注意

尽管 Swift 的错误处理类似 Objective-C 的异常处理,但它是完全独立的功能。如果一个 Objective-C 方法抛出了一个运行时异常,Swift 则会触发一个运行时错误。没有办法直接在 Swift 中恢复来自 Objective-C 的异常。任何在 Objective-C 代码中的异常处理行为必须用 Swift 来实现。

键值观察

键值观察是一种机制,该机制允许对象获得其他对象的特定属性的变化的通知。只要你的类继承自 NSObject 类,你便可在 Swift 类里使用键值观察。你可以在 Swift 中使用下面三步来实现键值观察:

  1. 为你想要观察的属性添加动态修改符。关于dynamic更多信息,请见Requiring Dynamic Dispatch
  1. class MyObjectToObserve: NSObject {
  2. dynamic var myDate = NSDate()
  3. func updateDate() {
  4. myDate = NSDate()
  5. }
  6. }
  1. 创建一个全局上下文变量。
  1. private var myContext = 0
  1. 为键-路径增加一个观察者,重写observeValueForKeyPath:ofObject:change:context:函数,并且在deinit中移除观察者。
  1. class MyObserver: NSObject {
  2. var objectToObserve = MyObjectToObserve()
  3. override init() {
  4. super.init()
  5. objectToObserve.addObserver(self, forKeyPath: "myDate", options: .New, context: &myContext)
  6. }
  7. override func observeValueForKeyPath(keyPath: String?, ofObject object: AnyObject?, change: [NSObject : AnyObject]?, context: UnsafeMutablePointer<Void>) {
  8. if context == &myContext {
  9. if let newValue = change?[NSKeyValueChangeNewKey] {
  10. print("Date changed: \(newValue)")
  11. }
  12. } else {
  13. super.observeValueForKeyPath(keyPath, ofObject: object, change: change, context: context)
  14. }
  15. }
  16. deinit {
  17. objectToObserve.removeObserver(self, forKeyPath: "myDate", context: &myContext)
  18. }
  19. }

Target-Action模式(Target-Action)

当有特定事件发生,需要一个对象向另一个对象发送消息时,我们通常采用 Cocoa 的 Target-Action 设计模式。Swift 和 Objective-C 中的 Target-Action 模型基本类似。在 Swift 中,你可以使用 Selector 类型达到 Objective-C 中 selectors 的效果。请在 Objective-C Selectors 中查看在 Swift 中使用 Target-Action 设计模式的示例。

类型匹配与统一规范(Introspection)

在 Objective-C 中,你可以使用 isKindOfClass: 方法检查某个对象是否是指定类型,可以使用 conformsToProtocol: 方法检查某个对象是否遵循特定协议的规范。在 Swift 中,你可以使用 is 运算符完成上述的功能,或者也可以使用 as? 向下匹配指定类型。

你可以使用 is 运算符检查一个实例是否是指定的子类。如果该实例是指定的子类,那么 is 运算结果为 true,反之为 false

  1. if object is UIButton {
  2. // object is of type UIButton
  3. } else {
  4. // object is not of type UIButton
  5. }

你也可以使用 as? 运算符尝试向下匹配子类型,as? 运算符返回不定值,结合 if-let 语句使用。

  1. if let button = object as? UIButton {
  2. // object is successfully cast to type UIButton and bound to button
  3. } else {
  4. // object could not be cast to type UIButton
  5. }

请在 Type Casting 中查看更多信息。

检查匹配协议的语法与检查匹配类的语法是一样的,下面是使用 as? 检查匹配协议的示例:

  1. if let dataSource = object as? UITableViewDataSource {
  2. // object conforms to UITableViewDataSource and is bound to dataSource
  3. } else {
  4. // object not conform to UITableViewDataSource
  5. }

注意,当做完匹配之后,dataSource 会转换为 UITableViewDataSource 类型,所以你只能访问和调用UITableViewDataSource 协议定义的属性和方法。当你想进行其他操作时,必须将其转换为其他的类型。
可以在 Protocols 查看更多相关信息。

API 可用性

一些类和方法并不是在你的应用所有平台的所有版本都可用。为了确保你的应用功能上能够适应差异,你需要检查这些 API 的可用性。

在 Objective-C 中,我们使用respondsToSelector:instancesRespondToSelector:方法来检查一个类或者实例方法是否可用。如果没有检查,调用方法则会抛出NSInvalidArgumentException“unrecognized selector sent to instance”异常。例如,requestWhenInUseAuthorization方法只在 iOS8.0 和 OS X 10.10 中对CLLocationManager实例可用。

  1. if ([CLLocationManager instancesRespondToSelector:@selector(requestWhenInUseAuthorization)]) {
  2. // 方法可用
  3. } else {
  4. // 方法不可用
  5. }

在 Swift 中,尝试着调用一个目标平台版本不支持的方法将会报出编译时错误。

下面是上一个例子,采用 Swift 编写:

  1. let locationManager = CLLocationManager()
  2. locationManager.requestWhenInUseAuthorization()
  3. // error: only available on iOS 8.0 or newer

如果应用的目标低于 ios8.0 或者 OSX10.10,requestWhenInUseAuthorization()方法则不可用,所以编译器会报告错误。

Swift 代码可以使用 API 可用性来作为运行时的条件判断。可用性检查可以使用在一个控制流语句的条件中,例如if,guard或者while语句。

拿前面的例子举例,你可以使用if语句来检查可用性,只有当方法在运行时可用时方可调用requestWhenInUseAuthorization()

  1. let locationManager = CLLocationManager()
  2. if #available(iOS 8.0, OSX 10.10, *) {
  3. locationManager.requestWhenInUseAuthorization()
  4. }

或者,你可以使用guard语句来检查可用性,除非当前的目标符合规定要求,否则将会退出作用域。这种方法简化了处理不同平台功能的逻辑。

  1. let locationManager = CLLocationManager()
  2. guard #available(iOS 8.0, OSX 10.10, *) else { return }
  3. locationManager.requestWhenInUseAuthorization()

每个平台参数包括下面列出的平台名称,后面跟着相应的版本号。最后一个参数是一个星号(*),是用来处理未来潜在的平台。

平台名称:

  • iOS
  • iOSApplicationExtension
  • OSX
  • OSXApplicationExtension
  • watchOS

所有的 Cocoa API 都提供有可用性信息,所以你可以很自信的编写应用所针对的平台的代码。

你可以通过 @available 属性来标注声明从而简化你的 API 的可用性检查。@available 属性使用和 #available 同样的语法来做运行时检查,参数都以逗号隔开平台版本需求。

例如:

  1. @available(iOS 8.0, OSX 10.10, *)
  2. func useShinyNewFeature() {
  3. // ...
  4. }

注意

使用 @available 属性标记的方法可以安全的使用满足特定平台需求的可用 API 而不用显式的做可用性检查。