RACCommand作为ReactiveCocoa基本组件之一,通常在项目开发过程中RACSignal与RACSubject组合使用就可以满足大部分的开发需求。
RACCommand个人理解为事件响应信号的管理者。其本身并不继承自RACSignal或者RACStream类,而是继承于NSObject,用于管理RACSignal类的创建于订阅的类。关于RACCommand类的作用,找到了一篇国外的博客原文链接,其中写道:
大意为,RACCommand类用于响应动作事件的执行,执行命令通常由用户交互页面的手势操作来触发。该类可以实现多种不同情况下的响应事件处理,除了可以快速绑定交互页面,还可以确保其在未使用时不会执行信号操作。
因此在实际项目开发中,RACCommand使用的场景多用于交互手势操作响应事件,以及网络请求时不同请求状态的处理封装处理。当需要响应事件或网络请求时,直接执行对应RACCommand就可以发送信号,执行操作。当RACCommand内部收到请求时,把处理的结果返回给外部,这时要通过signalBlock返回的信号进行数据传递。
接下来,看看RACCommand类的基本使用
//创建command信号
RACCommand *command = [[RACCommand alloc]initWithSignalBlock:^RACSignal * _Nonnull(id _Nullable input) {
//返回RACSignal信号类型对象
return [RACSignal createSignal:^RACDisposable * _Nullable(id<RACSubscriber> _Nonnull subscriber) {
[subscriber sendNext:@"this is signal of command"];
NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:1234 userInfo:@{@"key":@"error"}];
[subscriber sendError:error];
return [RACDisposable disposableWithBlock:^{
NSLog(@"销毁了");
}];
}];
}];
//command信号是否正在执行
[command.executing subscribeNext:^(NSNumber * _Nullable x) {
NSLog(@"executing == %@",x);
}];
//错误信号
[command.errors subscribeNext:^(NSError * _Nullable x) {
NSLog(@"errors == %@",x);
}];
//command信号中的signal信号发送出来的订阅信号
[command.executionSignals subscribeNext:^(id _Nullable x) {
NSLog(@"executionSignals == %@",x);
}];
//必须执行命令,否则所有信号都不会订阅到
[command execute:@"command执行"];
打印结果
从打印结果中可以发现,executing属性在信号开始时,一定会返回0,代表RACCommand未执行,在实际应用中,并不需要监听command第一次未执行状态。此处可将属性executing的代码修改成自动跳过第一个信号
[[command.executing skip:1] subscribeNext:^(NSNumber * _Nullable x) {
NSLog(@"executing == %@",x);
}];
打印结果中,已经打印出command中的RACSignal信号,若需要监听发送信号中的具体内容,可将executionSignals的订阅信号代码修改成:
//监听最后一次发送的信号
[[command.executionSignals switchToLatest] subscribeNext:^(id _Nullable x) {
NSLog(@"executionSignals == %@",x);
}];
这时的打印结果就变成了预期想要的结果
修改后
至于为什么error信号,没有被executionSignals订阅到,而是被errors给订阅到了?
原因在于这个errors是一个被包装在RACSignal信号类对象,进行错误处理的时候,我们不应该使用subscribeError:对RACCommand的executionSignals
进行错误的订阅,因为executionSignals这个信号是不会发送error事件的,而应该使用subscribeNext:去订阅错误信号。
errors信号对象内部实现
在RACCommand使用中,创建的RACSignal信号时,发送完订阅信号时,若没有error信号发送,则需要执行[subscriber sendCompleted]命令来销毁信号。否则该RACCommand会一直处于执行状态而无法正常释放。
接下来以一个简单的登录页面小demo来介绍RACCommand的作用与使用方法。
GitHub链接demo链接
网友评论