如果进行移动互联网的开发，客户端和服务器端在开发过程中的解耦很重要，如果任何调试，都要等待服务端完成之后才能进行，那将大大的拖累研发进度，所以通过模拟HTTP服务器，再加上单元测试技术，辅助客户端的开发就成为一项必要的工作。
1. Nocilla库是干什么的？
本文内容来主要来自于Nocilla的readme文件, Nocilla是一个开源的http stub库： github项目地址。
他的用途是在iOS和OSX系统上对HTTP进行stub，简化发出HTTP请求的单元测试。
Nocilla借鉴了WebMock库，使用了这篇文章中所采用的方法。
2. 功能特性
- 在单元测试中stub HTTP和HTTPS请求
- 支持NSURLConnection, NSURLSession 和 ASIHTTPRequest.
- 超棒的DSL将提升测试的可读性和可维护性
- 利用正则表达式匹配请求
- stub请求报错情况
- 可测试的
- 速度快
- 通过扩展支持更多的HTTP库的
3. 安装方法
- 使用CocoaPod安装
只需在Podefile中加入：
pod 'Nocilla' - 其他安装方法
你可以直接把Nocilla加入你的源码中。如果你使用git，考虑把它作为一个git子模块
4.使用方法
用法主要是
下面的代码是Objective-c的, 使用Kiwi描述。
4.1 通用部分：
在使用Nocilla的文件里：
<code>#import "LSNocilla.h"</code>
开始：
<code>[[LSNocilla sharedInstance] start];</code>
清理stub：
<code> [[LSNocilla sharedInstance] clearStubs];</code>
结束:
<code> [[LSNocilla sharedInstance] stop];</code>
4.2 Stubbing请求
- Stubing一个简单请求
它会返回一个默认的响应，返回200状态和空body。
<code>
stubRequest(@"GET", @"http://www.google.com");
</code> - stubbing 使用正则表达式描述的请求
<code>stubRequest(@"GET", @"^http://(.*?)\.example\.com/v1/dogs\.json".regex);</code> - Stubbing一个请求，返回特定的header
<code>stubRequest(@"GET", @"https://api.example.com").
withHeader(@"Accept", @"application/json");</code> - Stubing一个请求，请求带多重headers
使用 withHeaders方法，参数是一个字典
<code>stubRequest(@"GET", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"});
</code> - Stubbing一个请求，请求带特定的body
<code>stubRequest(@"POST", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"}).
withBody(@"{"name":"foo"}");
</code>
可以使用NSData作为请求数据:
<code>stubRequest(@"POST", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"}).
withBody([@"foo" dataUsingEncoding:NSUTF8StringEncoding]);
</code>
It even works with regular expressions!
甚至使用正则表达式做请求的body
<code>stubRequest(@"POST", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"}).
withBody(@"^The body start with this".regex);
</code>
4.3 模拟响应
- 返回响应，指定的status code
<code>stubRequest(@"GET", @"http://www.google.com").andReturn(404);</code> - 返回指定的响应status code和响应header
你可以使用withHeader或者withHeaders:
<code>stubRequest(@"POST", @"https://api.example.com/dogs.json").
andReturn(201).
withHeaders(@{@"Content-Type": @"application/json"});</code> - 返回响应，指定的status code, headers和body
<code>stubRequest(@"GET", @"https://api.example.com/dogs.json").
andReturn(201).
withHeaders(@{@"Content-Type": @"application/json"}).
withBody(@"{"ok":true}");</code> - 响应可以使用NSData作为响应的body
<code>
stubRequest(@"GET", @"https://api.example.com/dogs.json").
andReturn(201).
withHeaders(@{@"Content-Type": @"application/json"}).
withBody([@"bar" dataUsingEncoding:NSUTF8StringEncoding]);</code> - 使用curl -is返回raw responses(文件类的)
curl -is http://api.example.com/dogs.json > /tmp/example_curl_-is_output.txt
<code>stubRequest(@"GET", @"https://api.example.com/dogs.json").
andReturnRawResponse([NSData dataWithContentsOfFile:@"/tmp/example_curl_-is_output.txt"]);</code> - 用法全家福
<code>stubRequest(@"POST", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"}).
withBody(@"{"name":"foo"}").
andReturn(201).
withHeaders(@{@"Content-Type": @"application/json"}).
withBody(@"{"ok":true}");</code>
4.3使请求失败
这会调用failure handler(callback, delegate...不管已使用什么HTTP client)，返回特定的error
<code>
stubRequest(@"POST", @"https://api.example.com/dogs.json").
withHeaders(@{@"Accept": @"application/json", @"X-CUSTOM-HEADER": @"abcf2fbc6abgf"}).
withBody(@"{"name":"foo"}").
andFailWithError([NSError errorWithDomain:@"foo" code:123 userInfo:nil]);</code>
4.4 意料之外的请求
如果有些请求没有被stubbed，却发出了，Nocilla不会让它传到真实的网络上。请求会失败，并且产生一个异常，异常提供了错误的信息以及解决的方法，甚至提供了如何stub这个请求的代码片段。
5. Nocilla谁在用.
Groupon
Pixable
Jackthreads
ShopKeep
Other alternatives
ILTesting
OHHTTPStubs
Contributing
Fork it
Create your feature branch
Commit your changes
Push to the branch
Create new Pull Request
