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

mciy042 5年前
   <p>几周前,我无意发现 <a href="/misc/goto?guid=4959717423501285712" rel="nofollow,noindex">Guille Gonzalez</a> 写的一篇 <a href="/misc/goto?guid=4959717423599817424" rel="nofollow,noindex">文章</a> ,介绍了如何用协议和扩展让 UITableViewCell 的注册和重用更安全。</p>    <p>看完这篇文章后我非常惊叹,因为不需要依赖继承,只需要协议扩展和泛型就可以非常容易的实现自定义的行为。自从 WWDC15,我们已经听到关于 Swift 如何是一门 <a href="/misc/goto?guid=4958988059330407818" rel="nofollow,noindex">面向协议的语言</a> ,而我只是一知半解,如果你懂我的意思的话。而就在此时我终于明白他们在讲的是什么了。</p>    <p>在我花费大量时间做的应用中有一个大的 storyboard,使用起来令人难以置信的繁琐,所以我最后决定将它分离开。将一个巨大的 UIStoryboard 分成众多小的 UIStoryboard,然后我只需要在我的代码中用不同的字符串去实例化 UIStoryboard,但是这样从来不安全。</p>    <h2><strong>字符串</strong></h2>    <h3><strong>你留在家中的无声杀手</strong></h3>    <pre>  <code class="language-objectivec">let name = "News"  let storyboard = UIStoryboard(name: name, bundle: nil)  let identifier = "ArticleViewController"  let viewController = storyboard.instantiateViewControllerWithIdentifier(identifier) as! ArticleViewController  </code></pre>    <p>上面的代码中,我们创建了一个名称为 “News” 的 UIStoryboard 实例,这会在工程资源目录下找名称为 “News.storyboard” 的文件。但是,如果有一个更复杂的名称比如 “Onomatopoeia” ,由于这个词非常奇怪并且不寻常,导致我为了文章的书写必须查查怎么拼写这个词。可以想象,在工程代码中如果我要不停的去猜如何拼写类似的词,这将是非常愚蠢的,但实际上人们就是在做着疯狂的事情。</p>    <p>不知道怎么拼写就算了,更糟的是由于它是一个字符串,Xcode 的语法检查器并不会检测出来拼写错误,因此你只能在运行时才可能发现这种错误。唉!</p>    <h2><strong>如何才能让 UIStoryboard 更安全</strong></h2>    <h3><strong>全局字符串常量</strong></h3>    <p>不,永远不。刚开始这听起来是一个好想法,因为你只需要定义一次常量就可以在任何地方使用。如果你想改变常量的值,只需要更改一处就可以让工程中所有使用该常量的地方发生变化。</p>    <p>但是这样你会少了一个变量名,你会对经常要重用一个变量名而感到惊讶。你曾经尝试过给一个 NSObject 的子类的属性命名为 “description” 吗?这时你就知道我的意思了。如果 storyboards 使用多个字符串常量标识符的话,就会丧失一致性,如果它们定义在工程中的不同地方,也会使查找和合并它们变得更困难。</p>    <p>定义一个全局字符串常量还有诸多坏处,但是为了继续讨论文章中要提到的精华,所以我们将会忽略这些坏处。</p>    <h3><strong>关联的 Storyboard 名称</strong></h3>    <p>首要原则是你的 storyboard 应该以它包含的模块命名。例如,如果一个 storyboard 包含的控制器是关于新闻的,那么就把 storyboard 文件命名为 “News.storyboard”。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/ae16dd2ba6e215b39ebf588786e2e1bf.png"></p>    <h3><strong>统一 Storyboard 标识符</strong></h3>    <p>当你打算在你的控制器上使用 Storyboard 标识符时,通常的做法是使用类名作为标识符。比如 “ArticleViewController” 作为 ArticleViewController 的标识符。这将会减少你和同事们的负担,你和你的同事们不必再去想和记忆统一标识符或者命名规范。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/f78c67dceb47ac3c3978828b8f3b42ca.png"></p>    <h3><strong>枚举</strong></h3>    <p>可以考虑将枚举作为统一的、中心全局化的 UIStoryboard 字符串标识符。为了让 storyboard 实例化对象变得真正的安全,我们可以创建一个 UIStoryboard 类的扩展,其中定义了工程中不同的 storyboard 文件。</p>    <pre>  <code class="language-objectivec">extension UIStoryboard {      enum Storyboard : String {          case Main          case News          case Gallery      }  }  </code></pre>    <p>正如你所见,所有的内容在工程中都是统一并且中心化的。实例化也更加安全,当你敲击标识符时 Xcode 也会自动补全。</p>    <pre>  <code class="language-objectivec">let storyboard = UIStoryboard(name: UIStoryboard.Storyboard.News.rawValue, bundle: nil)  </code></pre>    <p>这段代码可以顺畅的编译并运行,但是语法却很丑陋。因此我们再深入地简化一下语法,在 UIStoryboard 扩展中创建一个便利构造方法:</p>    <pre>  <code class="language-objectivec">convenience init(storyboard: Storyboard, bundle: NSBundle? = nil) {      self.init(name: storyboard.rawValue, bundle: bundle)  }  ...  let storyboard = UIStoryboard(storyboard: .News)  </code></pre>    <p>你将会注意到, <em>bundle:</em> 参数默认是 <em>nil</em> ,因此在调用构造方法时可以忽略 <em>bundle:</em> 参数。</p>    <p>这样做的原因是如果你传 <em>nil</em> 给 bundle 参数,UIStroyboard 类会去 main bundle 中查找资源,所以给 <em>bundle</em> 参数传 <em>nil</em> 和传 <em>NSBundle.mainBundle()</em> 是一样的,就像苹果文档中说的:</p>    <p>bundle 中包含了 storyboard 文件和相关的资源文件,如果你传 nil,这个方法会去当前应用的 main bundle 中查找。</p>    <p>和创建便利构造方法等价的是创建一个 UIStoryboard 类方法,该类方法返回 UIStoryboard 实例。</p>    <pre>  <code class="language-objectivec">class func storyboard(storyboard: Storyboard, bundle: NSBundle? = nil) -> UIStoryboard {      return UIStoryboard(name: storyboard.rawValue, bundle: bundle)  }  ...  let storyboard = UIStoryboard.storyboard(.News)  </code></pre>    <p>无论是创建便利构造方法还是类方法,结果都是一样的。唯一的差别是语法形式上的个人喜好,我个人认为类方法更好一些,因此我会在自己的代码中使用它们。无论你选择哪种方式,确保在你的工程中保持一致就可以了。</p>    <p>好的,让我们加大马力来看看在文章开头中吸引你的那些东西。</p>    <h2><strong>协议扩展和泛型</strong></h2>    <p>通常工程中不会有那么多的 storyboard 文件,即使我们有 20 个 storyboard 文件,我们也可以使用上面的方法来很好的维护它们。另一方面,控制器完全就是另一回事了。在我工作的 Xcode 工程中快速的搜索一下,我发现目前使用了超过 100 个不同的 UIViewController 子类。这是一个难题。</p>    <pre>  <code class="language-objectivec">let storyboard = UIStoryboard.storyboard(.News)  let identifier = "ArticleViewController"  let viewController = storyboard.instantiateViewControllerWithIdentifier(identifier) as! ArticleViewController  </code></pre>    <p>现在我们不仅要管理代码中的 storyboard 标识符和 Interface Builder,还要处理各种各样的类型转换,因为这个方法只返回 UIViewController:</p>    <pre>  <code class="language-objectivec">func instantiateViewControllerWithIdentifier(_ identifier: String) -> UIViewController  </code></pre>    <p>由于我们有如此多的 UIViewController 子类,所以之前在 UIStoryboard 中使用的枚举方式会比字符串标识符更好一些,但是这种方式管理这么多控制器仍显笨拙。</p>    <h3><strong>StoryboardIdentifiable 协议</strong></h3>    <pre>  <code class="language-objectivec">protocol StoryboardIdentifiable {      static var storyboardIdentifier: String { get }  }  </code></pre>    <p>我们创建一个任何类都可以遵循的协议,协议中有一个静态变量 storyboardIdentifier。这将会减少我们管理控制器标识符的工作量。</p>    <h3><strong>StoryboardIdentifiable 协议扩展</strong></h3>    <pre>  <code class="language-objectivec">extension StoryboardIdentifiable where Self: UIViewController {      static var storyboardIdentifier: String {          return String(self)      }  }  </code></pre>    <p>在我们的协议扩展声明中, <em>where</em> 子句表示该扩展只适用于 UIViewController 或者它的子类。像 NSDate 这样的类就不会获取到 <em>storyboardIdentifier</em> 协议变量。</p>    <p>在协议扩展中,我们提供了一个在运行时动态获取 <em>storyboardIdentifier</em> 字符串的方法。</p>    <p>我最近才发现 Swift 字符串有这样的功能,这要感谢 <a href="/misc/goto?guid=4958963567110295165" rel="nofollow,noindex">NatashaTheRobot</a> 的 <a href="/misc/goto?guid=4959717423737799098" rel="nofollow,noindex">文章</a> 。这个比 Objective-C 的 NSStringFromClass() 更好,这里是 <a href="/misc/goto?guid=4959717423820769594" rel="nofollow,noindex">原因</a> 。(译者注:同时,翻译组也翻译了 Natasha 的这篇文章,详见: <a href="/misc/goto?guid=4959717423904141661" rel="nofollow,noindex">《优雅的 NSStringFromClass 替代方案》</a> )</p>    <pre>  <code class="language-objectivec">let classString = String(ArticleViewController)  print(classString)   // prints: ArticleViewController  </code></pre>    <h3><strong>StoryboardIdentifiable 全局一致性</strong></h3>    <pre>  <code class="language-objectivec">extension UIViewController : StoryboardIdentifiable { }  </code></pre>    <p>现在我们让工程中的每个 UIViewController 都遵循 StoryboardIdentifiable 协议。这种方式减轻了工作量,使得我们不用更新每个 UIViewController 来遵循该协议,同时也不需要记住在创建新的 UIViewController 类时让它遵循该协议。</p>    <pre>  <code class="language-objectivec">class ArticleViewController : UIViewController { }  ...  print(ArticleViewController.storyboardIdentifier)  // prints: ArticleViewController  </code></pre>    <h3><strong>带有泛型的 UIStoryboard 扩展</strong></h3>    <pre>  <code class="language-objectivec">func instantiateViewController<T: UIViewController where T: StoryboardIdentifiable>() -> T  </code></pre>    <p>我们摆脱了使用 storyboard 字符串标识符从 storyboard 中创建控制器,取而代之的是一种更新更安全的方式:</p>    <pre>  <code class="language-objectivec">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      }  }  </code></pre>    <p>这里我们使用泛型,它只允许我们传入的类是 UIViewController 或者是 UIViewController 的子类,而且在泛型声明中有一个 where 子句,它限制了这些类也需要遵循 StoryboardIdentifiable 协议。</p>    <p>如果我们尝试传入一个 NSObject 对象,Xcode 会编译不过。或者我们传入一个 UIViewController 但是不遵循 StoryboardIdentifiable 协议的对象,Xcode 也不会编译通过。这已经足够安全。</p>    <pre>  <code class="language-objectivec"><T: UIViewController where T: StoryboardIdentifiable>() -> T  </code></pre>    <p>Yo! 这些奇怪的语法是什么?</p>    <p>通常泛型使用 <em>“T”</em> 作为参数名称,然而你可以在尖括号里的第一次声明时替换成任何你想要的名称。如果我们想换,我们可以将 <em>T</em> 重命名为一个更易读的名称 “VC” 或者 “ViewController”:</p>    <pre>  <code class="language-objectivec"><VC: UIViewController where VC: StoryboardIdentifiable>() -> VC  </code></pre>    <p>无论你使用哪个名称,必须在声明和方法体中保持一致。但是对于这个例子,我们会坚持用 <em>T</em> ,因为你会在其他的代码和例子中发现这是 Swift 的传统。</p>    <p>回到刚刚打断的地方:</p>    <pre>  <code class="language-objectivec">let optionalViewController = self.instantiateViewControllerWithIdentifier(T.storyboardIdentifier)  </code></pre>    <p>我们调用原始的 UIStoryboard 的 instantiateViewControllerWithIdentifier 方法,并传递 storyboardIdentifier 变量作为参数,方法返回的是一个可选类型的 UIViewController。</p>    <pre>  <code class="language-objectivec">guard let       viewController = optionalViewController as? T   else {      fatalError(“Couldn’t instantiate view controller with identifier \(T.storyboardIdentifier) “)  }  return viewController  </code></pre>    <p>我们尝试对可选类型的 UIViewController 对象进行解包,并转换成传入的类型。如果由于某种原因控制器不存在, <em>fatalError</em> 方法会被调用,同时控制台会在调试模式时通知你,因此这些错误不会在发布版本中发生。</p>    <p>最后,我们返回类型是 <em>T</em> 的解包过的 <em>viewController</em> 。</p>    <h2><strong>实践</strong></h2>    <pre>  <code class="language-objectivec">class ArticleViewController : UIViewController  {       func printHeadline() { }  }  ...  let storyboard = UIStoryboard.storyboard(.News)  let viewController: ArticleViewController = storyboard.instantiateViewController()  viewController.printHeadline()  presentViewController(viewController, animated: true, completion: nil)  </code></pre>    <p>这就是全部,我们摆脱了丑陋的,不安全的字符串标识符,取而代之的是枚举、协议扩展和泛型。</p>    <p>而且,我们可以通过 UIStoryboard 方法实例化一个特殊类型的控制器对象,并且不需要类型转换就可以执行特殊的操作。这难道不是你一天当中看到的最棒的事情吗?</p>    <p> </p>    <p> </p>    <p> </p>    <p>来自:http://swift.gg/2016/09/26/uistoryboard-safer-with-enums-protocol-extensions-and-generics/</p>    <p> </p>