iOS 开发中的设计模式下
在这个由两部分组成的教程中,你将了解构建 iOS 应用程序的常见设计模式,以及如何在自己的应用程序中应用这些模式。
更新说明:本教程已由译者针对 iOS 12,Xcode 10 和 Swift 4.2 进行了更新。原帖由教程团队成员 Eli Ganem 发布。
欢迎回到 iOS 设计模式的入门教程第二部分!在 第一部分 中,你已经了解了 Cocoa 中的一些基本模式,比如 MVC、单例和装饰模式。
在最后一部分中,你将了解 iOS 和 OS X 开发中出现的其他基本设计模式:适配器、观察者和备忘录。让我们现在就开始吧!
入门
你可以下载 第一部分最结尾处的项目 来开始。
这是你在第一部分结尾处留下的音乐库应用程序:
该应用程序的原计划包括了屏幕顶部用来在专辑之间切换的 scrollView。但是与其编写一个只有单个用途的 scrollView,为何不让它变得可以给其他任何 view 复用呢?
要使此 scrollView 可复用,跟其内容有关的所有决策都应留给其他两个对象:它的数据源和代理。为了使用 scrollView,应该给它声明数据源和代理实现的方法,这就类似于 UITableView
的代理方法工作方式。当我们接下来一边讨论下一个设计模式时,你也将一边着手实现它。
适配器模式
适配器允许和具有不兼容接口的类一起工作,它将自身包裹在一个对象内,并公开一个标准接口来与该对象进行交互。
如果你熟悉适配器模式,那么你会注意到 Apple 以一种稍微不同的方式实现它,那就是协议。你可能熟悉 UITableViewDelegate
,UIScrollViewDelegate
,NSCoding
和 NSCopying
等协议。例如使用 NSCopying
协议,任何类都可以提供一个标准的 copy
方法。
如何使用适配器模式
之前提到的 scrollView 如下图所示:
我们现在来实现它吧,右击项目导航栏中的 View 组,选择 New File > iOS > Cocoa Touch Class,然后单击 Next,将类名设置为 HorizontalScrollerView
并继承自 UIView
。
打开 HorizontalScrollerView.swift 并在 HorizontalScroller
类声明的 上方 插入以下代码:
|
|
这定义了一个名为 HorizontalScrollerViewDataSource
的协议,它执行两个操作:请求在 scrollView 内显示 view 的个数以及应为特定索引显示的 view。
在此协议定义的下方再添加另一个名为 HorizontalScrollerViewDelegate
的协议。
|
|
这将使 scrollView 通知某个其他对象它内部的一个 view 已经被选中。
注意:将关注区域划分为不同的协议会使代码看起来更加清晰。通过这种方式你可以决定遵循特定的协议,并避免使用 @objc
来声明可选的协议方法。
在 HorizontalScrollerView.swift 中,将以下代码添加到 HorizontalScrollerView
类的定义里:
|
|
代理和数据源都是可选项,因此你不一定要给他们赋值,但你在此处设置的任何对象都必须遵循相应的协议。
在类里继续添加以下代码:
|
|
每条注释的详解如下:
- 定义一个私有的
enum
来使代码布局在设计时更易修改。scrollView 的内的 view 尺寸为 100 x 100,padding 为 10 - 创建包含多个 view 的 scrollView
- 创建一个包含所有专辑封面的数组
接下来你需要实现初始化器。添加以下方法:
|
|
这项工作是在 initializeScrollView()
中完成的。以下是详细分析:
- 添加子视图
UIScrollView
实例 - 关闭 autoresizingMask,这样你就可以使用自定义约束了
- 将约束应用于 scrollView,你希望 scrollView 完全填充
HorizontalScrollerView
- 创建 tap 手势。它会检测 scrollView 上的触摸事件并检查是否已经点击了专辑封面。如果是,它将通知
HorizontalScrollerView
的代理。在这里会有一个编译错误,因为 scrollerTapped(gesture:) 方法尚未实现,你接下来就要实现它了。
现在添加下面的方法:
|
|
此方法检索特定索引的 view 并使其居中。它将由以下方法调用(你也需要将此方法添加到类中):
|
|
此方法在 scrollView 中寻找点击的位置,如果存在的话它会查找包含该位置的第一个 contentView 的索引。
如果点击了 contentView,则通知代理并将此 view 滚动到中心位置。
接下来添加以下内容以从滚动器访问专辑封面:
|
|
view(at:)
只返回特定索引处的 view,稍后你将使用此方法突出显示你已点击的专辑封面。
现在添加以下代码来刷新 scrollView:
|
|
UITableView
中的 reload
方法会在 reloadData
之后建模,它将重新加载用于构造 scrollView 的所有数据。
每条注释对应的详解如下:
- 在执行任何 reload 之前检查数据源是否存在。
- 由于你要清除专辑封面,因此你还需要移除所有存在的 view。
- 所有 view 都从给定的偏移量开始定位。目前它是 100,但可以通过更改文件顶部的常量
ViewConstants.Offset
来轻松地做出调整。 - 向数据源请求 view 的个数,然后使用它来创建新的 contentView 数组。
HorizontalScrollerView
一次向一个 view 请求其数据源,并使用先前定义的填充将它们水平依次布局。- 所有 view 布局好之后,设置 scrollView 的偏移量来允许用户滚动浏览所有专辑封面。
当你的数据发生改变时调用 reload
方法。
HorizontalScrollerView
需要实现的最后一个功能是确保你正在查看的专辑始终位于 scrollView 的中心。为此,当用户用手指拖动 scrollView 时,你需要执行一些计算。
下面添加以下方法:
|
|
上面的代码考虑了 scrollView 的当前偏移量以及 view 的尺寸和填充以便计算当前view 与中心的距离。最后一行很重要:一旦 view 居中,就通知代理所选的 view 已变更。
要检测用户是否在 scrollView 内完成了拖动,你需要实现一些 UIScrollViewDelegate
的方法,将以下类扩展添加到文件的底部。记住一定要在主类声明的花括号 下面 添加!
|
|
scrollViewDidEndDragging(_:willDecelerate:)
在用户完成拖拽时通知代理,如果 scrollView 尚未完全停止,则 decelerate
为 true。当滚动结束时,系统调用scrollViewDidEndDecelerating(_:)
。在这两种情况下,你都应该调用新方法使当前视图居中,因为当用户拖动滚动视图后当前视图可能已更改。
最后不要忘记设置代理,将以下代码添加到 initializeScrollView()
的最开头:
|
|
你的 HorizontalScrollerView
已准备就绪!看一下你刚刚编写的代码,你会看到没有任何地方有出现 Album
或 AlbumView
类。这非常棒,因为这意味着新的 scrollView 真正实现了解耦并且可复用。
编译项目确保可以正常通过编译。
现在 HorizontalScrollerView
已经完成,是时候在你的应用程序中使用它了。首先打开 Main.storyboard。单击顶部的灰色矩形视图,然后单击 Identity Inspector。将类名更改为 HorizontalScrollerView
,如下图所示:
接下来打开 Assistant Editor 并从灰色矩形 view 拖线到 ViewController.swift 来创建一个 IBOutlet,并命名为 horizontalScrollerView,如下图所示:
接下来打开 ViewController.swift,是时候开始实现一些 HorizontalScrollerViewDelegate
方法了!
把下面的拓展添加到该文件的最底部:
|
|
这是在调用此代理方法时发生的事情:
- 首先你取到之前选择的专辑,然后取消选择专辑封面
- 存储刚刚点击的当前专辑封面的索引
- 取得当前所选的专辑封面并显示高亮状态
- 在 tableView 中显示新专辑的数据
接下来,是时候实现 HorizontalScrollerViewDataSource
了。在当前文件末尾添加以下代码:
|
|
正如你所看到的,numberOfViews(in:)
是返回 scrollView 中 view 的个数的协议方法。由于 scrollView 将显示所有专辑数据的封面,因此 count 就是专辑记录的数量。在 horizontalScrollerView(_:viewAt:)
里你创建一个新的 AlbumView
,如果它是所选的专辑,则高亮显示它,再将它传递给 HorizontalScrollerView
。
基本完成了!只用三个简短的方法就能显示出一个漂亮的 scrollView。你现在需要设置数据源和代理。在 viewDidLoad
中的 showDataForAlbum(at:)
之前添加以下代码:
|
|
编译并运行你的项目,就可以看到漂亮的水平滚动视图:
呃,等一下!水平滚动视图已就位,但专辑的封面在哪里呢?
噢,对了,你还没有实现下载封面的代码。为此,你需要添加下载图像的方法,而且你对服务器的全部访问请求都要通过一个所有新方法必经的一层 LibraryAPI
。但是,首先要考虑以下几点:
AlbumView
不应直接与LibraryAPI
产生联系,你不会希望将 view 里的逻辑与网络请求混合在一起的。- 出于同样的原因,
LibraryAPI
也不应该知道AlbumView
的存在。 - 当封面被下载完成,
LibraryAPI
需要通知AlbumView
来显示专辑。
是不是感觉听起来好像很难的样子?不要绝望,你将学习如何使用 观察者 模式来做到这点!
观察者模式
在观察者模式中,一个对象通知其他对象任何状态的更改,但是通知的涉及对象不需要相互关联,我们鼓励这种解耦的设计方式。这种模式最常用于在一个对象的属性发生更改时通知其他相关对象。
通常的实现是需要观察者监听另一个对象的状态。当状态发生改变时,所有观察对象都会被通知此次更改。
如果你坚持 MVC 的概念(也确实需要坚持),你需要允许 Model 对象与 View 对象进行通信,但是它们之间没有直接引用,这就是观察者模式的用武之地。
Cocoa 以两种方式实现了观察者模式:通知 和 键值监听(KVO)。
通知
不要与推送通知或本地通知混淆,观察者模式的通知基于订阅和发布模型,该模型允许对象(发布者)将消息发送到其他对象(订阅者或监听者),而且发布者永远不需要了解有关订阅者的任何信息。
Apple 会大量使用通知。例如,当显示或隐藏键盘时,系统分别发送 UIKeyboardWillShow
和 UIKeyboardWillHide
通知。当你的应用程序转入后台运行时,系统会发送一个 UIApplicationDidEnterBackground
通知。
如何使用通知
右击 RWBlueLibrary 并选择 New Group,然后命名为 Extension。再次右击该组,然后选择New File > iOS > Swift File,并将文件名设置为 NotificationExtension.swift。
把下面的代码拷贝到该文件中:
|
|
你正在使用自定义通知扩展的 Notification.Name
,从现在开始,新的通知可以像系统通知一样用 .BLDownloadImage
访问。
打开 AlbumView.swift 并将以下代码插入到 init(frame:coverUrl:)
方法的最后:
|
|
该行代码通过 NotificationCenter
的单例发送通知,通知信息包含要填充的 UIImageView
和要下载的专辑图像的 URL,这些是执行封面下载任务所需的所有信息。
将以下代码添加到 LibraryAPI.swift中的 init
方法来作为当前为空的初始化方法的实现:
|
|
这是通知这个等式的另一边–观察者,每次 AlbumView
发送 BLDownloadImage
通知时,由于 LibraryAPI
已注册成为该通知的观察者,系统会通知 LibraryAPI
,然后 LibraryAPI
响应并调用 downloadImage(with:)
。
在实现 downloadImage(with:)
之前,还有一件事要做。在本地保存下载的封面可能是个好主意,这样应用程序就不需要一遍又一遍地下载相同的封面了。
打开 PersistencyManager.swift,把 import Foundation
换成下面的代码:
|
|
此次 import 很重要,因为你将处理 UI
对象,比如 UIImage
。
把这个计算属性添加到该类的最后:
|
|
此变量返回缓存目录的 URL,它是一个存储了你可以随时重新下载的文件的好地方。
现在添加以下两个方法:
|
|
这段代码非常简单,下载的图像将保存在 Cache 目录中,如果在 Cache 目录中找不到匹配的文件,getImage(with:)
将返回 nil
。
现在打开 LibraryAPI.swift 并且将 import Foundation
改为 import UIKit
。
在类的最后添加以下方法:
|
|
以下是上面两个方法的详解:
downloadImage
是通过通知触发调用的,因此该方法接收通知对象作为参数。从通知传递来的对象取出UIImageView
和 image 的 URL。- 如果先前已下载过,则从
PersistencyManager
中检索 image。 - 如果尚未下载图像,则使用
HTTPClient
检索。 - 下载完成后,在 imageView 中显示图像,并使用
PersistencyManager
将其保存在本地。
再一次的,你使用外观模式隐藏了从其他类下载图像这一复杂的过程。通知发送者并不关心图像是来自网络下载还是来自本地的存储。
编译并运行你的应用程序,现在能看到 collectionView 中漂亮的封面:
停止你的应用并再次运行它。请注意加载封面没有延迟,这是因为它们已在本地保存了。你甚至可以断开与互联网的连接,应用程序仍将完美运行。然而这里有一个奇怪的地方,旋转加载的动画永远不会停止!这是怎么回事?
你在下载图像时开始了旋转动画,但是在下载图像后,你并没有实现停止加载动画的逻辑。你 本应该 在每次下载图像时发送通知,但是下面你将使用键值监听(KVO)来执行此操作。
键值监听(KVO)
在 KVO 中,对象可以监听一个特定属性的任何更改,要么是自己的属性,要么就是另一个对象的。如果你有兴趣,可以阅读 KVO 开发文档 中的更多关信息。
如何使用键值监听
如上所述,键值监听机制允许对象观察属性的变化。在你的案例中,你可以使用键值监听来监听显示图片的 UIImageView
里 image
属性的更改。
打开 AlbumView.swift 并在 private var indicatorView: UIActivityIndicatorView!
的声明下面添加以下属性:
|
|
在添加封面的 imageView 做为子视图之前,将以下代码添加到commonInit
:
|
|
这段代码将 imageView 做为封面图片的 image
属性的观察者。\.image
是一个启用此功能的 keyPath 表达式。
在 Swift 4 中,keyPath 表达式具有以下形式:
|
|
type 通常可以由编译器推断,但至少需要提供一个 property。在某些情况下,使用属性的属性可能是有意义的。在你现在的情况下,我们已指定属性名称 image
,而省略了类型名称 UIImageView
。
尾随闭包指定了在每次观察到的属性更改时执行的闭包。在上面的代码中,当 image
属性更改时,你要停止加载的旋转动画。这样做了之后,当图片加载完成,旋转动画就会停止。
编译并运行你的项目,加载中的旋转动画将会消失:
注意: 要始终记得在它们被销毁时删除你的观察者,否则当对象试图向这些不存在的观察者发送消息时,你的应用程序将崩溃!在这种情况下,当专辑视图被移除,valueObservation
将被销毁,因此监听将会停止。
如果你稍微使用一下你的应用然后就终止它,你会注意到你的应用状态并未保存。应用程序启动时,你查看的最后一张专辑将不是默认专辑。
要更正此问题,你可以使用之前列表中接下来的一个模式:备忘录。
备忘录模式
备忘录模式捕获并使对象的内部状态暴露出来。换句话讲,它可以在某处保存你的东西,稍后在不违反封装的原则下恢复此对外暴露的状态。也就是说,私有数据仍然是私有的。
如何使用备忘录模式
iOS 使用备忘录模式作为 状态恢复 的一部分。你可以通过阅读我们的 教程 来了解更多信息,但实质上它会存储并重新应用你的应用程序状态,以便用户回到上次操作的状态。
要在应用程序中激活状态恢复,请打开 Main.storyboard,选择 Navigation Controller,然后在 Identity Inspector 中找到 Restoration ID 字段并输入 NavigationController。
选择 Pop Music scene 并在刚才的位置输入 ViewController。这些 ID 会告诉系统,当应用重新启动时,你想要恢复这些 viewController 的状态。
在 AppDelegate.swift 中添加以下代码:
|
|
以下的代码会为你的应用程序打开状态作为一个整体来还原。现在,将以下代码添加到 ViewController.swift 中的 Constants
枚举中:
|
|
这个静态常量将用于保存和恢复当前专辑的索引,现在添加以下代码:
|
|
你将在这里保存索引(该操作在应用程序进入后台时进行)并恢复它(该操作在应用程序启动时加载完成 controller 中的 view 后进行)。还原索引后,更新 tableView 和 scrollView 以显示更新之后的选中状态。还有一件事要做,那就是你需要将 scrollView 滚动到正确的位置。如果你在此处滚动 scrollView,这样是行不通的,因为 view 尚未布局完毕。下面请在正确的地方添加代码让 scrollView 滚动到对应的 view:
|
|
编译并运行你的应用程序,点击其中一个专辑,然后按一下 Home 键使应用程序进入后台(如果你在模拟器上运行,则也可以按下 Command+Shift+H),再从 Xcode 上停止运行你的应用程序并重新启动,看一下之前选择的专辑是否到了中间的位置:
请看一下 PersistencyManager
中的 init
方法,你会注意到每次创建 PersistencyManager
时都会对专辑数据进行硬编码并重新创建。但其实更好的解决方案是一次性创建好专辑列表并将其存储在文件中。那你该如何将 Album
的数据保存到文件中呢?
方案之一是遍历 Album
的属性并将它们保存到 plist 文件,然后在需要时重新创建 Album
实例,但这并不是最佳的,因为它要求你根据每个类中的数据或属性编写特定代码,如果你以后创建了具有不同属性的 Movie
类,则保存和加载该数据都将需要重写新的代码。
此外,你将无法为每个类实例保存私有变量,因为外部类并不难访问它们,这就是为什么 Apple 要创建 归档和序列化 机制。
归档和序列化
Apple 的备忘录模式的一个专门实现方法是通过归档和序列化。在 Swift 4 之前,为了序列化和保存你的自定义类型,你必须经过许多步骤。对于 类
来说,你需要继承自 NSObject
并遵行 NSCoding
协议。
但是像 结构体
和 枚举
这样的值类型就需要一个可以扩展 NSObject
并遵行 NSCoding
的子对象了。
Swift 4 为 类
,结构体
和 枚举
这三种类型解决了这个问题:[SE-0166]。
如何使用归档和序列化
打开 Album.swift 并让 Album
遵行 Codable
。这个协议可以让 Swift 中的类同时遵行 Encodable
和 Decodable
。如果所有属性都是可 Codable
的,则协议的实现由编译器自动生成。
你的代码现在看起来会像这样:
|
|
要对对象进行编码,你需要使用 encoder。打开 PersistencyManager.swift 并添加以下代码:
|
|
就像使用 caches
一样,你将在此定义一个 URL 用来保存文件目录,它是一个存储文件名路径的常量,然后就是将你的专辑数据写入文件的方法,事实上你并不用编写很多的代码!
该方案的另一部分是将数据解码回具体对象。你现在需要替换掉创建专辑并从文件中加载它们的很长一段的那个方法。下载并解压 此JSON文件 并将其添加到你的项目中。
现在用以下代码替换 PersistencyManager.swift 中的 init
方法体:
|
|
现在你正在从 documents 目录下的文件中加载专辑数据(如果存在的话)。如果它不存在,则从先前添加的启动文件中加载它,然后就立即保存,那么下次启动时它将会位于文档目录中。JSONDecoder
非常智能,你只需告诉它你希望文件包含的类型,它就会为你完成剩下的所有工作!
你可能还希望每次应用进入后台时保存专辑数据,我将把这一部分作为一个挑战让你亲自弄明白其中的原理,你在这两个教程中学到的一些模式还有技术将会派上用场!
接下来该干嘛?
你可以 在此 下载最终项目。
在本教程中你了解了如何利用 iOS 设计模式的强大功能来以很直接的方式执行复杂的任务。你已经学习了很多 iOS 设计模式和概念:单例,MVC,代理,协议,外观,观察者和备忘录。
你的最终代码将会是耦合度低、可重用并且易读的。如果其他开发者阅读你的代码,他们将能够很轻松地了解每行代码的功能以及每个类在你的应用中的作用。
其中的关键点是不要为你了使用设计模式而使用它。然而在考虑如何解决特定问题时,请留意设计模式,尤其是在设计应用程序的早期阶段。它们将使作为开发者的你生活变得更加轻松,代码同时也会更好!
关于该文章主题的一本经典书籍是 Design Patterns: Elements of Reusable Object-Oriented Software。有关代码示例,请查看 GitHub 上一个非常棒的项目 Design Patterns: Elements of Reusable Object-Oriented Software 来取更多在 Swift 中编程中的设计模式。
最后请务必查看 Swift 设计模式进阶 和我们的视频课程 iOS Design Patterns 来了解更多设计模式!
如果发现译文存在错误或其他需要改进的地方,欢迎到 掘金翻译计划 对译文进行修改并 PR,也可获得相应奖励积分。文章开头的 本文永久链接 即为本文在 GitHub 上的 MarkDown 链接。