译自raywenderlich, 原标题: Cocoa Bindings on macOS, 作者Andy Pereira
macOS 值绑定, 也就是Cocoa binding, 让你不用浪费时间写那些枯燥的代码. 在使用 MVC 模式时, 它会在控制器中自动连接模型与视图.
Cocoa Bindings的目标就是尽可能少的编写代码, 你实际使用过后就会发现, 真好用!!
在这篇关于教程中, 你将学习编写一个 Mac App, 它使用 iTunes API 在 App Store 搜索iOS App并展示出来.
你会学习使用 Cocoa Binding 来做这些事情:

• 在 Interface Builder 中设置数据模型和 UI (如label, button)之间的关系
• 设置某个默认值
• 应用特定的数据格式, 如货币或日期格式
• 更改数据结构, 例如: 将值转换为某个颜色

开始吧

虽然门槛很低, 但是在你还是需要先学会如何使用 Auto Layout 与 Interface Builder.
如果你已经会这两个工具了, 在这里下载我们创建好的基础项目.
编译运行, 你会看到它已经有一个基本的界面了, 但目前为止只是个空壳, 还没有任何数据.

你可以看到有几个写好的 Swift文件

1. iTunesRequestManager.swift 这个文件里面有一个结构体, 结构体有两个静态方法. 第一个方法将查询发送到iTunes API, 会返回JSON格式搜索结果, 第二个是用于异步下载图片的辅助方法.
2. iTunesResults.swift, 定义了一个与iTunes的返回数据相匹配的数据模型类.

注意: ** Result类中的所有变量都定义为dynamic. 这是因为绑定依赖于键值编码, 需要Objective-C运行时, 添加dynamic关键字可确保始终可用.
该类继承自NSObject**, 这也是绑定的要求. 当你将一个变量添加到视图控制器类时, 你就知道为什么了.

使用 ITunes 搜索

首先, 你将通过iTunes API搜索, 并将结果添加到NSArrayController中.
打开 Main.storyboard 并查看 View Controller Scene中的对象. 你需要设置绑定的对象都有一个"(Bind)"标记.

设置 NSArrayController

NSArrayController对象管理NSTableView的内容, 通常采用模型对象数组的形式.

注意: NSArrayController提供的不仅仅是一个简单的数组, 包括管理对象的分节, 排序和过滤.

打开Main.storyboard. 在对象库中找到一个NSArrayController对象, 并将其拖动到文档大纲中的视图控制器场景分组下的对象列表中:

接下来, 打开assistant editor, 确保正在编辑的文件是ViewController.swift. 按住control键, 从 storyboard 中的Array Controller对象拖动到ViewController.swift, 为其添加一个outlet, 命名为searchResultsController:

添加搜索按钮事件

现在, 你可以使用搜索按钮获取搜索结果, 然后添加到searchResultsController里面.
按住control, 从storyboard中的搜索按钮拖动到ViewController.swift创建一个事件处理方法. 选择创建一个Action并将其命名为searchClicked.

为searchClicked 添加以下代码

//1
if (searchTextField.stringValue == "") {
  return
}
//2
guard let resultsNumber = Int(numberResultsComboBox.stringValue) else { return }
//3
iTunesRequestManager.getSearchResults(searchTextField.stringValue,
  results: resultsNumber,
  langString: "en_us") { results, error in
    //4
    let itunesResults = results.map { return Result(dictionary: $0) }
 
    //Deal with rank here later  
 
    //5
    DispatchQueue.main.async {
      //6
      self.searchResultsController.content = itunesResults
      print(self.searchResultsController.content)
  }
}

下面来一行一行分析代码:

1. 检查文本字段; 如果它是空的, 就不要将该查询发送到iTunes搜索API了.
2. 获取下拉列表中的值. 这个数字传递用于控制每一页要返回多少个搜索结果. 下拉列表中有一些预设值, 也可以手动输入其他数字, 最多为200
3. 调用 getSearchResults(_:results:langString:completionHandler:). 传入每页数量和搜索字符串. completionHandler 会返回结果或NSError.
4. 这一行将 Dictionary 数组转换为 Result 数组.
5. 在你searchResultsController之前, 需要确保处于主线程. 可以使用DispatchQueue.main.async在主队列执行代码. 虽然目前还没有设置任何绑定, 但如果一旦有了, searchResultsController在当前线程将同步更新NSTableView(和其他相关的UI 控件), 有一点需要记住就是更新 UI 必须在主线程操作.
6. 最后, 设置 NSArrayController 的 content 属性. NSArrayController有许多不同的方法来添加或删除它管理的对象. 我们每次搜索的时候, 都需要清除以前的数据, 并使用最新查询的结果. 现在, 打印searchResultsController的内容, 看看是否工作正常.
   最后, 添加一个ViewController的扩展:

extension ViewController: NSTextFieldDelegate {
  func control(_ control: NSControl, textView: NSTextView, doCommandBy commandSelector: Selector) -> Bool {
    if commandSelector == #selector(insertNewline(_:)) {
      searchClicked(searchTextField)
    }
    return false
  }
}

这段代码会让在用户在输入的时候中按回车键调用, 就像你点击了搜索按钮一样.
编译运行, 在搜索栏中输入flappy, 然后按回车键或单击搜索按钮. 你应该在控制台中看到以下内容:

你的第一个绑定

来点干货!
将NSArrayController绑定到table view.
打开Main.storyboard并选择标题为"Search Results Table View (Bind)"的table view. 打开Bindings Inspector, 如下图所示.
展开"Table Contents"标题下的"Content"选项. 选中"Bind to"旁边的复选框, 在右侧的下拉框中选择SearchResultsController, Controller Key设置为arrangedObjects

现在, 你需要将Result用户选择的对象绑定到UI的其余部分.