转载

Swift 语言面面观（一）

原文链接 : Good Swift, Bad Swift — Part 1
原文作者 : Kristian Andersen
译文出自 : 掘金翻译计划
译者 : 达仔
校对者: Nicolas(Yifei) Li 、 Jack King

Swift 语言面面观（一）

在 WWDC 2014（苹果 2014 年开发者大会）发布的 Swift 编程语言，大约在一周内将迎来它的两周岁生日（译注：WWDC 2014 的时间是 2014-6-3）。当时听到这个消息，我们在工作室里兴奋地跳了起来，并从此投入到了 Swift 的怀抱。然而两年时间过去了，我依然在苦苦思索着怎样写出好的 Swift 代码。要知道 Objective-C 已经快有三十年历史了，我们都已经摸索出 Objective-C 的最佳实践，以及什么是好或坏的 Objective-C 代码，然而 Swift 还很年轻。

在这一系列的文章里，我将尝试提炼出我认为的 Swift 语言中好与不好的部分。诚然我不是这方面的专家，我只是希望抛砖引玉，分享我对这个问题的思考，并激励其它开发者（没错就是你）表达自己的见解。如果你对此有任何想法、批评，或者对于好代码的看法，可以在原文下面留言，或者在 Twitter 上联系我。

让我们进入正题。

使用枚举类型（Enums）避免代码中的字符串输入错误

我早已无法数清我有多少次犯下了同一种错误：花费大量时间在寻找字符串拼写错误导致的各种各样的古怪 bug。枚举类型除了可以帮你节省调试时间外，还可以减少字符输入的时间，因为 XCode 的代码补全功能会推荐定义好的枚举值。

在使用 NSURLSession 的每个项目里，我都包含了下面的代码片段：

enum HTTPMethod: String {     case GET = "GET"     case POST = "POST"     case PUT = "PUT"     case DELETE = "DELETE }

这是一个非常简单的枚举，我知道大部分的开发者可能都不屑于这么做。然而基于上述原因，我确实是这么使用的。

更新： Tobias Due Munk 指出，你甚至不需要把和键名相同的值字符串写出来，Swift 有更简化的语法。你只需要这样写：

enum HTTPMethod: String { case GET, POST, PUT, DELETE }

使用访问控制关键词限制内容可访问性

稍等一会儿，还记得 public, private, internal 这都是什么鬼吗？为什么会有一种 Java 既视感？就跟大部分 CS（计算机科学）专业毕业生一样，我也写过 Java 代码，可是我不喜欢这门语言及其生态系统。然而，尽管我不喜欢它，但不得不承认这门语言有着一些明智的设计。如果你正在为其他开发者提供 API，而他们不清楚代码的输入输出，此时你就会明白定义完善且文档清晰的 API 的重要性了。因此，合理地添加权限控制关键词到 API 方法中，可以帮助你的用户更好地理解你的 API “表面积”，并寻找到他们想要调用的接口。当然，你也可以写文档来解释应该使用哪些方法，哪些应该保留下来，但是为什么不通过添加关键词来强制实行呢？

让我感到吃惊的是，我曾经和不少开发者聊过，他们并不喜欢添加权限控制关键词。其实对于 iOS/OS X 开发者而言，权限控制的概念并不新鲜。在 Objective-C 中，我们就把“公有的”接口放在 .h 文件中，而把“私有的”接口放在 .m 文件中。

在写 Swift 代码的过程中，我总是遵循“最严格的”原则，在一开始尽可能先把所有类、结构、枚举以及函数设成私有。如果之后我发现需要一个函数暴露在类外，我才会尝试降低这个限制。通过遵循这一原则，我可以实现最小化 API “表面积”，方便其他开发者调用。

使用泛型避免 UIKit 模板代码

自从 Swift 出现以后，我就一直在代码逻辑中完全实现 view 和 view controller。作为曾经的 Storyboard 重度用户的我，现在发现把所有的属于视图的代码放在一个地方，比起分开放在 XML 文件和几行逻辑代码更加实用。

在编写了大量 view 和 view controller 代码之后，我遇到了一个难题。因为我更喜欢 auto layout，所以我偏向于不使用参数初始化视图（init:frame 是指定构造器）。如果你在 Swift 中，对于任何的 UIKit 类指定一个无参数的构造函数，你就不得不指定一个 init:coder 构造器。这很烦人，为了避免每次创建视图都写这段模板代码，我创建了一个 “泛型视图类（Generic View Class）” ，让所有视图继承这个类而无需继承 UIView。

public class GenericView: UIView {     public required init() {         super.init(frame: CGRect.zero)         configureView()     }          public required init?(coder: NSCoder) {         super.init(coder: coder)         configureView()     }    internal func configureView() {} }

这个类同时也表达出我的另一个编程习惯：创建一个 “configureView” 方法，把所有配置视图的操作，包括添加子视图、约束、调整颜色、字体等，全都放到这个方法中。这样的话，无论什么时候创建视图，我都不需要再写一遍上述的模板代码了。

class AwesomeView: GenericView {     override func configureView() {         ....     } }let awesomeView = AwesomeView()

当你把这个模式配合泛型 view controller 一起使用，效果更佳。

public class GenericViewController&lt;View: GenericView&gt;: UIViewController {     internal var contentView: View {         return view as! View     }     public init() {         super.init(nibName: nil, bundle: nil)     }     public required init?(coder: NSCoder)         super.init(coder: coder)     }     public override func loadView() {         view = View()     } }

现在要给视图创建 view controller 更加简单了。

class AwesomeViewController: GenericViewController&lt;AwesomeView&gt; {     override func viewDidLoad()         super.viewDidLoad()         ....     } }