• 绑定,绑定,绑定(重要的实情说三遍)

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结构.来小结下:

1. Model提供应用业务逻辑实现的服务.在本应用中,它提供了Flickr搜索的服务.
2. ViewModel层提供了应用的视图状态.它提供了用户交互以及来自视图变化后Model层的事件.
3. 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来传递结果.你将很快来了解它是如何工作的.
解析此方法,这里有许多内容.下面是每步的释义:

1. createSignal方法创建了一个新信号.传递信号的block方法可以让你处理发送下一步、错误或者事件的完成信号.
2. ObjectivewFlickr请求被创建,这个请求的引用被存储在请求set里.如果没有这段代码,OFFlickrAPIRequest将不被保留.
3. rac_signalForSelector:fromProtocol方法从表示Flickr API 请求完成后的的代理方法里创建一个信号.
4. 该信号被绑定,结果变换和被发送的结果作为信号被创建.
5. ObjectiveFlickr API 请求被使用.
6. 当信号被释放后,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被发出.接着执行以下步骤:

1. 一个map操作提取从flickrAPIRequest:didCompleteWithResponse:的第二个参数,代理方法中的词典结果.
2. block传递给此方法一个结果参数.你将很快看到如何将词典转换为模型对象.
3. 最后,传递的结果被发送给下一个事件,这个信号完成.

最后来实现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天