ReactiveCocoa 4 官方文档翻译

译者：@没故事的卓同学
将翻译几篇ReactiveCocoa的文档，这是第一篇。


ReactiveCocoa (RAC) 是一个Cocoa框架，受Functional Reactive Programming启发。它提供API合成变换（composing and transforming）随着时间改变的数据流。
兼容性
关于 RAC 4的文档是在Swift 2.1.x下使用。对于Swift 1.2的支持请看 RAC 3.
介绍
ReactiveCocoa来源于functional reactive programming(Input and Output)。
区别于使用不断变化修改的变量，RAC提供了“事件流”，通过 Signal 和SignalProducer 类型来表示, 它们随着时间发送值。
事件流统一了Cocoa用于事件和异步处理的常用模式，包括：
委托方法

回调blocks

通知

控件的actions和响应事件链

Futures and promises

Key-value observing (KVO)

因为这些不同的机制能够用一种相同的方式处理，可以很容易的声明成链（chain）并且把它们联合在一起，用更少的代码和状态连接它们。
更多关于RAC里的概念可以查看Framework Overview.
例子：在线搜索
假设你有一个text field，每当用户输入文字时，你都会发起一个网络请求根据输入的关键字查询。
实时观察文字变化
实现这个目的的第一步，使用RAC中UITextField的一个扩展方法：

let searchStrings = textField.rac_textSignal() 
.toSignalProducer() 
.map { text in text as! String }

这样产生了一个signal producer来发送输入的字符串。( text as! String这种类型映射在当前是必需的，为了从OC桥接当前的扩展方法）

发送网络请求
获得了每次输入的字符串，我们想要发送一个网络请求。RAC也为我们提供了NSURLSession的一个扩展方法来实现：

let searchResults = searchStrings
.flatMap(.Latest) { (query: String) -> SignalProducer in
  let URLRequest = self.searchRequestWithEscapedQuery(query)
  return NSURLSession.sharedSession().rac_dataWithRequest(URLRequest)}
.map { (data, URLResponse) -> String in
 let string = String(data: data, encoding: NSUTF8StringEncoding)!
 return self.parseJSONResultsFromString(string)}
.observeOn(UIScheduler())

这段代码将字符串的producer转换成了一组包含了搜索结果的producer，并且会在主线程中处理(由于UIScheduler的作用).。
另外这里的flatMap(.Latest)确保只有最后的一次搜索会被执行。
如果当一个请求还在处理中，此时用户输入新的字符，在发起新的请求之前会取消之前的请求。想想这些如果自己实现的需要写多少代码！

接收结果
这样实际上还没有执行，因为producers必须started后才执行（对于返回结果没有被使用时做的优化）。这个很简单：

searchResults.startWithNext {
 results in print("Search results: (results)")
}

我们获取值用于Next中的event：包含了请求结果，并且把他们log到了控制台。这里也可以写其他UI控制的代码，比如reload一个table view。

失败处理
到目前为止，这个例子中，任何的网络错误都会产生一个Failed event,这会导致整个事件流终止。不幸的是，这意味着之后请求不会被发起。
为了避免这样的情况，我们需要决定当失败发生时怎样处理。最快速的解决方案就是记录它们，然后忽略它们：

.flatMap(.Latest) { (query: String) -> SignalProducer in 
 let URLRequest = self.searchRequestWithEscapedQuery(query)
 return NSURLSession.sharedSession() 
   .rac_dataWithRequest(URLRequest) 
   .flatMapError { error in 
   print("Network error occurred: (error)")
   return SignalProducer.empty
 } 
}

通过将失败替换为空事件流，可以有效的忽略它们。
然而，在放弃前最好重试几次。在一次，使用retry可以方便的达到这个目的。
改进后的searchResults producer会像这样：

let searchResults = searchStrings 
  .flatMap(.Latest) { (query: String) -> SignalProducer in 
  let URLRequest = self.searchRequestWithEscapedQuery(query) 
  return NSURLSession.sharedSession() 
  .rac_dataWithRequest(URLRequest) 
  .retry(2) 
  .flatMapError { error in 
  print("Network error occurred: (error)") 
  return SignalProducer.empty } } 
  .map { (data, URLResponse) -> String in 
  let string = String(data: data, encoding: NSUTF8StringEncoding)! 
  return self.parseJSONResultsFromString(string) }
  .observeOn(UIScheduler())

降低请求频率
现在，我们假设你只希望在用户输入暂停时才发起请求以减少网络请求。
RAC通过throttle操作符可以用于实现这个需求：

let searchStrings = textField.rac_textSignal() 
  .toSignalProducer() 
  .map { text in text as! String } 
  .throttle(0.5, onScheduler: QueueScheduler.mainQueueScheduler)

这样当间隔小于0.5秒时值不会被发送出去，意味着用户必须停止编辑0.5秒后我们才会使用输入的字符串去搜索。
如果用自己实现这个功能，真是要写不少代码，而且还会影响代码的可读性。但是在RAC中，只需要一个操作符就可以方便将时间控制加入事件流。

Objective-C 和 Swift
虽然RAC是作为一个OC的框架开始的，但是从版本3.0开始，所有的主要特性开发都是基于Swift API。
RAC的Objective-C API和Swift API是完全分开的，但是有一个bridge可以将他们互相转换。这主要是为了兼容使用RAC的一些老项目，或者用于一些还没有被加入Swfit API的一些Cocoa扩展。
Objective-C API将继续存在，在可预计的未来将提供支持，但是不会有新的改进。关于使用这些API的信息可以参考：legacy documentation。
我们强烈建议所有的新项目采用Swift API。
ReactiveCocoa和Rx的关系
ReactiveCocoa 受了 Microsoft’s Reactive Extensions (Rx)库的不少影响。有很多对于Rx的实现，包括RxSwift,但是ReactiveCocoa无意于成为Rx的一个实现子集。
RAC和 Rx的区别,主要有以下一些：
更简洁的API

解决了令人困惑的常见问题

更贴近Cocoa的编程习惯

命名
在大部分Rx的版本中，流被称为Observables，对应于.NET中的Enumerable类型。
另外， Rx.NET大部分的操作符参考了LINQ，而LINQ是用于操作传统关系型数据库的，比如 Select和 Where。
RAC则最关注于匹配Swift的命名规范, 使用 map和 filter来替换select和where。其他的一些命名来源于Haskell或Elm（使用“signal”的始祖）。
Signals and Signal Producers (“hot” and “cold” observables)
Rx中的“hot”, “cold”, and “warm” observables (对应RAC中的事件流)很容易让人困惑。
对于这个部分和Typed errors的区别，因为在我翻译的iOS响应式编程：ReactiveCocoa vs RxSwift 选谁好中有更详细的对比说明，这里就不翻译了。
Typed errors
处理错误时方式
UI编程
很多人不知道Rx怎么用。即使用Rx进行UI的编程很常见，它有几个特性用于一些特别的场景。
RAC从ReactiveUI借鉴了很多，包括Actions的基础操作。
不像ReactiveUI不能直接将Rx改变的对于UI编程更友好，为了这个目的则进行了很多次的改动—即使这意味着和Rx的区别越来越大.