表现使得开发iOS

Designer News.png

前段时间在design+code进了一个学习iOS设计及编码在线课程,使用Sketch设计App,然后利用Swift语言实现Designer
News客户端。作者Meng
To已开始源及Github:MengTo/DesignerNewsApp ·
GitHub。虽然实现全Designer
News客户端基本功能,但是利用臃肿MVC(Model-View-Controller)架构,不易为代码的测试与复用,于是利用ReactiveCocoa心想事成MVVM(Model-View-View
Model)架构,加上一个用Objective-C实现之BDD测试框架Kiwi来单元测试,就可以表现使开发iOS
App。

ReactiveCocoa

ReactiveCocoa是一个用Objective-C编写,具有函数式和响应式特性的编程框架。大多数底开发者他们解决问题的思想方式都是怎样成功任务,通常的做法就是编辑很多指令,然后修改要数据结构的状态,这种编程范式叫做命令式编程(Imperative
Programming)。与命令式编程不同之凡函数式编程(Functional
Programming),思考问题的道是瓜熟蒂落什么任务,怎样描述是职责。关于对函数式编程入门概念的解,可以参照酷壳《函数式编程》这篇文章,深入浅出对函数式编程的琢磨方式、特性和技能通过有示范来教学。

ReactiveCocoa解决哪些问题?

  • 对象期间状态与状态的因过多问题
    借ReactiveCocoa中一个例子来说明:用户在签到界面时,有一个用户称输入框和密码输入框,还有一个报到按钮。登录交互要求如下:

  • 当用户称及密码可验证格式,并且之前还并未登录时,登录按钮才能够点击。

  • 当点击登录成功登录后,设置已报到状态。

传统的做法代码如下:

static void *ObservationContext = &ObservationContext;

- (void)viewDidLoad {
   [super viewDidLoad];

   [LoginManager.sharedManager addObserver:self forKeyPath:@"loggingIn" options:NSKeyValueObservingOptionInitial context:&ObservationContext];
   [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(loggedOut:) name:UserDidLogOutNotification object:LoginManager.sharedManager];

   [self.usernameTextField addTarget:self action:@selector(updateLogInButton) forControlEvents:UIControlEventEditingChanged];
   [self.passwordTextField addTarget:self action:@selector(updateLogInButton) forControlEvents:UIControlEventEditingChanged];
   [self.logInButton addTarget:self action:@selector(logInPressed:) forControlEvents:UIControlEventTouchUpInside];
}

- (void)dealloc {
   [LoginManager.sharedManager removeObserver:self forKeyPath:@"loggingIn" context:ObservationContext];
   [NSNotificationCenter.defaultCenter removeObserver:self];
}

- (void)updateLogInButton {
   BOOL textFieldsNonEmpty = self.usernameTextField.text.length > 0 && self.passwordTextField.text.length > 0;
   BOOL readyToLogIn = !LoginManager.sharedManager.isLoggingIn && !self.loggedIn;
   self.logInButton.enabled = textFieldsNonEmpty && readyToLogIn;
}

- (IBAction)logInPressed:(UIButton *)sender {
   [[LoginManager sharedManager]
       logInWithUsername:self.usernameTextField.text
       password:self.passwordTextField.text
       success:^{
           self.loggedIn = YES;
       } failure:^(NSError *error) {
           [self presentError:error];
       }];
}

- (void)loggedOut:(NSNotification *)notification {
   self.loggedIn = NO;
}

- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context {
   if (context == ObservationContext) {
       [self updateLogInButton];
   } else {
       [super observeValueForKeyPath:keyPath ofObject:object change:change context:context];
   }
}

上述使用KVO、Notification、Target-Action等处理事件或信息之艺术编写的代码分散到各个地方,变得乱七八糟和难以知晓;但是下RACSignal统一处理吧,代码更加简明与易读。使用RAC后代码如下:

- (void)viewDidLoad {
    [super viewDidLoad];

    @weakify(self);

    RAC(self.logInButton, enabled) = [RACSignal
        combineLatest:@[
            self.usernameTextField.rac_textSignal,
            self.passwordTextField.rac_textSignal,
            RACObserve(LoginManager.sharedManager, loggingIn),
            RACObserve(self, loggedIn)
        ] reduce:^(NSString *username, NSString *password, NSNumber *loggingIn, NSNumber *loggedIn) {
            return @(username.length > 0 && password.length > 0 && !loggingIn.boolValue && !loggedIn.boolValue);
        }];

    [[self.logInButton rac_signalForControlEvents:UIControlEventTouchUpInside] subscribeNext:^(UIButton *sender) {
        @strongify(self);

        RACSignal *loginSignal = [LoginManager.sharedManager
            logInWithUsername:self.usernameTextField.text
            password:self.passwordTextField.text];

            [loginSignal subscribeError:^(NSError *error) {
                @strongify(self);
                [self presentError:error];
            } completed:^{
                @strongify(self);
                self.loggedIn = YES;
            }];
    }];

    RAC(self, loggedIn) = [[NSNotificationCenter.defaultCenter
        rac_addObserverForName:UserDidLogOutNotification object:nil]
        mapReplace:@NO];
}
  • 俗MVC架构中,由于Controller承担数据说明、映射数据模型到View和操作View层次结构等大多独事,导致Controller过于臃肿,不便宜代码的复用和测试。
    当传统的MVC架构中,主要出Model,
    View和Controller三部分组成。Model主要是保留数据与拍卖事务逻辑,View将数据显示,而Controller调解关于Model和View之间的拥有交互。
    当数码到时,Model通过Key-Value Observation来打招呼View Controller,
    然后View Controller更新View。当View与用户交互后,View
    Controller更新Model。

Typical MVC paradigm.png

恰而你所呈现,View
Controller隐式承担过多专责:数据印证、映射数据模型到View和操作View层次结构。MVVM将许多逻辑从View
Controller移走及View-Model,等介绍完ReactiveCocoa后会见介绍MVVM架构。还有局部关于怎样减负View
Controller好文章请参见objc中国再也轻量的View
Controllers系列:

  • 又轻量的 View
    Controllers

  • 整洁的 Table View
    代码

  • 测试 View
    Controllers

  • 使Signal来替KVO、Notification、Delegate和Target-Action等传递信息
    iOS开发中起多消息传递方式,KVO、Notification、Delegate、Block和Target-Action,对于它中出什么区别与哪抉择要参考《消息传递机制》。但RAC提供RACSignal来归并消息传递机制,不再为怎么选择何种传递消息方式使抑郁。

    RAC对常用UI控件事件展开封装成一个RACSignal对象,以便对出的各种风波展开监听。
    KVO示例代码如下:

// When self.username changes, logs the new name to the console.
//
// RACObserve(self, username) creates a new RACSignal that sends the current
// value of self.username, then the new value whenever it changes.
// -subscribeNext: will execute the block whenever the signal sends a value.
[RACObserve(self, username) subscribeNext:^(NSString *newName) {
    NSLog(@"%@", newName);
}];

Target-Action示例代码如下:

// Logs a message whenever the button is pressed.
//
// RACCommand creates signals to represent UI actions. Each signal can
// represent a button press, for example, and have additional work associated
// with it.
//
// -rac_command is an addition to NSButton. The button will send itself on that
// command whenever it's pressed.
self.button.rac_command = [[RACCommand alloc] initWithSignalBlock:^(id _) {
    NSLog(@"button was pressed!");
    return [RACSignal empty];
}];

Notification示例代码如下:

 // Respond to when email text start and end editing
 [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidBeginEditingNotification object:self.emailTextField] subscribeNext:^(id x) {
      [self.emailImageView animate];
      self.emailImageView.image = [UIImage imageNamed:@"icon-mail-active"];
      self.emailTextField.background = [UIImage imageNamed:@"input-outline-active"];
  }];

 [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidEndEditingNotification object:self.emailTextField] subscribeNext:^(id x) {
      self.emailTextField.background = [UIImage imageNamed:@"input-outline"];
      self.emailImageView.image = [UIImage imageNamed:@"icon-mail"];
  }];

而外,还可以用AFNetworking做客服务器后针对回数据由创始一个RACSignal。示例代码如下:

 + (RACSubject*)storiesForSection:(NSString*)section page:(NSInteger)page
{
    RACSubject* signal = [RACSubject subject];

    NSDictionary* parameters = @{
        @"page" : [NSString stringWithFormat:@"%ld", (long)page],
        @"client_id" : clientID
    };

    [[AFHTTPSessionManager manager] GET:[DesignerNewsURL stroiesURLString] parameters:parameters success:^(NSURLSessionDataTask* task, id responseObject) {
                NSLog(@"url string = %@", task.currentRequest.URL);
                [signal sendNext:responseObject];
                [signal sendCompleted];
    } failure:^(NSURLSessionDataTask* task, NSError* error) {
                NSLog(@"url string = %@", task.currentRequest.URL);
                [signal sendError:error];
    }];

    return signal;
}

粗朋友可感觉到微微意外,上面代码明明返回的凡RACSubject,而休是RACSignal,其实RACSubject是RACSignal的子类,但是RACSubject写有代码更加从简,所以用RACSubject(官方不推荐利用)。等下将RAC核心类设计时,你虽会询问它中的关联及什么抉择。

ReactiveCocoa核心类设计

关于RAC核心类设计,官方文档有详细的说:Framework
Overview

Sequence和Signal基本操作

叩问完个RAC核心类设计后,要学会对Sequence和Signal基本操作,比如:用signal执行side
effects,转换streams, 合并stream和集合signal。详情请查阅官方文档:Basic
Operators

MVVM架构

MVVM high level.png

以MVVM架构中,通常还以view和view
controller看做一个一体化。相对于事先MVC架构中view
controller执行很多于view和model之间数据映射和互动的干活,现在拿其交给view
model去开。
关于选择啊种机制来更新view
model或view是从未有过强制的,但普通咱们都选ReactiveCocoa。ReactiveCocoa会监听model的更改然后将这些反映射到view
model的习性被,并且可实施有事情逻辑。
推个例证来说,有一个model包含一个dateAdded的特性,我怀念监听它的变然后更新view
model的dateAdded属性。但model的dateAdded属性的数据类型是NSDate,而view
model的数据类型是NSString,所以当view
model的init方法被开展多少绑定,但要多少类型转换。示例代码如下:

RAC(self,dateAdded) = [RACObserve(self.model,dateAdded) map:^(NSDate*date){ 
    return [[ViewModel dateFormatter] stringFromDate:date];
}];

ViewModel调用dateFormatter进行数据易,且方法dateFormatter可以复用到外地方。然后view
controller监听view model的dateAdded属性且绑定到label的text属性。

RAC(self.label,text) = RACObserve(self.viewModel,dateAdded);

如今我们抽象出日期变到字符串的逻辑到view
model,使得代码可以测试复用,并且帮view controller瘦身

Kiwi

Kiwi是一个iOS行为使得开发(Behavior Driven
Development)的堆栈。相比叫Xcode提供单元测试的XCTest是打测试的角度思考问题,而Kiwi是自从行为的角度思考问题,测试用例都以三段式Given-When-Then的叙述,清晰地发表测试用例是测试什么样的目标或数据结构,在依据什么上下文或气象,然后做出什么响应。

describe(@"Team", ^{
    context(@"when newly created", ^{
        it(@"has a name", ^{
            id team = [Team team];
            [[team.name should] equal:@"Black Hawks"];
        });

        it(@"has 11 players", ^{
            id team = [Team team];
            [[[team should] have:11] players];
        });
    });
});

咱俩大轻因上下文将那提为Given..When..Then的三段式自然语言

Given a Team, when be newly created, it should have a name, it should have 11 player

故Xcode自带的XCTest测试框架写过测试代码的情侣或者体会到,以上代码更加容易阅读与透亮。就算以后产生新的开发者入或者修护代码时,不需极度特别的资金去读书和了解代码。具体怎么行使Kiwi,请参考两首稿子:

  • TDD的iOS开发初步与Kiwi使用入门
  • Kiwi 使用上阶 Mock, Stub,
    参数捕获和异步测试

Designer News UI

在编辑Designer
News客户端代码之前,首先通过UI来了解任何App的概况。设计Designer News
UI的家伙是Sketch,想获得Designer
News UI,请点击下载Designer New
UI。

Designer News Design.png

倘以享有的页面还依次说明如何编写,会比较耗时间,所以才将登陆页面来验证自己是何等行事使开发iOS,但我会拿总体项目的代码上盛传github。

登陆界面

由斯类别简单又只是发生一个口开(大抵总人口付出来说,采用Storyboard不易于代码合并),加上Storyboard可以可视化的添加UI组件和Auto
Layout的束缚,并且可以预览多单不等分辨率iPhone的功用,极大地提高开发界面效率。

Login.png

登陆交互

登陆界面有Email输入框和密码输入框,当用户选中其他一个输入框时,左边对应之图标变成蓝色,同时会发出pop动画表示用户准备而输入内容。
当用户并未输入有效的Email或密码格式时,用户是勿能够点击登陆按钮,只有当用户输入有效的邮件与密码格式时,才能够点击登陆按钮。

Login.gif

我们得以行使RAC经监听Text
Field的UITextFieldTextDidBeginEditingNotificationUITextFieldTextDidEndEditingNotification的通告来处理用户选中Email输入框和密码输入框时改变图标和显示的卡通。

#pragma mark - Text Field notification
- (void)textFieldStartEndEditing
{
    // Respond to when email text start and end editing
    [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidBeginEditingNotification object:self.emailTextField] subscribeNext:^(id x) {
        [self.emailImageView animate];
        self.emailImageView.image = [UIImage imageNamed:@"icon-mail-active"];
        self.emailTextField.background = [UIImage imageNamed:@"input-outline-active"];
    }];

    [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidEndEditingNotification object:self.emailTextField] subscribeNext:^(id x) {
        self.emailTextField.background = [UIImage imageNamed:@"input-outline"];
        self.emailImageView.image = [UIImage imageNamed:@"icon-mail"];
    }];

    // Respond to when password text start and end editing
    [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidBeginEditingNotification object:self.passwordTextField] subscribeNext:^(id x) {
        [self.passwordImageView animate];
        self.passwordTextField.background = [UIImage imageNamed:@"input-outline-active"];
        self.passwordImageView.image = [UIImage imageNamed:@"icon-password-active"];
    }];

    [[[NSNotificationCenter defaultCenter] rac_addObserverForName:UITextFieldTextDidEndEditingNotification object:self.passwordTextField] subscribeNext:^(id x) {
        self.passwordTextField.background = [UIImage imageNamed:@"input-outline"];
        self.passwordImageView.image = [UIImage imageNamed:@"icon-password"];
    }];
}

当点击登陆按钮后,客户端向服务端发送验证请求,服务端验证了账户以及密码后,用户就是得以成功登陆。所以,接下要了解RESTful
API的基本概念和Designer News提供的RESTful API。

Designer News API

RESTful API基本概念和规划

REST齐全是Representational State
Transfer,翻译过来就是展现层状态转化。要想真正懂得它的含义,从几只主要字入手:Resource,
Representation, State Transfer

  • ##### Resource(资源)

资源就是网达到之实业,它可以是文、图片、声音、视频或一致种服务。但网络发生这么多资源,该怎么标识它们啊?你得据此URL(统一资源定位符)来唯一标识及定点它们。只要取得资源对应之URL,你便足以看它们。

  • ##### Representation(表现层)

资源是同一栽信息实体,它发强代表法。比如,文本可以用.txt格式表示,也足以为此xml、json或html格式表示。

  • ##### State Transfer(状态转换)

客户端访问服务端,服务端处理了晚回到客户端,在斯进程遭到,一般还见面挑起数据状态的反还是撤换。
客户端操作服务端,都是经HTTP协议,而在是HTTP协议中,有几乎个动词:GET,
POST, DELETEUPDATE

  • GET表示收获资源
  • POST表示新增资源
  • DELETE表示去资源
  • UPDATE表示更新资源

明白RESTful核心概念后,我们来概括了解RESTful API设计以便可以看懂Designer
News提供API。就将Designer News获取Stories对承诺URL的一个例来验证:
客户端请求
GET https://api-news.layervault.com/api/v1/stories?client_id=91a5fed537b58c60f36be1sdf71ed1320e9e4af2bda4366f7dn3d79e63835278

服务端返回结果(部分结实)

{
  "stories": [
    {
      "id": 46826,
      "title": "A Year of DuckDuckGo",
      "comment": "",
      "comment_html": null,
      "comment_count": 4,
      "vote_count": 17,
      "created_at": "2015-03-28T14:05:38Z",
      "pinned_at": null,
      "url": "https://news.layervault.com/click/stories/46826",
      "site_url": "https://api-news.layervault.com/stories/46826-a-year-of-duckduckgo",
      "user_id": 3334,
      "user_display_name": "Thomas W.",
      "user_portrait_url": "https://designer-news.s3.amazonaws.com/rendered_portraits/3334/original/portrait-2014-09-16_13_25_43__0000-333420140916-9599-7pse94.png?AWSAccessKeyId=AKIAI4OKHYH7JRMFZMUA&Expires=1459149709&Signature=%2FqqLAgqpOet6fckn4TD7vnJQbGw%3D",
      "hostname": "designwithtom.com",
      "user_url": "http://news.layervault.com/u/3334/thomas-wood",
      "badge": null,
      "user_job": "Online Designer at IDG UK",
      "sponsored": false,
      "comments": [
        {
          "id": 142530,
          "body": "Had no idea it had those customization settings — finally making the switch.",
          "body_html": "<p>Had no idea it had those customization settings — finally making the switch.</p>\\n",
          "created_at": "2015-03-28T18:41:37Z",
          "depth": 0,
          "vote_count": 0,
          "url": "https://api-news.layervault.com/comments/142530",
          "user_url": "http://news.layervault.com/u/3826/matt-soria",
          "user_id": 3826,
          "user_display_name": "Matt S.",
          "user_portrait_url": "https://designer-news.s3.amazonaws.com/rendered_portraits/3826/original/portrait-2014-04-12_11_08_21__0000-382620140412-5896-1udai4f.png?AWSAccessKeyId=AKIAI4OKHYH7JRMFZMUA&Expires=1459125745&Signature=%2BDdWMtto3Q10dd677sUOjfvQO3g%3D",
          "user_job": "Web Dood @ mattsoria.com",
          "comments": []
        },
  • 协议(protocol)
    用户和API通信采用HTTPs协议
  • 域名(domain name)
    相应尽可能部署到专用域名下https://api-news.layervault.com/,但有时见面更为扩充为https://api-news.layervault.com/api
  • 版本(version)
    应该将API版本号v1放入URL
  • 路径(Endpoint)
    路径https://api-news.layervault.com/api/v1/stories代表API具体网址,代表网同样栽资源,所以不能够生出动词,只有用名词来代表。
  • HTTP动词
    动词GET,表示从今服务端获取Stories资源
  • 过滤信息(Filtering)
    ?client_id=91a5fed537b58c60f36be1sdf71ed1320e9e4af2bda4366f7dn3d79e63835278指定client_id的Stories资源
  • 状态码(Status Codes)
    服务器向客户端返回表示成功或破产的状态码,状态码列表请参考Status
    Code
    Definitions
  • 错误处理(Error handling)
    服务端处理用户要失败后,一般都归error字段来代表错误信息

{
    error: "Invalid client id"
}

Designer News提供API

Designer News API
Reference供依据HTTP协议遵循RESTful设计的API,并且同意应用程序通过oAuth
2授权协议来取授权权限来拜会用户信息。

访问API工具

貌似的话,在形容访问服务端代码之前,我都见面为此Paw(下载地址)工具来测试API是否管用;另一方面,用JSON文件保留服务端返回的多寡,用于moco学服务端的服务。至于缘何要moco模拟服务端,后面会讲课,现在透过用户登录Designer
News
其一事例介绍如何下Paw来测试API。
我们先行看看Designer News提供访问用户登录的API

Designer News Login API.png

因上述提供的音,API的途径是https://api-news.layervault.com/oauth/token,参数有grant_typeusernamepasswordclient_secret。其中usernamepassword在Designer
News挂号才能够获,而client_idclient_secret亟待发送email到news@layervault.com申请。使用Paw发送请求和服务端返回结果如下:

New Send Request.png

Moco模拟服务端

Moco举凡一个足以轻松搭建测试服务器的工具。

怎要效法服务端

作为一个走开发人员,有时出于服务端开发进度慢,空来一个iPhone应用可发表不有图。幸好有了Moco,只待安排一下告与归数据,很快便好搭建一个仿服务,无需等待服务端支出好才能连续支付。当服务端完成后,修改访问地址即可。

偶然服务端API应该是呀体统都还未曾亮,由于来了moco模拟服务,在付出进程遭到,可以穿梭调整API设计,搞明白真正好想使的API是呀样子的。就这么,在服务端代码还并未当真动手前,已经提供相同客真正满足好用的API文档,剩下的哪怕交给劳务端照着API去贯彻就执行了。

再有同栽情况就是是,服务端已经勾勒好了,剩下客户端还没成功。由于moco是当地服务,访问速度比较快,所以通过动用moco来模拟服务端,这样不光可提高客户端的访问速度,还加强网络层测试代码访问速度的安定团结,Designer
News就是这么状况。

怎么样以Moco模拟服务

安装

如若您是利用Mac或Linux,可以品尝一下步骤:

  1. 规定你安装JDK 6以上
  2. 下载脚本
  3. 将她在你的$PATH路径
  4. 安装它好尽(chmod 755 ~/bin/moco)

当今公可运行一下命测试安装是否中标

  1. 编排配置文件foo.json,内容如下:

[
      {
        "response" :
          {
            "text" : "Hello, Moco"
          }
      }
]
  1. 运行Moco HTTP服务器
    moco start -p 12306 -c foo.json
  2. 开辟浏览器访问http://localhost:12306,你扭曲看见”Hello, Moco”
安排服务

由于发生早晚服务端返回的数较多,所以将服务端响应的多少独立于一个JSON文件中。以登陆为例,将数据存放于login_response.json

{
    "access_token": "4422ea7f05750e93a101cb77ff76dffd3d65d46ebf6ed5b94d211e5d9b3b80bc",
    "token_type": "bearer",
    "scope": "user",
    "created_at": 1428040414
}

苟用呼吁uri路径,方法(method)和参数(queries)等配置在login_conf.json文件中

[
  {
    "request" :
      {
        "uri" : "/oauth/token",
        "method" : "post",
        "queries" : 
          {
            "grant_type" : "password",
            "username" : "liuyaozhu13hao@163.com",
            "password" : "freedom13",
            "client_secret" : "53e3822c49287190768e009a8f8e55d09041c5bf26d0ef982693f215c72d87da",
            "client_id" : "750ab22aac78be1c6d4bbe584f0e3477064f646720f327c5464bc127100a1a6d"
          }
      },
    "response" :
      {
        "file" : "./Login/login_response.json"
      }
  }
]

未知情出无起留意到端uri路径不是清一色路线http://localhost:12306/oauth/token,因为商默认是http,而且一般运行于本机localhost,所以于起步拟服务经常只是待点名端口12306便实行。想更详实摸底如何布置,请查阅官网的HTTP(s)
APIs
再有一个急需安排地方即是,由于实在付出中必将不止一个客户端请求,所以还需一个布置文件settings.json来含有很有些请。

[
    {
        "include" : "./Story/stories_conf.json"
    },
    {
        "include" : "./Login/login_conf.json"
    },
    {
        "include" : "./Story/story_upvote_conf.json"
    }
]
开行服务

将路径跳反至DesignerNewsForObjc/DesignerNewsForObjcTests/JSON目录,找到settings.json文件,使用命令执行来启动服务:
moco start -p 12306 -g settings.json

动Paw验证是否配备成功

Send request to Local Server.png

行事令开发(BDD)

怎么要BDD

非懂得诸位在编辑测试的时段,有无发出想过一个题目:我应当测试什么?要报这问题并无是那么粗略,在从来不抱答案之前,你或继续遵循卿的想法编写测试。
-(void)testValidateEmail;
譬如这么的测试,存在一个向问题。它不会见报你应该会发什么,也未会见预期实际会发出啊。还有,当它们起误时,不会见唤起您当何来误,错误的来由是啊,因此若需要深刻代码才会知晓失败的因。这样就是需要大量格外和不必要之咀嚼负荷。
这时BDD出现了,帮助开发者确定应测试什么,它提供DSL(Domain-specific
language,
域特定语言),测试用例都照三段子式Given-When-Then的叙述,清晰地发表测试用例是测试什么样的靶子或数据结构,在依据什么上下文或气象,然后做出什么响应。
所以,我们应有关注行为,而不是测试。那行为具体是呀?当您设计app里面的里目标时,它的接口定义方法及其依赖关系,这些点子及凭借关系决定了您的目标如何跟其他对象交互,以及她的功能是什么,定义你的靶子的行为

BDD过程

行令开发大概三单步骤:

  1. 挑选最为要紧之作为,并编写行为之测试文件。此时,由于测试对象的好像还尚无编制,所以编译失败。创建测试目标的类并编制类的私自实现,让编译通过。
  2. 实现于测试类的表现,让测试通过。
  3. 假若发现代码中发出更代码,重构吃测试接近来驱除再

倘临时无知情里面步骤细节,没有涉及,继续朝下读,后面来例子介绍来赞助而懂得三独步骤的含义。

登陆验证

网访问层

DesignerNewsURL

DesignerNewsURL看似包装网络访问URL

#import <Foundation/Foundation.h>

extern NSString* const baseURL;
extern NSString* const clientID;
extern NSString* const clientSecret;

@interface DesignerNewsURL : NSObject

+ (NSString*)loginURLString;
+ (NSString*)stroiesURLString;
+ (NSString*)storyIdURLStringWithId:(NSInteger)storyId;
+ (NSString*)storyUpvoteWithId:(NSInteger)storyId;
+ (NSString*)storyReplyWithId:(NSInteger)storyId;
+ (NSString*)commentUpvoteWithId:(NSInteger)commentId;
+ (NSString*)commentReplyWithId:(NSInteger)commentId;

@end

这边尚来只技巧就是在DesignerNewsURL.m实现文件来个原则编译,判断是于测试环境还是产品环境来控制baseURL的值,可以很方便在测试环境与活环境相互切换。

#ifndef TEST
NSString* const baseURL = @"https://api-news.layervault.com";
#else
NSString* const baseURL = @"http://localhost:12306";
#endif

NSString* const clientID = @"750ab22aac78be1c6d4bbe584f0e3477064f646720f327c5464bc127100a1a6d";
NSString* const clientSecret = @"53e3822c49287190768e009a8f8e55d09041c5bf26d0ef982693f215c72d87da";
表现让开发LoginClient

在编制代码之前,我们该先想想如何统筹LoginClient恍如。首先根据Single
responsibility
principle(责任单一原则),LoginClient重在担负用户登录的大网访问。需要提供一个接口,只要加用户称(username)和密码(password),用户就会登录,由于自身是行使RAC来处理回来结果,所以是接口返回RACSignal对象。

  • 缔造一个LoginClientkiwi文件,编写对应行为。

Create LoginClient 1.png

Create LoginClient 2.png

SPEC_BEGIN(LoginClientSpec)

describe(@"LoginClient", ^{

    context(@"when user input correct username and password", ^{
      __block RACSignal *loginSignal;

      beforeEach(^{
          NSString *username = @"liuyaozhu13hao@163.com";
          NSString *password = @"freedom13";
          loginSignal = [LoginClient loginWithUsername:username password:password];
      });

      it(@"should return login signal that can't be nil", ^{
          [[loginSignal shouldNot] beNil];
      });

      it(@"should login successfully", ^{
          __block NSString *accessToken = nil;

          [loginSignal subscribeNext:^(NSString *x) {
              accessToken = x;
              NSLog(@"accessToken = %@", accessToken);
          }error:^(NSError *error) {
              [[accessToken shouldNot] beNil];
          } completed:^{
              [[accessToken shouldNot] beNil];
          } ];
      });

    });
});

SPEC_END

据悉三段式Given-When-Then叙,上面代码我们得以掌握啊:在吃定LoginClient对象,当用户输入是的用户称以及密码时,应该登录成功。
此刻,由于还未曾创建LoginClient接近,所以会见无经编译,创建LoginClient好像,并编制它的伪实现,让LoginClientSpec.m通过编译。

LoginClient.h.png

LoginClient.m.png

运作测试,测试失败。

LoginClient Failed.png

  • 心想事成LoginClient,通过该测试

LoginClient.m .png

LoginClient Pass Test.png

  • 鉴于无冗余代码,无需重构

Model层

是因为这次登陆请求服务端返回数据比较简单,只是得到access_token配段数据,所以不需model来照和存储数据。不过在得到多独Stories时,就见面用到model来处理。

Controller与ViewModel层

controller大凡拍卖用户交互的进口,通常自己都见面以拍卖用户交互的逻辑、数据绑定和数量校验都提交ViewModel来精简controller代码,同时最老程度地复用业务逻辑的代码。
咱事先想起用户登陆时的步骤:1.
用户优先输入email和密码,只有email和密码可格式要求时才能够点击按钮。2.
用户成功登陆后,跳反到故事列表主页。
俺们先分析一下如何促成步骤1,
想使针对性email和密码进行验证,必须使监听它们简单独价的变化,所以要对emailTextFieldpasswordTextField使用RAC拓展数量绑定。

创建LoginViewControllerSpeckiwi文件,测试绑定行为代码如下:

SPEC_BEGIN(LoginViewControllerSpec)

describe(@"LoginViewController", ^{
    __block LoginViewController *controller;

    beforeEach(^{
        controller = [UIViewController loadViewControllerWithIdentifierForMainStoryboard:@"LoginViewController"];
        [controller view];
    });

    afterEach(^{
        controller = nil;
    });

    describe(@"Email Text Field", ^{
        context(@"when touch text field", ^{
            it(@"should not be nil", ^{
                [[controller.emailTextField shouldNot] beNil];
            });
        });

        context(@"when text field's text is hello", ^{
            it(@"shoud euqal view model's email property", ^{
                controller.emailTextField.text = @"hello";
                [controller.emailTextField sendActionsForControlEvents:UIControlEventEditingChanged];
                [[controller.viewModel.email should] equal:@"hello"];
            });
        });
    });

    describe(@"Password Text Field", ^{
        context(@"when touch text field", ^{
            it(@"should not be nil", ^{
                [[controller.passwordTextField shouldNot] beNil];
            });
        });

        context(@"when text field' text is hello", ^{
            it(@"should equal view model's password property", ^{
                controller.passwordTextField.text = @"hello";
                [controller.passwordTextField sendActionsForControlEvents:UIControlEventEditingChanged];

                [[controller.viewModel.password should] equal:@"hello"];
            });
        });
    });
});

SPEC_END

此发生个别只主要点,一个凡是自从Storyboard中加载controller,否则不克取emailTextField和password,如果使用手写UI代码就未待了。另一个即使是emailTextField或passwordTextField必须调用sendActionsForControlEvents:UIControlEventEditingChanged计,才会触发textField的text属性改变。

编译失败后,在LoginViewController.m编写- (void)bindViewModel办法通过测试

RAC(self.viewModel, email) = self.emailTextField.rac_textSignal;
RAC(self.viewModel, password) = self.passwordTextField.rac_textSignal;

心想事成竣工数据绑定行为后,接下要多少校验,交给LoginViewModel来处理。创建LoginViewModelSpec.m文件,提供emailpassword属性给LoginViewModel,返回验证结果的RACSignal,测试证明行为代码如下:

SPEC_BEGIN(LoginViewModelSpec)

describe(@"LoginViewModel", ^{
    // Initialize
    __block LoginViewModel *viewModel;

    beforeEach(^{
        viewModel = [[LoginViewModel alloc] init];
    });

    afterEach(^{
        viewModel = nil;
    });

    context(@"when email and password is valid", ^{
        it(@"should get valid signal", ^{
            viewModel.email = @"liuyaozhu13hao@163.com";
            viewModel.password = @"123456";

            __block BOOL result;

            [[viewModel checkEmailPasswordSignal] subscribeNext:^(id x) {
                result = [x boolValue];
            } completed:^{
                [[theValue(result) should] beYes];
            }];
        });
    });

    context(@"when email is valid, but password is invalid", ^{
        it(@"should get invalid signal", ^{
            viewModel.email = @"liuyaozhu13hao@163.com";
            viewModel.password = @"1";

            __block BOOL result;

            [[viewModel checkEmailPasswordSignal] subscribeNext:^(id x) {
                result = [x boolValue];
            } completed:^{
                [[theValue(result) shouldNot] beYes];
            }];
        });
    });

    context(@"when password is valid, but email is invalid", ^{
        it(@"should get invalid signal", ^{
            viewModel.email = @"liuyaozhu";
            viewModel.password = @"123456";

            __block BOOL result;
            [[viewModel checkEmailPasswordSignal] subscribeNext:^(id x) {
                result = [x boolValue];
            } completed:^{
                [[theValue(result) shouldNot] beYes];
            }];
        });
    });
});

SPEC_END

编译失败后(已经创办LoginViewModel类),添加- (RACSignal*)checkEmailPasswordSignal并落实认证数据,通过测试

- (RACSignal*)checkEmailPasswordSignal
{
    RACSignal* emailSignal = RACObserve(self, email);
    RACSignal* passwordSignal = RACObserve(self, password);

    return [RACSignal combineLatest:@[ emailSignal, passwordSignal ] reduce:^(NSString* email, NSString* password) {
        BOOL result = [email isValidEmail] && [password isValidPassword];

        return @(result);
    }];
}

末尾用以LoginViewModel创建属性也loginButtonCommandRACCommand来拍卖点击登陆按钮的相互。在LoginViewControllerSpec.m测试loginButton.rac_command匪能够吧空

describe(@"Login Button", ^{
      context(@"when load view", ^{
            it(@"should be not nil", ^{
                [[controller.loginButton shouldNot] beNil];
            });

            it(@"should have rac command that not be nil", ^{
                [[controller.loginButton.rac_command shouldNot] beNil];
            });
      });
 });

测试失败,在LoginViewController.m编写- (void)bindViewModel艺术以下代码有

self.loginButton.rac_command = self.viewModel.loginButtonCommand;

LoginViewModel.m延期初始化loginButtonCommand属性

#pragma mark - Lazy initialization
- (RACCommand*)loginButtonCommand
{
    if (!_loginButtonCommand) {
        _loginButtonCommand = [[RACCommand alloc] initWithEnabled:[self checkEmailPasswordSignal] signalBlock:^RACSignal * (id input) {
            self.active = YES;

            return [[LoginClient loginWithUsername:self.email password:self.password] doNext:^(NSString *token) {
                self.active = NO;
                // Save the token
                [LocalStore saveToken:token];
                // Dismiss view controller and fetch data, reload
                self.dismissBlock();
            }];
        }];
    }

    return _loginButtonCommand;
}

经过测试,完成登陆基本流程,至于登陆成功后怎么回到故事列表页面,这里不详细介绍,各位可经过阅读工代码纵然可获答案。

总结

近期一段时间都再拘留有关敏捷开发的书(用户故事和便捷方法,硝烟中的Scrum和XP,
分析极限编程),对便捷开发很感兴趣,但发现很少公司还是博客介绍如何履行敏捷开发iOS,所以在网上搜集一些素材,发现发生很多佳绩之履(测试驱动开发,重构,持续集成测试,增量设计,增量计划)值得去学习,通过协调对迅速开发中各种实践的领悟来再写这Designer
News,这个Designer
News功能还并未尽完成,希望各位看了马上首稿子尝试以这样方式来好全套app。如果自身小意见或施行理解有无意,请各位多多点。

壮大阅读

  • ReactiveCocoa
    ReactiveCocoa –
    iOS开发之初框架
    ReactiveCocoa2实战
    ReactiveCocoa Essentials: Understanding and Using
    RACCommand
    Test with
    Reactivecocoa
  • Kiwi
    TDD的iOS开发初步与Kiwi使用入门
    Kiwi 使用上阶 Mock, Stub,
    参数捕获和异步测试
  • RESTful API
    理解RESTful架构
    RESTful API
    设计指南
    理解OAuth
    2.0
    SSL/TLS协议运行机制的概述
  • Moco
    Moco能集成测试,还会走支付;能前端开发,还能模仿Web服务器!
  • 测试
    表现令开发
    XCTest
    测试实战
    赖注入
    坏的测试
    换成测试: Mock, Stub
    和另外

发表评论

电子邮件地址不会被公开。 必填项已用*标注