ReactiveCocoa是响应式编程(FRP)在iOS中的一个实现框架。
监听对象的成员变量变化
这种情况其实就是ios KVO机制使用的场景，使用KVO实现，通常有三个步骤：1，给对象的成员变量添加监听；2，实现监听回调；3，取消监听；而通过RAC可以直接实现，RAC的回调是通过block实现的，类似于过程式编程，上下文也更容易理解一些。
信号
作为一个iOS开发者，你写的每一行代码几乎都是在相应某个事件，例如按钮的点击，收到网络消息，属性的变化（通过KVO）或者用户位置的变化（通过CoreLocation）。但是这些事件都用不同的方式来处理，比如action、delegate、KVO、callback等。ReactiveCocoa为事件定义了一个标准接口，从而可以使用一些基本工具来更容易的连接、过滤和组合。
RAC为应用中发生的不同事件流提供了一个标准接口。在ReactiveCocoa术语中这个叫做信号（signal），由RACSignal类表示。
RACSignal
RAC中的基本类型。各个方法操作的都是RACSignal这种信号类型，而这种信号类型中可以封装各种Object类型。
- 控件的信号
//textField
RACSignal *usernameSourceSignal =
self.usernameTextField.rac_textSignal;
//button
RACSignal *buttonSignal = [self.addButton rac_signalForControlEvents:UIControlEventTouchUpInside];
- RAC方法的返回值
RACSignal *filteredUsername =[usernameSourceSignal
filter:^BOOL(id value){
NSString*text = value;
return text.length > 3;
}];
简单监听单一变量
RACObserve与subscribeNext
使用RACObserve来监听变量，产生信号，使用subscribeNext订阅该信号，对其进行回调处理。
注意：是最后一步的回调处理，所以不再返回信号，也不能后续对信号进行操作处理。
- 场景：当前类有一个成员变量 NSString *input，当它的值被改变时，发送一个请求。
实现：
[RACObserve(self, input)
subscribeNext:^(NSString* x){
request(x);//发送一个请求
}];
每次input值被修改时，就会调用此block，并且把修改后的值做为参数传进来。
doNext
doNext类似于subscribeNext。只不过doNext是直接跟在事件后，通常block没有返回值，切block参数也不作处理，只是简单的附加操作，并不改变事件本身。
- 场景：点击按钮的同时把相关属性置为YES
- 实现：
[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
doNext:^(id x){
self.signInButton.enabled =NO;
self.signInFailureText.hidden =YES;
}]
控件信号
使用rac_textSignal来返回text变化量，替代textField代理
- 场景：上面场景是监听自己的成员变量，如果想监听UITextField输入值变化，框架也做了封装可以代替系统回调
实现：
[[self.priceInput.rac_textSignal
filter:^(NSString *str) {
if (str.integerValue > 20) {
return YES;
} else {
return NO;
}
}]
subscribeNext:^(NSString *str) {
request(x);//发送一个请求
}
使用rac_signalForControlEvents来添加点击事件，替代addTarget
- 场景：按钮添加点击事件
实现：
[[button rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(id x) {
@strongify(self);
if (self.addDeviceBlock) {
self.addDeviceBlock();
}
}];
filter
使用filter对信号进行筛选过滤，通过返回的BOOL值过滤信号，表示经过filter筛选后的信号，和原信号类型一致。
- 场景：在上面场景中，当用户输入的值以2开头时，才发请求.
实现：
[[RACObserve(self, input)
filter:^(NSString* value){
if ([value hasPrefix:@"2"]) {
return YES;
} else {
return NO;
}
}]
subscribeNext:^(NSString* x){
request(x);//发送一个请求
}];
注意：
虽然filter内部返回的是BOOL类型，但是只用于过滤源信号，过滤后的值为2开头的字符串，仍为字符串。
RAC()
RAC宏允许直接把信号的输出应用到对象的属性上。RAC宏有两个参数，第一个是需要设置属性值的对象，第二个是属性名。每次信号产生一个next事件，传递过来的值都会应用到该属性上。
- 场景：使用RAC宏替代在subscribeNext中赋值
实现：
[[validPasswordSignal
map:^id(NSNumber *passwordValid){
return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
}]
subscribeNext:^(UIColor *color){
self.passwordTextField.backgroundColor = color;
}];
//替换为
RAC(self.usernameTextField, backgroundColor) = [validPasswordSignal
map:^id(NSNumber *passwordValid){
return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
}];
map
使用map对信号进行转换处理，改变信号内类型，可以多次使用，为最常使用的方法。
- 场景：根据用户名输入是否可用来改变密码输入框背景色
实现：
RAC(self.pwdInputField, backgroundColor) =
[[self.userNameInputField.rac_textSignal
map:^id(NSString *text) {
return @([self isValidPassword:text]);
}] map:^id(NSNumber *passwordValid) {
return[passwordValid boolValue] ? [UIColor clearColor]:[UIColor yellowColor];
}];
先使用map对输入值是否可用进行判断，返回NSNumber类型结果，再对该结果进行判断，返回UIColor类型，为真时使用透明色，不为真时使用黄色提示用户。
flattenMap
当信号中包含信号时，使用flattenMap，作用类似于map。
flattenMap:^id(id x){
return[self signInSignal];
}]
其中signInSiganal方法返回的是racSignal类型。
同时监听多个变量变化
combineLatest，reduce
使用RACSignal combineLatest方法同时监听多个变量，参数为信号数组。使用RACObserve()将Object包装成信号类型，或者使用控件的rac_textSignal属性来返回信号。
使用reduce来处理多个监听信号的返回量，以信号形式返回任意对象类型，可用subscribeNext进行下一步处理，也可直接赋予RAC宏中对象的属性上。
- 场景：button监听 两个输入框有值和一个成员变量值，当输入框均有输入且成员变量为真时，button为可点击状态
实现：
RAC(self.payButton,enabled) = [RACSignal
combineLatest:@[self.priceInput.rac_textSignal,
self.nameInput.rac_textSignal,
RACObserve(self, isConnected)
]
reduce:^(NSString *price, NSString *name, NSNumber *connect){
return @(price.length > 0 && name.length > 0 && [connect boolValue]);
}];
- 场景：满足上面条件时，直接发送请求
实现：
[[RACSignal combineLatest:@[self.priceInput.rac_textSignal,
self.nameInput.rac_textSignal,
RACObserve(self, isConnected)
]
reduce:^(NSString *price, NSString *name, NSNumber *connect){
return @(price.length > 0 && name.length > 0 && ![connect boolValue]);
}]
subscribeNext:^(NSNumber *res){
if ([res boolValue]) {
NSLog(@"XXXXX send request");
}
}];
- 场景：两个变量其中一个改变时更新label，或者由两个变量共同作用同一个label
实现1：
[[RACSignal combineLatest:@[RACObserve(device, config.className), RACObserve(device, cloudDevice.name) ]
reduce:^(NSString *className, NSString *name){
return [NSString stringWithFormat:@"%@%@",className,[name substringFromIndex:name.length - 4]];
}]
subscribeNext:^(NSString *text){
self.deviceNameLabel.text = text;
}];
实现2：
RAC宏允许直接把信号的输出应用到对象的属性上。RAC宏有两个参数，第一个是需要设置属性值的对象，第二个是属性名。每次信号产生一个next事件，传递过来的值都会应用到该属性上。
RAC(self.deviceNameLabel,text) = [RACSignal combineLatest:@[RACObserve(device,config.className), RACObserve(device, cloudDevice.name) ]
reduce:^(NSString *className, NSString *name){
return [NSString stringWithFormat:@"%@%@",className,name];
}];
注意：上述两个实现方法均可。但要注意combineLatest里的数组元素是信号类型，要用RACObserve()来封装object;
实例
包含接口在内的登录操作，主体方法如下：
[[[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
doNext:^(id x){
self.signInButton.enabled =NO;
self.signInFailureText.hidden =YES;
}]
flattenMap:^id(id x){
return[self signInSignal];
}]
subscribeNext:^(NSNumber*signedIn){
self.signInButton.enabled =YES;
BOOL success =[signedIn boolValue];
self.signInFailureText.hidden = success;
if(success){
[self performSegueWithIdentifier:@"signInSuccess" sender:self];
}
}];
点击登录按钮后，利用doNext方法，附加设定登录按钮不可用，登录失败提示隐藏。
再使用flattenMap执行登录接口。
对于登录接口返回signedIn进行处理。重新设定登录按钮可用，根据signedIn设定失败提示是否隐藏，以及是否进行成功后的下一步处理。
其中signInSignal方法如下：
- (RACSignal *)signInSignal {
return [RACSignal createSignal:^RACDisposable *(id subscriber){
[self.signInService
signInWithUsername:self.usernameTextField.text
password:self.passwordTextField.text
complete:^(BOOL success){
[subscriber sendNext:@(success)];
[subscriber sendCompleted];
}];
return nil;
}];
}
使用RACSignal的createSignal:方法来创建信号。方法的入参是一个block，这个block描述了这个信号。当这个信号有subscriber时，block里的代码就会执行。
block的入参是一个subscriber实例，它遵循RACSubscriber协议，协议里有一些方法来产生事件，你可以发送任意数量的next事件，或者用error\complete事件来终止。本例中，信号发送了一个next事件来表示登录是否成功，随后是一个complete事件。
这个block的返回值是一个RACDisposable对象，它允许你在一个订阅被取消时执行一些清理工作。当前的信号不需要执行清理操作，所以返回nil就可以了。
实际上是将一个普通方法封装成信号类型的方法，便于主体方法内对此使用subscribeNext等信号处理方法进行后续处理。
终止RAC
在RAC中执行完某些操作后不再检测反复执行。
__block RACDisposable *handler = [RACObserve(self.device.currentcylinder.displayBoard, standby) subscribeNext:^(id x) {
if ([x boolValue]) {
self.device.currentcylinder.program = _cardLocalModel.program;
[self runGroupCommond];
[handler dispose];
}
}];
另一种写法：
RACSignal *backgroundColorSignal =
[self.searchText.rac_textSignal
map:^id(NSString *text) {
return [self isValidSearchText:text] ?
[UIColor whiteColor] : [UIColor yellowColor];
}];
RACDisposable *subscription =
[backgroundColorSignal
subscribeNext:^(UIColor *color) {
self.searchText.backgroundColor = color;
}];
// at some point in the future ...
[subscription dispose];
避免RAC中的循环引用
ReactiveCocoa框架包含了一个小诀窍，你可以使用它代替上百年的代码。添加下面的引用：
#import "RACEXTScope.h"
如下：
@weakify(self)
[[self.searchText.rac_textSignal
map:^id(NSString *text) {
return [self isValidSearchText:text] ?
[UIColor whiteColor] : [UIColor yellowColor];
}]
subscribeNext:^(UIColor *color) {
@strongify(self)
self.searchText.backgroundColor = color;
}];
可以把RACEXTScope.h放在全局头文件引用中。
完整使用代码
[[[[[[[self requestAccessToTwitterSignal]
then:^RACSignal *{
@strongify(self)
return self.searchText.rac_textSignal;
}]
filter:^BOOL(NSString *text) {
@strongify(self)
return [self isValidSearchText:text];
}]
throttle:0.5]
flattenMap:^RACStream *(NSString *text) {
@strongify(self)
return [self signalForSearchWithText:text];
}]
deliverOn:[RACScheduler mainThreadScheduler]]
subscribeNext:^(NSDictionary *jsonSearchResult) {
NSArray *statuses = jsonSearchResult[@"statuses"];
NSArray *tweets = [statuses linq_select:^id(id tweet) {
return [RWTweet tweetWithStatus:tweet];
}];
[self.resultsViewController displayTweets:tweets];
} error:^(NSError *error) {
NSLog(@"An error occurred: %@", error);
}];
requestAccessToTwitterSignal方法:
- (RACSignal *)requestAccessToTwitterSignal {
// 1 - define an error
NSError *accessError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorAccessDenied
userInfo:nil];
// 2 - create the signal
@weakify(self)
return [RACSignal createSignal:^RACDisposable *(id subscriber) {
// 3 - request access to twitter
@strongify(self)
[self.accountStore
requestAccessToAccountsWithType:self.twitterAccountType
options:nil
completion:^(BOOL granted, NSError *error) {
// 4 - handle the response
if (!granted) {
[subscriber sendError:accessError];
} else {
[subscriber sendNext:nil];
[subscriber sendCompleted];
}
}];
return nil;
}];
}
signalForSearchWithText方法：
- (RACSignal *)signalForSearchWithText:(NSString *)text {
// 1 - define the errors
NSError *noAccountsError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorNoTwitterAccounts
userInfo:nil];
NSError *invalidResponseError = [NSError errorWithDomain:RWTwitterInstantDomain
code:RWTwitterInstantErrorInvalidResponse
userInfo:nil];
// 2 - create the signal block
@weakify(self)
return [RACSignal createSignal:^RACDisposable *(id subscriber) {
@strongify(self);
// 3 - create the request
SLRequest *request = [self requestforTwitterSearchWithText:text];
// 4 - supply a twitter account
NSArray *twitterAccounts = [self.accountStore
accountsWithAccountType:self.twitterAccountType]; if (twitterAccounts.count == 0) {
[subscriber sendError:noAccountsError]; } else {
[request setAccount:[twitterAccounts lastObject]];
// 5 - perform the request
[request performRequestWithHandler: ^(NSData *responseData, NSHTTPURLResponse *urlResponse, NSError *error) {
if (urlResponse.statusCode == 200) {
// 6 - on success, parse the response
NSDictionary *timelineData =
[NSJSONSerialization JSONObjectWithData:responseData
options:NSJSONReadingAllowFragments
error:nil]; [subscriber sendNext:timelineData]; [subscriber sendCompleted]; }
else {
// 7 - send an error on failure
[subscriber sendError:invalidResponseError]; }
}]; }
return nil; }];}
signalForLoadingImage方法：
-(RACSignal *)signalForLoadingImage:(NSString *)imageUrl {
RACScheduler *scheduler = [RACScheduler
schedulerWithPriority:RACSchedulerPriorityBackground];
return [[RACSignal createSignal:^RACDisposable *(id subscriber) {
NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageUrl]];
UIImage *image = [UIImage imageWithData:data];
[subscriber sendNext:image];
[subscriber sendCompleted];
return nil;
}] subscribeOn:scheduler];
}