译者：@没故事的卓同学
将翻译几篇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和响应事件链
-
Key-value observing (KVO)
因为这些不同的机制能够用一种相同的方式处理，可以很容易的声明成链（chain）并且把它们联合在一起，用更少的代码和状态连接它们。
更多关于RAC里的概念可以查看Framework Overview.
例子：在线搜索
假设你有一个text field，每当用户输入文字时，你都会发起一个网络请求根据输入的关键字查询。
实时观察文字变化
实现这个目的的第一步，使用RAC中UITextField的一个扩展方法：
|
1
2
3
|
let searchStrings = textField.rac_textSignal()
.toSignalProducer()
.map { text
in
text as! String }
|
这样产生了一个signal producer来发送输入的字符串。( text as! String这种类型映射在当前是必需的，为了从OC桥接当前的扩展方法）
发送网络请求
获得了每次输入的字符串，我们想要发送一个网络请求。RAC也为我们提供了NSURLSession的一个扩展方法来实现：
|
1
2
3
4
5
6
7
8
|
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后才执行（对于返回结果没有被使用时做的优化）。这个很简单：
|
1
2
3
|
searchResults.startWithNext {
results
in
print(
"Search results: (results)"
)
}
|
我们获取值用于Next中的event：包含了请求结果，并且把他们log到了控制台。这里也可以写其他UI控制的代码，比如reload一个table view。
失败处理
到目前为止，这个例子中，任何的网络错误都会产生一个Failed event,这会导致整个事件流终止。不幸的是，这意味着之后请求不会被发起。
为了避免这样的情况，我们需要决定当失败发生时怎样处理。最快速的解决方案就是记录它们，然后忽略它们：
|
1
2
3
4
5
6
7
8
9
|
.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会像这样：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
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操作符可以用于实现这个需求：
|
1
2
3
4
|
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的区别越来越大.
