UIStoryboard:和枚举、协议扩展、泛型一起使用更安全

作者:Andyy Hope,原文链接,原文日期:2016-01-24
译者:jseanj;校对:saitjr;定稿:CMB

几周前,我无意发现 Guille Gonzalez 写的一篇文章,介绍了如何用协议和扩展让 UITableViewCell 的注册和重用更安全。

看完这篇文章后我非常惊叹,因为不需要依赖继承,只需要协议扩展和泛型就可以非常容易的实现自定义的行为。自从 WWDC15,我们已经听到关于 Swift 如何是一门面向协议的语言,而我只是一知半解,如果你懂我的意思的话。而就在此时我终于明白他们在讲的是什么了。

在我花费大量时间做的应用中有一个大的 storyboard,使用起来令人难以置信的繁琐,所以我最后决定将它分离开。将一个巨大的 UIStoryboard 分成众多小的 UIStoryboard,然后我只需要在我的代码中用不同的字符串去实例化 UIStoryboard,但是这样从来不安全。

字符串

你留在家中的无声杀手

let name = "News"
let storyboard = UIStoryboard(name: name, bundle: nil)
let identifier = "ArticleViewController"
let viewController = storyboard.instantiateViewControllerWithIdentifier(identifier) as! ArticleViewController

上面的代码中,我们创建了一个名称为 “News” 的 UIStoryboard 实例,这会在工程资源目录下找名称为 “News.storyboard” 的文件。但是,如果有一个更复杂的名称比如 “Onomatopoeia”,由于这个词非常奇怪并且不寻常,导致我为了文章的书写必须查查怎么拼写这个词。可以想象,在工程代码中如果我要不停的去猜如何拼写类似的词,这将是非常愚蠢的,但实际上人们就是在做着疯狂的事情。

不知道怎么拼写就算了,更糟的是由于它是一个字符串,Xcode 的语法检查器并不会检测出来拼写错误,因此你只能在运行时才可能发现这种错误。唉!

如何才能让 UIStoryboard 更安全

全局字符串常量

不,永远不。刚开始这听起来是一个好想法,因为你只需要定义一次常量就可以在任何地方使用。如果你想改变常量的值,只需要更改一处就可以让工程中所有使用该常量的地方发生变化。

但是这样你会少了一个变量名,你会对经常要重用一个变量名而感到惊讶。你曾经尝试过给一个 NSObject 的子类的属性命名为 “description” 吗?这时你就知道我的意思了。如果 storyboards 使用多个字符串常量标识符的话,就会丧失一致性,如果它们定义在工程中的不同地方,也会使查找和合并它们变得更困难。

定义一个全局字符串常量还有诸多坏处,但是为了继续讨论文章中要提到的精华,所以我们将会忽略这些坏处。

关联的 Storyboard 名称

首要原则是你的 storyboard 应该以它包含的模块命名。例如,如果一个 storyboard 包含的控制器是关于新闻的,那么就把 storyboard 文件命名为 “News.storyboard”。

统一 Storyboard 标识符

当你打算在你的控制器上使用 Storyboard 标识符时,通常的做法是使用类名作为标识符。比如 “ArticleViewController” 作为 ArticleViewController 的标识符。这将会减少你和同事们的负担,你和你的同事们不必再去想和记忆统一标识符或者命名规范。

枚举

可以考虑将枚举作为统一的、中心全局化的 UIStoryboard 字符串标识符。为了让 storyboard 实例化对象变得真正的安全,我们可以创建一个 UIStoryboard 类的扩展,其中定义了工程中不同的 storyboard 文件。

extension UIStoryboard {
    enum Storyboard : String {
        case Main
        case News
        case Gallery
    }
}

正如你所见,所有的内容在工程中都是统一并且中心化的。实例化也更加安全,当你敲击标识符时 Xcode 也会自动补全。

let storyboard = UIStoryboard(name: UIStoryboard.Storyboard.News.rawValue, bundle: nil)

这段代码可以顺畅的编译并运行,但是语法却很丑陋。因此我们再深入地简化一下语法,在 UIStoryboard 扩展中创建一个便利构造方法:

convenience init(storyboard: Storyboard, bundle: NSBundle? = nil) {
    self.init(name: storyboard.rawValue, bundle: bundle)
}
...
let storyboard = UIStoryboard(storyboard: .News)

你将会注意到,bundle: 参数默认是 nil,因此在调用构造方法时可以忽略 bundle: 参数。

这样做的原因是如果你传 nil 给 bundle 参数,UIStroyboard 类会去 main bundle 中查找资源,所以给 bundle 参数传 nil 和传 NSBundle.mainBundle() 是一样的,就像苹果文档中说的:

bundle 中包含了 storyboard 文件和相关的资源文件,如果你传 nil,这个方法会去当前应用的 main bundle 中查找。
—— UIStoryboard Class Reference

和创建便利构造方法等价的是创建一个 UIStoryboard 类方法,该类方法返回 UIStoryboard 实例。

class func storyboard(storyboard: Storyboard, bundle: NSBundle? = nil) -> UIStoryboard {
    return UIStoryboard(name: storyboard.rawValue, bundle: bundle)
}
...
let storyboard = UIStoryboard.storyboard(.News)

无论是创建便利构造方法还是类方法,结果都是一样的。唯一的差别是语法形式上的个人喜好,我个人认为类方法更好一些,因此我会在自己的代码中使用它们。无论你选择哪种方式,确保在你的工程中保持一致就可以了。

好的,让我们加大马力来看看在文章开头中吸引你的那些东西。

协议扩展和泛型

通常工程中不会有那么多的 storyboard 文件,即使我们有 20 个 storyboard 文件,我们也可以使用上面的方法来很好的维护它们。另一方面,控制器完全就是另一回事了。在我工作的 Xcode 工程中快速的搜索一下,我发现目前使用了超过 100 个不同的 UIViewController 子类。这是一个难题。

let storyboard = UIStoryboard.storyboard(.News)
let identifier = "ArticleViewController"
let viewController = storyboard.instantiateViewControllerWithIdentifier(identifier) as! ArticleViewController

现在我们不仅要管理代码中的 storyboard 标识符和 Interface Builder,还要处理各种各样的类型转换,因为这个方法只返回 UIViewController:

func instantiateViewControllerWithIdentifier(_ identifier: String) -> UIViewController

由于我们有如此多的 UIViewController 子类,所以之前在 UIStoryboard 中使用的枚举方式会比字符串标识符更好一些,但是这种方式管理这么多控制器仍显笨拙。

StoryboardIdentifiable 协议

protocol StoryboardIdentifiable {
    static var storyboardIdentifier: String { get }
}

我们创建一个任何类都可以遵循的协议,协议中有一个静态变量 storyboardIdentifier。这将会减少我们管理控制器标识符的工作量。

StoryboardIdentifiable 协议扩展

extension StoryboardIdentifiable where Self: UIViewController {
    static var storyboardIdentifier: String {
        return String(self)
    }
}

在我们的协议扩展声明中,where 子句表示该扩展只适用于 UIViewController 或者它的子类。像 NSDate 这样的类就不会获取到 storyboardIdentifier 协议变量。

在协议扩展中,我们提供了一个在运行时动态获取 storyboardIdentifier 字符串的方法。

我最近才发现 Swift 字符串有这样的功能,这要感谢 NatashaTheRobot文章。这个比 Objective-C 的 NSStringFromClass() 更好,这里是原因。(译者注:同时,翻译组也翻译了 Natasha 的这篇文章,详见:《优雅的 NSStringFromClass 替代方案》

let classString = String(ArticleViewController)
print(classString) 
// prints: ArticleViewController

StoryboardIdentifiable 全局一致性

extension UIViewController : StoryboardIdentifiable { }

现在我们让工程中的每个 UIViewController 都遵循 StoryboardIdentifiable 协议。这种方式减轻了工作量,使得我们不用更新每个 UIViewController 来遵循该协议,同时也不需要记住在创建新的 UIViewController 类时让它遵循该协议。

class ArticleViewController : UIViewController { }
...
print(ArticleViewController.storyboardIdentifier)
// prints: ArticleViewController

带有泛型的 UIStoryboard 扩展

func instantiateViewController<T: UIViewController where T: StoryboardIdentifiable>() -> T

我们摆脱了使用 storyboard 字符串标识符从 storyboard 中创建控制器,取而代之的是一种更新更安全的方式:

extension UIStoryboard {
    func instantiateViewController<T: UIViewController where T: StoryboardIdentifiable>() -> T {
        let optionalViewController = self.instantiateViewControllerWithIdentifier(T.storyboardIdentifier)

        guard let viewController = optionalViewController as? T  else {
            fatalError(“Couldn’t instantiate view controller with identifier \(T.storyboardIdentifier) “)
        }

        return viewController
    }
}

这里我们使用泛型,它只允许我们传入的类是 UIViewController 或者是 UIViewController 的子类,而且在泛型声明中有一个 where 子句,它限制了这些类也需要遵循 StoryboardIdentifiable 协议。

如果我们尝试传入一个 NSObject 对象,Xcode 会编译不过。或者我们传入一个 UIViewController 但是不遵循 StoryboardIdentifiable 协议的对象,Xcode 也不会编译通过。这已经足够安全。

<T: UIViewController where T: StoryboardIdentifiable>() -> T

Yo! 这些奇怪的语法是什么?

通常泛型使用 “T” 作为参数名称,然而你可以在尖括号里的第一次声明时替换成任何你想要的名称。如果我们想换,我们可以将 T 重命名为一个更易读的名称 “VC” 或者 “ViewController”:

<VC: UIViewController where VC: StoryboardIdentifiable>() -> VC

无论你使用哪个名称,必须在声明和方法体中保持一致。但是对于这个例子,我们会坚持用 T,因为你会在其他的代码和例子中发现这是 Swift 的传统。

关于 Swift 泛型的更多内容可以到官方文档中查看

回到刚刚打断的地方:

let optionalViewController = self.instantiateViewControllerWithIdentifier(T.storyboardIdentifier)

我们调用原始的 UIStoryboard 的 instantiateViewControllerWithIdentifier 方法,并传递 storyboardIdentifier 变量作为参数,方法返回的是一个可选类型的 UIViewController。

guard let 
    viewController = optionalViewController as? T 
else {
    fatalError(“Couldn’t instantiate view controller with identifier \(T.storyboardIdentifier) “)
}
return viewController

我们尝试对可选类型的 UIViewController 对象进行解包,并转换成传入的类型。如果由于某种原因控制器不存在,fatalError 方法会被调用,同时控制台会在调试模式时通知你,因此这些错误不会在发布版本中发生。

最后,我们返回类型是 T 的解包过的 viewController

实践

class ArticleViewController : UIViewController
{ 
    func printHeadline() { }
}
...
let storyboard = UIStoryboard.storyboard(.News)
let viewController: ArticleViewController = storyboard.instantiateViewController()
viewController.printHeadline()
presentViewController(viewController, animated: true, completion: nil)

这就是全部,我们摆脱了丑陋的,不安全的字符串标识符,取而代之的是枚举、协议扩展和泛型。

而且,我们可以通过 UIStoryboard 方法实例化一个特殊类型的控制器对象,并且不需要类型转换就可以执行特殊的操作。这难道不是你一天当中看到的最棒的事情吗?

更新

感谢 Raifura AndreiKyle Davis 的反馈,我已经更新了文章和示例代码,简化了语法同时提高了可读性。Github 和 Gists 也同步更新了。享受吧。

本文的示例代码可以在 Github 上找到。

本文由 SwiftGG 翻译组翻译,已经获得作者翻译授权,最新文章请访问 http://swift.gg

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,482评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,377评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,762评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,273评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,289评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,046评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,351评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,988评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,476评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,948评论 2 324
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,064评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,712评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,261评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,264评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,486评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,511评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,802评论 2 345

推荐阅读更多精彩内容

  • 1.自定义控件 a.继承某个控件 b.重写initWithFrame方法可以设置一些它的属性 c.在layouts...
    圍繞的城阅读 3,349评论 2 4
  • importUIKit classViewController:UITabBarController{ enumD...
    明哥_Young阅读 3,776评论 1 10
  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 10,869评论 6 13
  • 问题一:没有统一的、中心全局化的 UIStoryboard 字符串标识符 使用枚举 问题二:需要处理标示符和进行类...
    coderzcj阅读 1,135评论 0 0
  • 找不到的存在,浪费不起的青春,留不住的大城市,回不去的家乡,沿途的风景虽好,偶尔也请你回头,向身后的那个人挥挥手!
    吾五二五阅读 177评论 0 0