- 绑定,绑定,绑定(重要的实情说三遍)
RACCommand能实时地更新search按钮的状态,但是时候来处理activity indicator的可见状态了.
RACCommand拥有一个执行的属性,它是用来表示命令开始和结束执行时反应真假事件的信号量.你可以通过这个信号量来反映程序中当前命令执行的状态.
在RWTFlickrSearchViewController.m的bindViewModel的尾部添加:
RAC([UIApplication sharedApplication], networkActivityIndicatorVisible) = self.viewModel.executeSearch.executing;
以上代码用来将UIApplication中的networkActivityIndicatorVisible属性和命令执行信号绑定.用来保证当命令执行时,小的网络激活状态标志在status bar里显示.
下一步,添加:
RAC(self.loadingIndicator, hidden) = [self.viewModel.executeSearch.executing not];
当指令执行后,加载标志将会被隐藏;这和你刚刚绑定的属性相反.
ReactiveCocoa已经为我们提供了不执行的相反的信号.最后,添加如下代码:
[self.viewModel.executeSearch.executionSignals
subscribeNext:^(id x) {
[self.searchTextField resignFirstResponder];
}];
上面的代码用来保证当命令执行时键盘会隐藏.executionSignals属性用来在命令执行时实时地发出信号.
这是个signals中的一个signal属性(前面教程里有介绍).当一个新的命令执行的时候就会被创建和执行,隐藏键盘.
运行程序,来验证以上代码的执行.
- Model呢？
到现在为止,你已经定义了一个View(RWTFlickrSearchViewController)和ViewModel(RWTFlickrSearchViewModel),但是,怎么木有Model呢？
答案很简单:就是还没有啊!
当前app用户点击搜索按钮后就会执行命令,但却没有实现什么.
我们需要实现的是利用当前输入的搜索文本通过ViewModel在Flickr进行搜索,继而返回相匹配的图片列表.
你可以将此逻辑直接放在ViewModel里,但相信我,你会后悔的!如果是个view controller,我到时强烈你这么做.
View Model拥有UI状态的属性,而且还能够执行命令(经常为UI上的动作方法).通过用户的交互来管理改变UI状态.
然而,并不表示这些交互实际的业务逻辑应该在View Model里面.而这应该是Model的工作.
下一步,将会给应用增加Model层.
在Model group里添加一个名为RWTFlickrSearch的新协议并提供了如下的方法:
#import <ReactiveCocoa/ReactiveCocoa.h>
@import Foundation;
@protocol RWTFlickrSearch <NSObject>
- (RACSignal *)flickrSearchSignal:(NSString *)searchString;
@end
这个协议定义了Model层的初始方法,用来将负责搜索Flickr的任务从ViewModel里移出.
接下来,在同一group里创建一个名为RWTFlickrSearchImpl的NSObject的子类.并使其遵从刚才的协议:
@import Foundation;
#import "RWTFlickrSearch.h"
@interface RWTFlickrSearchImpl : NSObject <RWTFlickrSearch>
@end
在RWTFlickrSearchImpl.m里添加以下代码:
@implementation RWTFlickrSearchImpl
- (RACSignal *)flickrSearchSignal:(NSString *)searchString {
return [[[[RACSignal empty]
logAll]
delay:2.0]
logAll];
}
@end
是不是觉得似曾相识?如果是的,那是因为这个同一'虚拟'的实现曾经位于ViewModel里.
下一步是要在ViewModel里使用Model层.在ViewModel group里添加一个名为RWTViewModelServices的新协议:
@import Foundation;
#import "RWTFlickrSearch.h"
@protocol RWTViewModelServices <NSObject>
- (id<RWTFlickrSearch>) getFlickrSearchService;
@end
这个协议定义了ViewModel获得对RWTFlickrSearch协议引用的方法.
在RWTFlickrSearchViewModel.h导入这个新协议:
#import "RWTViewModelServices.h"
更新initializer来将它作为参数:
- (instancetype) initWithServices:(id<RWTViewModelServices>)services;
在RWTFlickrSearchViewModel.m里添加一个类扩展和一个私有属性来保存对view model services的引用:
@interface RWTFlickrSearchViewModel ()
@property (nonatomic, weak) id<RWTViewModelServices> services;
@end
在同一文件里更新initializer:
- (instancetype) initWithServices:(id<RWTViewModelServices>)services {
self = [super init];
if (self) {
_services = services;
[self initialize];
}
return self;
}
以上用来保存对services的引用.
最后,更新executeSearchSignal方法:
- (RACSignal *)executeSearchSignal {
return [[self.services getFlickrSearchService]
flickrSearchSignal:self.searchText];
}
上面的方法代理了model来实现搜索.
最后一步是将Model和ViewModel相连.
在RWTFlickrSearch项目的'root' group里添加一个名为RWTViewModelServiceImpl的NSObject的子类.在RWTViewModelServicesImpl.h里添加遵从RWTViewModelServices协议:
@import Foundation;
#import "RWTViewModelServices.h"
@interface RWTViewModelServicesImpl : NSObject <RWTViewModelServices>
@end
在RWTViewModelServicesImpl.m实现:
#import "RWTViewModelServicesImpl.h"
#import "RWTFlickrSearchImpl.h"
@interface RWTViewModelServicesImpl ()
@property (strong, nonatomic) RWTFlickrSearchImpl *searchService;
@end
@implementation RWTViewModelServicesImpl
- (instancetype)init {
if (self = [super init]) {
_searchService = [RWTFlickrSearchImpl new];
}
return self;
}
- (id<RWTFlickrSearch>)getFlickrSearchService {
return self.searchService;
}
@end
这个类创建了一个RWTFlickrSearchImpl的实例,Model层服务Flickr搜索,将其提供给ViewModel upon 请求.
最后,在RWTAppDelegate.m里导入:
#import "RWTViewModelServicesImpl.h"
添加一个私有属性:
@property (strong, nonatomic) RWTViewModelServicesImpl *viewModelServices;
更新createInitialViewController方法:
- (UIViewController *)createInitialViewController {
self.viewModelServices = [RWTViewModelServicesImpl new];
self.viewModel = [[RWTFlickrSearchViewModel alloc]
initWithServices:self.viewModelServices];
return [[RWTFlickrSearchViewController alloc]
initWithViewModel:self.viewModel];
}
运行程序,确保程序和之前运行的结果相似.
这并不是最令人兴奋的变化,但花点时间来看看新代码的"形状".
Model层展示了'service'的ViewModel consumes.协议定义了这个服务接口,提供松耦合.
你可以用这个假设的服务实现用于单元测试.应用现在已经有了正确地Model-View-ViewModel结构.来小结下:
- Model提供应用业务逻辑实现的服务.在本应用中,它提供了Flickr搜索的服务.
- ViewModel层提供了应用的视图状态.它提供了用户交互以及来自视图变化后Model层的事件.
- View层非常瘦,提供了ViewModel状态变化后在视图层的展示.
- Flickr搜索
本章节,你将编写一个真实的Flickr搜索实现,事情开始变得令人兴奋了呢;]
第一步是创建一个搜索结果的model.
在Model group里添加一个名为RWTFlickrPhoto的NSObject的子类,在接口里添加三个属性:
@interface RWTFlickrPhoto : NSObject
@property (strong, nonatomic) NSString *title;
@property (strong, nonatomic) NSURL *url;
@property (strong, nonatomic) NSString *identifier;
@end
这个Model对象相当于Flickr搜索API所返回的单张图片.
在RWTFlickrPhoto.m添加如下方法:
- (NSString *)description {
return self.title;
}
这个方法可以在实现UI变化之前通过打印搜索的结果来测试搜索的实现.
接下来,添加另一个名为RWTFlickrSearchResults的NSObject子类的模型.在接口里添加如下属性:
@import Foundation;
@interface RWTFlickrSearchResults : NSObject
@property (strong, nonatomic) NSString *searchString;
@property (strong, nonatomic) NSArray *photos;
@property (nonatomic) NSUInteger totalResults;
@end
用来保存Flickr搜索返回的图片集合.
在RWTFlickrSearchResults.m的description方法里添加:
- (NSString *)description {
return [NSString stringWithFormat:@"searchString=%@, totalresults=%lU, photos=%@",
self.searchString, self.totalResults, self.photos];
}
现在开始编写Flickr搜索的代码喽！
在RWTFlickrSearchImpl.m添加:
#import "RWTFlickrSearchResults.h"
#import "RWTFlickrPhoto.h"
#import <objectiveflickr/ObjectiveFlickr.h>
#import <LinqToObjectiveC/NSArray+LinqExtensions.h>
导入了刚才你创建的Model,添加了一对CocoaPods添加的扩展依赖:
- ObjectiveFlickr:这是个用Objective-C API 实现的Flickr API.用来处理授权和解析API返回的结果.使用此库比直接调用Flickr API要简单.
- LingToObjectiveC:提供了流畅和丰富的查询接口,过滤和转换数组和词典.
仍然在RWTFlickrSearchImpl.m里添加类的扩展:
@interface RWTFlickrSearchImpl () <OFFlickrAPIRequestDelegate>
@property (strong, nonatomic) NSMutableSet *requests;
@property (strong, nonatomic) OFFlickrAPIContext *flickrContext;
@end
使其遵从ObejectiveFlickr库的OFFlickrAPIRequestDelegate协议并添加了一对私有属性.你将很快看到他们的用法.
紧接着添加如下initializer:
- (instancetype)init {
self = [super init];
if (self) {
NSString *OFSampleAppAPIKey = @"YOUR_API_KEY_GOES_HERE";
NSString *OFSampleAppAPISharedSecret = @"YOUR_SECRET_GOES_HERE";
_flickrContext = [[OFFlickrAPIContext alloc] initWithAPIKey:OFSampleAppAPIKey
sharedSecret:OFSampleAppAPISharedSecret];
_requests = [NSMutableSet new];
}
return self;
}
以上代码创建了一个Flickr 'context'来存储API请求所需的ObjectiveFlickr数据.
你可以在Flickr App Garden来获取Key.
ObjectiveFlickr API非常常规.你创建了一个API请求后返回结果成功或失败是通过定义的OFFlickrAPIRequestDelegate方法来处理的.
当前API是通过你的Model层服务类即RWTFlickrSearch协议,有一个方法来通过文本搜索字符串来进行图片搜索的.
然而,待会你将添加一些另外的方法.
因此,你将要去从直接用通用的方法到使用这种基于代理的API信号.
仍然在RWTFlickrSearchImpl.m文件里添加:
- (RACSignal *)signalFromAPIMethod:(NSString *)method
arguments:(NSDictionary *)args
transform:(id (^)(NSDictionary *response))block {
// 1. Create a signal for this request
return [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
// 2. Create a Flick request object
OFFlickrAPIRequest *flickrRequest =
[[OFFlickrAPIRequest alloc] initWithAPIContext:self.flickrContext];
flickrRequest.delegate = self;
[self.requests addObject:flickrRequest];
// 3. Create a signal from the delegate method
RACSignal *successSignal =
[self rac_signalForSelector:@selector(flickrAPIRequest:didCompleteWithResponse:)
fromProtocol:@protocol(OFFlickrAPIRequestDelegate)];
// 4. Handle the response
[[[successSignal
map:^id(RACTuple *tuple) {
return tuple.second;
}]
map:block]
subscribeNext:^(id x) {
[subscriber sendNext:x];
[subscriber sendCompleted];
}];
// 5. Make the request
[flickrRequest callAPIMethodWithGET:method
arguments:args];
// 6. When we are done, remove the reference to this request
return [RACDisposable disposableWithBlock:^{
[self.requests removeObject:flickrRequest];
}];
}];
}
这个方法提供了一个API请求,详见方法名和传递的参数,继而通过block来传递结果.你将很快来了解它是如何工作的.
解析此方法,这里有许多内容.下面是每步的释义:
- createSignal方法创建了一个新信号.传递信号的block方法可以让你处理发送下一步、错误或者事件的完成信号.
- ObjectivewFlickr请求被创建,这个请求的引用被存储在请求set里.如果没有这段代码,OFFlickrAPIRequest将不被保留.
- rac_signalForSelector:fromProtocol方法从表示Flickr API 请求完成后的的代理方法里创建一个信号.
- 该信号被绑定,结果变换和被发送的结果作为信号被创建.
- ObjectiveFlickr API 请求被使用.
- 当信号被释放后,block确保Flickr请求的引用被移除,避免内存漏洞.
现在我们来看下步骤4的更多细节:
[[[successSignal
// 1. Extract the second argument
map:^id(RACTuple *tuple) {
return tuple.second;
}]
// 2. transform the results
map:block]
subscribeNext:^(id x) {
// 3. send the results to the subscribers
[subscriber sendNext:x];
[subscriber sendCompleted];
}];
rac_signalForSelector:fromProtocol:方法创建了successSignal,而且它还从代理方法里创建信号.
当代理方法被调用时,下一个事件包含方法参数的RACTuple被发出.接着执行以下步骤:
- 一个map操作提取从flickrAPIRequest:didCompleteWithResponse:的第二个参数,代理方法中的词典结果.
- block传递给此方法一个结果参数.你将很快看到如何将词典转换为模型对象.
- 最后,传递的结果被发送给下一个事件,这个信号完成.
最后来实现Flickr搜搜结果方法:
- (RACSignal *)flickrSearchSignal:(NSString *)searchString {
return [self signalFromAPIMethod:@"flickr.photos.search"
arguments:@{@"text": searchString,
@"sort": @"interestingness-desc"}
transform:^id(NSDictionary *response) {
RWTFlickrSearchResults *results = [RWTFlickrSearchResults new];
results.searchString = searchString;
results.totalResults = [[response valueForKeyPath:@"photos.total"] integerValue];
NSArray *photos = [response valueForKeyPath:@"photos.photo"];
results.photos = [photos linq_select:^id(NSDictionary *jsonPhoto) {
RWTFlickrPhoto *photo = [RWTFlickrPhoto new];
photo.title = [jsonPhoto objectForKey:@"title"];
photo.identifier = [jsonPhoto objectForKey:@"id"];
photo.url = [self.flickrContext photoSourceURLFromDictionary:jsonPhoto
size:OFFlickrSmallSize];
return photo;
}];
return results;
}];
}
以上方法使用之前你添加的signalFromAPIMethod:arguments:transform:方法.flickr.photos.search API方法搜索图片,将以词典为格式.
传递到参数中的block简单地转换词典结果为模型对象,使ViewModel更容易使用.
代码使用linq_select方法通过LingToObjectiveC添加数组.提供了API的数组传送.
最后在RWTFlickrSearchViewModel.m里更新搜索信号日志结果:
- (RACSignal *)executeSearchSignal {
return [[[self.services getFlickrSearchService]
flickrSearchSignal:self.searchText]
logAll];
}
运行,输入一个搜索字符后在console里查看信号的结果日志:
2014-06-03 [...] <RACDynamicSignal: 0x8c368a0> name: +createSignal: next: searchString=wibble, totalresults=1973, photos=(
"Wibble, wobble, wibble, wobble",
"unoa-army",
"Day 277: Cheers to the freakin' weekend!",
[...]
"Angry sky",
Nemesis
)
Girl学iOS100天 第18天
网友评论