AFNetworking 是当前 iOS 和 Mac OS X 开发中最广泛使用的开源项目之一。它帮助了成千上万叫好又叫座的应用,也为其它出色的开源库提供了基础。这个项目是社区里最活跃、最有影响力的项目之一,拥有 8700 个 star、2200 个 fork 和 130 名贡献者。
从各方面来看,AFNetworking 几乎已经成为主流。
但你有没有听说过它的新版呢?
AFNetworking 2.0。
这一周的 NSHipster:独家揭晓 AFNetworking 的未来。
声明:NSHipster 由 AFNetworking 的作者 撰写,所以这并不是对 AFNetworking 及它的优点的客观看法。你能看到的是个人关于 AFNetworking 目前及未来版本的真实看法。
AFNetworking 的大体思路
始于 2011 年 5 月,AFNetworking 作为一个已死的 LBS 项目中对 Apple 范例代码的延伸,它的成功更是由于时机。彼时ASIHTTPRequest 是网络方面的主流方案,AFNetworking 的核心思路使它正好成为开发者渴求的更现代的方案。
NSURLConnection + NSOperation
NSURLConnection
是 Foundation URL 加载系统的基石。一个 NSURLConnection
异步地加载一个 NSURLRequest
对象,调用 delegate 的 NSURLResponse
/ NSHTTPURLResponse
方法,其 NSData
被发送到服务器或从服务器读取;delegate 还可用来处理NSURLAuthenticationChallenge
、重定向响应、或是决定 NSCachedURLResponse
如何存储在共享的 NSURLCache
上。
NSOperation
是抽象类,模拟单个计算单元,有状态、优先级、依赖等功能,可以取消。
AFNetworking 的第一个重大突破就是将两者结合。AFURLConnectionOperation
作为 NSOperation
的子类,遵循NSURLConnectionDelegate
的方法,可以从头到尾监视请求的状态,并储存请求、响应、响应数据等中间状态。
Blocks
iOS 4 引入的 block 和 Grand Central Dispatch 从根本上改善了应用程序的开发过程。相比于在应用中用 delegate 乱七八糟地实现逻辑,开发者们可以用 block 将相关的功能放在一起。GCD 能够轻易来回调度工作,不用面对乱七八糟的线程、调用和操作队列。
更重要的是,对于每个 request operation,可以通过 block 自定义 NSURLConnectionDelegate
的方法(比如,通过setWillSendRequestForAuthenticationChallengeBlock:
可以覆盖默认的connection:willSendRequestForAuthenticationChallenge:
方法)。
现在,我们可以创建 AFURLConnectionOperation
并把它安排进 NSOperationQueue
,通过设置 NSOperation
的新属性completionBlock
,指定操作完成时如何处理 response 和 response data(或是请求过程中遇到的错误)。
序列化 & 验证
更深入一些,request operation 操作也可以负责验证 HTTP 状态码和服务器响应的内容类型,比如,对于 application/json
MIME 类型的响应,可以将 NSData 序列化为 JSON 对象。
从服务器加载 JSON、XML、property list 或者图像可以抽象并类比成潜在的文件加载操作,这样开发者可以将这个过程想象成一个 promise 而不是异步网络连接。
介绍 AFNetworking 2.0
AFNetworking 胜在易于使用和可扩展之间取得的平衡,但也并不是没有提升的空间。
在第二个大版本中,AFNetworking 旨在消除原有设计的怪异之处,同时为下一代 iOS 和 Mac OS X 应用程序增加一些强大的新架构。
动机
-
兼容 NSURLSession -
NSURLSession
是 iOS 7 新引入的用于替代NSURLConnection
的类。NSURLConnection
并没有被弃用,今后一段时间应该也不会,但是NSURLSession
是 Foundation 中网络的未来,并且是一个美好的未来,因为它改进了之前的很多缺点。(参考 WWDC 2013 Session 705 “What’s New in Foundation Networking”,一个很好的概述)。起初有人推测,NSURLSession
的出现将使 AFNetworking 不再有用。但实际上,虽然它们有一些重叠,AFNetworking 还是可以提供更高层次的抽象。AFNetworking 2.0 不仅做到了这一点,还借助并扩展NSURLSession
来铺平道路上的坑洼,并最大程度扩展了它的实用性。 -
模块化 - 对于 AFNetworking 的主要批评之一是笨重。虽然它的构架使在类的层面上是模块化的,但它的包装并不允许选择独立的一些功能。随着时间的推移,
AFHTTPClient
尤其变得不堪重负(其任务包括创建请求、序列化 query string 参数、确定响应解析行为、生成和管理 operation、监视网络可达性)。 在 AFNetworking 2.0 中,你可以挑选并通过 CocoaPods subspecs 选择你所需要的组件。 -
实时性 - 在新版本中,AFNetworking 尝试将实时性功能提上日程。在接下来的 18 个月,实时性将从最棒的 1% 变成用户都期待的功能。 AFNetworking 2.0 采用 Rocket 技术,利用 Server-Sent Event 和 JSON Patch 等网络标准在现有的 REST 网络服务上构建语义上的实时服务。
演员阵容
NSURLConnection
组件 (iOS 6 & 7)
AFURLConnectionOperation
-NSOperation
的子类,负责管理NSURLConnection
并且实现其 delegate 方法。AFHTTPRequestOperation
-AFURLConnectionOperation
的子类,用于生成 HTTP 请求,可以区别可接受的和不可接受的状态码及内容类型。2.0 版本中的最大区别是,你可以直接使用这个类,而不用继承它,原因可以在“序列化”一节中找到。AFHTTPRequestOperationManager
- 包装常见 HTTP web 服务操作的类,通过AFHTTPRequestOperation
由NSURLConnection
支持。
NSURLSession
组件 (iOS 7)
AFURLSessionManager
- 创建、管理基于NSURLSessionConfiguration
对象的NSURLSession
对象的类,也可以管理 session 的数据、下载/上传任务,实现 session 和其相关联的任务的 delegate 方法。因为NSURLSession
API 设计中奇怪的空缺,任何和NSURLSession
相关的代码都可以用AFURLSessionManager
改善。AFHTTPSessionManager
-AFURLSessionManager
的子类,包装常见的 HTTP web 服务操作,通过AFURLSessionManager
由NSURLSession
支持。
总的来说:为了支持新的
NSURLSession
API 以及旧的未弃用且还有用的NSURLConnection
,AFNetworking 2.0 的核心组件分成了 request operation 和 session 任务。AFHTTPRequestOperationManager
和AFHTTPSessionManager
提供类似的功能,在需要的时候(比如在 iOS 6 和 7 之间转换),它们的接口可以相对容易的互换。之前所有绑定在
AFHTTPClient
的功能,比如序列化、安全性、可达性,被拆分成几个独立的模块,可被基于NSURLSession
和NSURLConnection
的 API 使用。
序列化
AFNetworking 2.0 新构架的突破之一是使用序列化来创建请求、解析响应。可以通过序列化的灵活设计将更多业务逻辑转移到网络层,并更容易定制之前内置的默认行为。
-
<AFURLRequestSerializer>
- 符合这个协议的对象用于处理请求,它将请求参数转换为 query string 或是 entity body 的形式,并设置必要的 header。那些不喜欢AFHTTPClient
使用 query string 编码参数的家伙,你们一定喜欢这个。 -
<AFURLResponseSerializer>
- 符合这个协议的对象用于验证、序列化响应及相关数据,转换为有用的形式,比如 JSON 对象、图像、甚至基于 Mantle 的模型对象。相比没完没了地继承AFHTTPClient
,现在AFHTTPRequestOperation
有一个responseSerializer
属性,用于设置合适的 handler。同样的,再也没有没用的受NSURLProtocol
启发的 request operation 类注册,取而代之的还是很棒的responseSerializer
属性。谢天谢地。
安全性
感谢 Dustin Barker、Oliver Letterer、Kevin Harwood 等人做出的贡献,AFNetworking 现在带有内置的 SSL pinning 支持,这对于处理敏感信息的应用是十分重要的。
AFSecurityPolicy
- 评估服务器对安全连接针对指定的固定证书或公共密钥的信任。tl;dr 将你的服务器证书添加到 app bundle,以帮助防止 中间人攻击。
可达性
从 AFHTTPClient
解藕的另一个功能是网络可达性。现在你可以直接使用它,或者使用 AFHTTPRequestOperationManager
/AFHTTPSessionManager
的属性。
AFNetworkReachabilityManager
- 这个类监控当前网络的可达性,提供回调 block 和 notificaiton,在可达性变化时调用。
实时性
-
AFEventSource
-EventSource
DOM API 的 Objective-C 实现。建立一个到某主机的持久 HTTP 连接,可以将事件传输到事件源并派发到听众。传输到事件源的消息的格式为 JSON Patch 文件,并被翻译成AFJSONPatchOperation
对象的数组。可以将这些 patch operation 应用到之前从服务器获取的持久性数据集。
UIKit 扩展
之前 AFNetworking 中的所有 UIKit category 都被保留并增强,还增加了一些新的 category。
AFNetworkActivityIndicatorManager
:在请求操作开始、停止加载时,自动开始、停止状态栏上的网络活动指示图标。UIImageView+AFNetworking
:增加了imageResponseSerializer
属性,可以轻松地让远程加载到 image view 上的图像自动调整大小或应用滤镜。比如,AFCoreImageSerializer
可以在 response 的图像显示之前应用 Core Image filter。UIButton+AFNetworking
(新):与UIImageView+AFNetworking
类似,从远程资源加载image
和backgroundImage
。UIActivityIndicatorView+AFNetworking
(新):根据指定的请求操作和会话任务的状态自动开始、停止UIActivityIndicatorView
。UIProgressView+AFNetworking
(新):自动跟踪某个请求或会话任务的上传/下载进度。UIWebView+AFNetworking
(新): 为加载 URL 请求提供了更强大的API,支持进度回调和内容转换。
于是终于要结束 AFNetworking 旋风之旅了。为下一代应用设计的新功能,结合为已有功能设计的全新架构,有很多东西值得兴奋。
旗开得胜
将下列代码加入 Podfile
就可以开始把玩 AFNetworking 2.0 了:
For anyone coming over to AFNetworking from the current 1.x release, you may find the AFNetworking 2.0 Migration Guideespecially useful.
对于由 AFNetworking 1.x 版本转移到新版本的用户,你可以找到 AFNetworking 2.0 迁移指南。