MVVM的具体实践

  本章的其他部分将把Functional Reactive Pixels Demo的其他代码迁移到MVVM架构中。我们将添加一个新的库到Podfile文件里。Github上创作了ReactiveCocoa的黑客,也同时创建了一个ViewModel的基类:ReactiveViewModel.我们将要使用它的0.1.1版本。更新Podfile之后立即运行pod install以安装该库。

  重构的第一个类是高清图片视图控制器。从这儿开始是因为它的业务逻辑比较少,抽象成viewModel时相对简单。我们循序渐进,慢慢来。

  目前,我们的FRPFullSizePhotoViewController包含一个图片数组和当前图片(在数组中)的下标值。我们将把他们抽象到我们的视图模型中来。

  从头文件中移除自定义初始化,追加FRPFullSizePhotoViewModel的预申明。然后在这个新类中追加一个属性。

  1. @property (nonatomic ,strong ) FRPFullSizePhotoViewModel *viewModel;

  在实现文件里,#import这个新的视图模型(别担心,我们很快就会创建它),

  1. #import "FRPFullSizePhotoViewModel.h"

  然后,移除photoModelArray私有属性的申明。重写我们的初始化方法以移除对photoModelArray实例的引用。代码看起来应该像下面这样:

  1. - (instancetype)init {
  2. self = [super init];
  3. if(!self) return nil;
  4. //ViewControllers
  5. self.pageViewController = [UIPageViewController alloc]
  6. initWithTransitionStyle:UIPageViewControllerTransitionStyleScroll
  7. navigationOrientation:UIPageViewControllerNavigationOrientationHorizontal
  8. options:@{ UIPageViewControllerOptionInterPageSpacingKey : @30 };
  9. self.pageViewController.dataSource = self;
  10. self.pageViewController.delegate = self;
  11. [self addChildViewController:self.pageViewController];
  12. return self;
  13. }

  在你的ViewDidLoad:中添加如下代码:

  1. //Configure child view controllers
  2. [self.pageViewController \
  3. setViewControllers: @[ [self photoViewControllerForIndex:self.viewModel.initialPhotoIndex] ]
  4. direction:UIPageViewControllerNavigationDirectionForward
  5. animated:NO
  6. completion:nil ];
  7. //Configure self
  8. self.title = [self.viewModel.initialPhotoModel photoName];

我们将要写的这个我们提到的方法,对于veiwModel中发生的事情,给你一种XX感。最后,进到photoViewControllerForIndex方法中,它应用了已经解除分配的photoModelArray,用下面的实现替代它。

  1. - (FRPPhotoViewController *)photoViewControllerForIndex:(NSInteger)index {
  2. if (index >= 0 && index < self.viewModel.photoArray.coung ) {
  3. FRPPhotoModel *photoModel = self.viewModel.model[index];
  4. FRPPhotoViewController *photoViewController = \
  5. [[FRPPhotoViewController alloc] initWithPhotoModel:photoModel index:index];
  6. return photoViewController;
  7. }
  8. // Index was out of bounds, return nil
  9. return nil;
  10. }

  好了!现在轮到我们的视图模型本身了。创建一个新的RVMViewModel的子类,并将其命名为FRPFullSizedPhotoViewModel.基于它将要封装的信息,以及我们在视图控制器中的需求,我们知道,我们的头文件看起来应该是下面这样:

  1. @class FRPPhotoModel;
  2. @interface FRPFullSizePhotoViewModel : RVMViewModel
  3. - (instancetype)initWithPhotoArray:(NSArray *)photoArray initialPhotoIndex:(NSInteger)initialPhotoIndex;
  4. - (FRPPhotoModel *)photoModelAtIndex:(NSInteger)index;
  5. @property (nonatomic , readonly, strong) NSArray *model;
  6. @property (nonatomic, readonly) NSInteger initialPhotoIndex;
  7. @property (nonatomic, readonly) NSString *initialPhotoName;
  8. @end

  model属性在RVMViewModel中被定义为id类型,我们把它重定义为NSArray. 我们也勾住了(即使用全局变量记录)我们最初照片的索引(下标)并且给我们最初的照片名属性定义了只读属性。这种微不足道的逻辑我们可以放到我们的视图控制器中,但很快我们就会看到更为复杂的情况。

  我们来完成实现文件里的东西。第一件事就是:我们需要#import FRPPhotoModel类的头文件。然后,我们将打开私有属性的读写访问权限。

  1. //Model
  2. #import "FRPPhotoModel.h"
  3. @interface FRPFullSizePhotoViewModel ()
  4. //private access
  5. @property (nonatomic, assign) NSInteger initialPhotoIndex;
  6. @end

  好!下一步处理我们的初始化方法

  1. - (instancetype)initWithPhotoArray:(NSArray *)photoArray initialPhotoIndex:(NSInteger)initialPhotoIndex {
  2. self = [super initWithModel:photoArray];
  3. if(!self) return nil;
  4. self.initialPhotoIndex = initialPhotoIndex;
  5. return self;
  6. }

初始化方法中,先调用超类的initWithModel:实现,然后设置自己的initialPhotoIndex属性。剩下的两个只读属性的获取逻辑微不足道。

  1. - (NSString *)initialPhotoName {
  2. return [[self photoModelAtIndex:self.initialPhotoIndex] photoName];
  3. }
  4. - (FRPPhotoModel *)photoModelAtIndex:(NSInteger)index {
  5. if(index < 0 || index > self.model.count - 1) {
  6. //Index was out of bounds, return nil
  7. return nil;
  8. }
  9. else {
  10. return self.model[ index ];
  11. }
  12. }

  这样做的另一个优点是:业务逻辑不需要重复书写,而且也使得业务逻辑非常好进行单元测试。

  最后,我们需要在高清视图控制器中设置该视图模型,否则屏幕上将不会显示任何东西。导航到我们的画廊视图控制器(那个我们实例化并推出高清视图控制器的地方)。用下面的代码来替换这个业务逻辑:

  1. [[self rac_signalForSelector:@selector(collectionView:didSelectItemAtIndexPath:)
  2. fromProtocol:@protocol(UIcollectionViewDelegate)] subscribeNext:^(RACTuple *arguments) {
  3. @strongify(self);
  4. NSIndexPath *indexPath = arguments.second;
  5. FRPFullSizePhotoViewModel *viewModel = [[FRPPhotoViewModel alloc]
  6. initWithPhotoArray:self.viewModel.model initialPhotoIndex:indexPath.item];
  7. FRPFullSizePhotoViewController *viewController = [[FRPFullSizePhotoViewController alloc] init];
  8. viewController.viewModel = viewModel;
  9. viewController.delegate = (id<FRPFullSizePhotoViewControllerDelegate>)self;
  10. [self.navigationController pushViewController:viewController animated:YES];
  11. }];

在下一节开始之前,我们没有计划为视图模型撰写单元测试。下一节我们看到在视图模型上如何运行测试驱动开发的概念。现在我们来完成FRPGalleryViewModel吧,很基础。我们想要从视图控制器中抽象出来的逻辑是通过API加载model的数据内容。我们来看一下应该怎么做:

  1. @interface FRPGalleryViewModel : RVMViewModel
  2. @property (nonatomic, readonly, strong) NSArray *model;
  3. @end

  基本的接口:将model申明为数组NSArray.接下来,我们简单实现它:

  1. //Utilities
  2. #import "FRPPhotoImporter.h"
  3. @interface FRPGalleryViewModel ()
  4. @end
  5. @implementation FRPGalleryViewModel
  6. - (instancetype)init {
  7. self = [super init];
  8. if(!self) return nil;
  9. RAC(self, model) = [[[FRPPhotoImporter importPhotos] logError] catchTo:[RACSignal empty]];
  10. return self;
  11. }
  12. @end

  有争议的是,我们应该把从API加载数据的(RAC绑定的)逻辑放在初始化方法中,还是放在视图模型被激活的地方。接下来我们会讨论更多的关于激活的内容,但我想要展示给你们看这个视图模型到底能做到多简单。将直接在画廊视图控制器中加载数据内容的逻辑迁移到画廊的视图模型中是非常简单的:在视图控制器的初始化中初始化视图模型===》任何引用试图控制self.model属性的地方使用self.viewModel.model来代替即可。

  我们可以进一步深挖视图模型的构造,甚至可以通过一系列的访问器把model的访问逻辑抽象出来,但在这个例子里就有点过多‘抽象’了。更重要的是你可以根据你的喜好将更多的或者更少的业务逻辑抽象到视图模型中。我发现,就我个人而言,这个架构使用的越多,业务逻辑抽象出来的越多,就意味着更轻量级的视图控制器以及高内聚和可测试的代码。

  把注意力移到单元测试之前,我们来做多一次用视图模型来抽象业务逻辑的实践。

  我们的最后一个例子是FRPPhotoViewController上的FRPPhotoViewModel:创建一个RVMViewModel的视图模型子类并放置在视图控制器中(很快我们会回到视图模型中)。

  视图控制器的新的初始化方法如下:

  1. - (instancetype)initWithViewModel:(FRPPhotoViewModel *)viewModel index:(NSInteger)photoIndex {
  2. self = [self init];//NS_DESIGNATED_INITIALIZER
  3. if(!self) return nil;
  4. self.viewModel = viewModel;
  5. self.photoIndex = photoIndex;
  6. return self;
  7. }

  确定导入必要的头文件并为视图模型申明私有属性。现在我们需要使用新的初始化方法初始化视图控制器。看一看视图控制器到页面视图控制器的方法photoViewControllerForIndex:.

  1. - (FRPPhotoViewController *)photoViewControllerForIndex:(NSInteger)index {
  2. FRPPhotoModel *photoModel = [self.viewModel photoModelAtIndex:index];
  3. if(photoModel) {
  4. FRPPhotoViewModel *photoViewModel = [[FRPPhotoViewModel alloc] initWithModel:photoModel];
  5. FRPPhotoViewController *photoViewController = [[FRPPhotoViewController alloc] \
  6. initWithViewModel:photoViewModel
  7. index:index];
  8. return photoViewController;
  9. }
  10. return nil;
  11. }

  新的初始化过程中我们创建了一个视图模型。

  在我们的viewDidLoad:方法里,我们将使用这个新的视图模型为我们的图片视图提供数据,并且为用户显示图片的下载进度。这里有个貌似冲突的地方:图片的下载是视图的模型的业务逻辑之一,但视图什么时候显示开始加载数据(这个业务逻辑)视图模型中没有体现—-记住一个好的视图模型不应该引用视图本身。那么我们如何来混合地使用这两个业务逻辑?

  答案是我们借助视图模型的active状态来对付(上面的情况)。RVMViewModel提供了一个布尔属性active,当试图控制器变得”活跃”时(不管在语义的上下文里这是啥意思),在这里,我们可以在viewWillAppear:viewDidDisappear:这些方法来设置这个属性。

  1. - (void)viewWillAppear:(BOOL)animated {
  2. [super viewWillAppear:animated];
  3. self.viewModel.active = YES;
  4. }
  5. - (void)viewDidDisappear:(BOOL)animated {
  6. [super viewDidDisappear:animated];
  7. self.viewModel.active = NO;
  8. }

相当简单吧,我们来看一下我们新的viewDidLoad方法:

  1. - (void)viewDidLoad {
  2. [super viewDidLoad];
  3. //Configure self's view
  4. self.view.backgroundColor = [UIColor blackColor];
  5. //Configure subViews
  6. UIImageView *imageView = [[UIImageView alloc] initWithFrame:self.view.bounds];
  7. RAC(imageView, image) = RACObserve(self.viewModel,photoImage);
  8. imageView.contentModel = UIViewContentModelScaleAspectFit;
  9. [self.view addSubView:imageView];
  10. self.imageView = imageView;
  11. [RACObserve(self.viewModel, loading) subscribeNext:^(NSNumber *loading) {
  12. if(loading.boolValue) {
  13. [SVProgressHUD show];
  14. }
  15. else {
  16. [SVProgressHUD dismiss];
  17. }
  18. }];
  19. }

  该图片视图的图片属性的绑定是标准的ReactiveCocoa方式,有趣的是下面(我们要提到的)我们使用loading的时刻。当加载信号发送YES的时候我们展示进度HUD,发送NO的时候,让进度HUD消失。我们将看到该loading信号本身如何依赖于didBecomeActiveSignal。现在只是视图模型通过网络请求获取图像数据的序幕。

  接口的申明如下:

  1. @class FRPPhotoModel;
  2. @interface FRPPhotoViewModel : RVMViewModel
  3. @property (nonatomic, readonly) FRPPhotoModel *model;
  4. @property (nonatomic, readonly) UIImage *photoImage;
  5. @property (nonatomic, readonly, getter = isLoading) BOOL loading;
  6. - (NSString *)photoName;
  7. @end

  该modelphotoImage属性的用法已经解释过了。photoName事实上作为属性在代码库的其他地方被用来设置一些东西,类似于分页视图控制器的标题这样。你可以下载Github的代码库了解详情。我们来看一下实现:

  1. #import "FRPPhotoViewModel.h"
  2. //Utilities
  3. #import "FRPPhotoImporter.h"
  4. #import "FRPPhotoModel.h"
  5. @interface FRPPhotoViewModel ()
  6. @property (nonatomic, strong) UIImage *photoImage;
  7. @property (nonatomic, assign, getter = isLoading) BOOL loading;
  8. @end
  9. @implementation FRPPhotoViewModel
  10. - (instancetype)initWithModel:(FRPPhotoModel *)photoModel {
  11. self = [super initWithModel:photoModel];
  12. if(!self) return nil;
  13. @weakify(self);
  14. [self.didBeComeActiveSignal subscribeNext:^(id x) {
  15. @strongify(self);
  16. self.loading = YES;
  17. [[FRPPhotoImporter fetchPhotoDetails:self.model] subscribeError:^(NSError *error) {
  18. NSLog(@"Could not fetch photo details: %@",error);
  19. } completed:^{
  20. self.loading = NO;
  21. NSLog(@"Fetched photoDetails.");
  22. }];
  23. }];
  24. RAC(self, photoImage) = [RACObserve(self.model, fullsizedData) map:^id (id value) {
  25. return [UIImage imageWithData:value];
  26. }];
  27. return self;
  28. }
  29. - (NSString *)photoName {
  30. return self.model.photoName;
  31. }
  32. @end

  该didBecomeActive信号订阅带有”函数副作用”的加载照片详情包括它的高清图片的数据。然后photoImage属性与模型的映射结果绑定。

  使用didBecomeActiveSignal这种方法来启动一些像网络操作这样昂贵的任务,远远优于我们早前在初始化方法中启动他们的方法。

  这就是在本书中我们将要涉及的全部内容,更多详情请参考functional reactive pixels,这个代码库包含了更多的在图片详情视图控制器和登陆视图控制器中使用视图模型的例子。这些Demo将向你展示如何有效地使用ReactiveCocoa执行网络操作和使用RACCommands响应用户界面交互。