上一篇我们已经对RACSignal的大部分用法都概括了一遍,我们把它理解为一个信号,可以比较清晰的在脑海里想象出来,但是RACCommand相对就要难上一些了!
RACCommand创建
有两个方法可以创建,而且一般使用懒加载:
第一种
[RACCommand alloc]initWithSignalBlock:<#^RACSignal *(id input)signalBlock#>
第二种,带开关信号
[RACCommand alloc]initWithEnabled:<#(RACSignal *)#> signalBlock:<#^RACSignal *(id input)signalBlock#>
很显然,RACCommand的创建是离不开RACSignal的,如果对RACSignal都不了解,也就不用想运用起RACCommand来了.首先,我们看那个开关信号,它是个信号,值是@YES或@NO,YES才可以执行.后面的参数是个block,返回值也是个信号,参数input是执行命令源传过来的值,比如后面要讲的例子就是一个按钮.
执行RACCommand
上文中提到的input值是不是还是很迷惑呢,我们看看执行命令的方法就会了解了:
[viewModel.command execute:@"(id)input"];
为了直观我直接就给input传了个字符串@"(id)input",然后你在命令初始化的地方就能打印到这个值了.
命令执行的时候,信号必须[subscriber sendCompleted],否则命令就一直处于执行状态.我们可以监听执行状态:
[viewModel.command.executing subscribeNext:^(id x) {
if ([x boolValue]) {
NSLog(@"正在执行");
}else{
NSLog(@"没执行/执行完毕");
}
}];
理解(处理)命令
命令发出执行起来后,我们需要接收到命令中包含的信号,并处理之:
[viewModel.command.executionSignals subscribeNext:^(id x) {
// NSLog(@"===%@",x);//发现x是一个RACSignal(RACDynamicSignal)
// }];
executionSignals是个信号集,可能是完成信号,可能是错误信号,而错误信号需要另外接收:
[[viewModel.command.errors subscribeOn:[RACScheduler mainThreadScheduler]]map:^id(id value) {
return @"failed";
}];
这么多信号,我们大部分时候需要的是最新的,拿到最新信号的方法:
[viewModel.command.executionSignals.switchToLatest subscribeNext:^(id x) {
}error:^(NSError *error) {
}completed:^{
}];
举例说明
通过上面的概述我们能够创建一个RACCommand,并且执行起来,然后接收发出的信号,处理传过来的数据,但是实际上运用时还是有很多的弯弯绕不出来,下面通过一个实际的,典型的例子加深和梳理一下理解:
首先我们建个ViewModel类并且定义属性:
@property (nonatomic,copy) NSString *text1;
@property (nonatomic,copy) NSString *text2;
@property (nonatomic,copy) NSString *text3;
@property(nonatomic, strong) RACSignal *enableSignal;
@property(nonatomic, strong) RACCommand *btnCommand;
RAC对按钮有个特别偏心的地方就是直接给他创建了一个RACCommand,并且当你点击时自动执行,甚至把RACCommand的Enabled信号和按钮的enabled属性绑定起来,难道UIButton才是RACCommand的灵感来源?
言归正传,我们需要在.m中使用懒加载创建RACCommand:
//RACCommand的懒加载
- (RACCommand *)btnCommand{
if (!_btnCommand) {
_btnCommand = [[RACCommand alloc]initWithEnabled:self.enableSignal signalBlock:^RACSignal *(id input) {
NSLog(@"input = %@",input);
return [ViewModel doSomething];
}];
}
return _btnCommand;
}
+ (RACSignal *)doSomething{
return [RACSignal createSignal:^RACDisposable *(id subscriber) {
[subscriber sendNext:@"点击按钮总得干点什么"];
NSError *e = [[NSError alloc]initWithDomain:@"domain" code:110 userInfo:nil];
[subscriber sendError:e];
[subscriber sendCompleted];
return nil;
}];
}
然后我们在ViewModel的init方法中实现订阅他的信号:
- (void)setupViewModel{
// [self.btnCommand.executionSignals subscribeNext:^(id x) {
// NSLog(@"===%@",x);//发现x是一个RACSignal(RACDynamicSignal)
// }];
//1.实际运用中这个可以用来强制传值
//转为字符串信号
RACSignal *strSignal = [self.btnCommand.executionSignals map:^id(id value) {
return @"我是一个RACSignal变身而来的字符串";
}];
RAC(self,text1) = strSignal;
//2.实际运用中这个可以用来success,如果你监听RACEventTypeNext,就能得到参数,但是不能的到error
RACSignal *strSignal2 = [self.btnCommand.executionSignals flattenMap:^RACStream *(id value) {
// NSLog(@"xx=%@",value);//value是一个新的RACSignal(RACDynamicSignal)
RACSignal *s = value;
RACSignal *es = [s materialize];//转化为一个传RACEvent的信号
//得到事件的状态和值
RACSignal *fs = [[es filter:^BOOL(id value) {
RACEvent *ev = value;
if (ev.eventType == RACEventTypeNext) {
NSLog(@"next == %@",ev.value);
}
return @(ev.eventType == RACEventTypeCompleted);//Completed
}]map:^id(id value) {
return @"success";
}];
return fs;
}];
RAC(self,text2) = strSignal2;
//3.实际运用中这个可以用来fail,2不能得到的这个可以得到了
RACSignal *strSignal3 = [[self.btnCommand.errors subscribeOn:[RACScheduler mainThreadScheduler]]map:^id(id value) {
return @"failed";
}];
RAC(self,text3) = strSignal3;
//这些信号也可以合并(merge)在一起,毕竟是一个command来的
}
这样的话你在ViewController中就很简单
- (void)btnCommand{
self.btn_1.rac_command = self.viewModel.btnCommand;
RAC(self.lbl_1,text) = RACObserve(self.viewModel, text1);
RAC(self.lbl_2,text) = RACObserve(self.viewModel, text2);
RAC(self.lbl_3,text) = RACObserve(self.viewModel, text3);
}
- (void)test{
self.viewModel = [ViewModel new];
[self btnCommand];
}
这样你就实现了,点击按钮,同时改变View中三个label的显示.demo后续上传.