一、综述
以下就是cocospod中AFNetworing除了几个分类外的所有类。类库的头文件AFNetworking.h引入了下面的所有类库,并可以根据不同的系统使用不同的实现方式。下面大体介绍下每个类的大致作用,主要以翻译API的注释文档为主。
<li>1:AFURLConnectionOperation
可以说是AFN最基础的类。继承自NSOperation类,将网络请求依附到一个operation上。从而让我们能够有效的控制并观察一个网络请求的创建、进行、取消、完成、暂停恢复
、异常等问题及状态。【第三部分详细分析实现以及功能】
<li>2:AFHTTPRequestOperation
HTTP或HTTPS协议请求的AFURLConnectionOperation的子类。它封装的可接受状态码和内容的类型,判定一个请求结果是成功或失败。实际上对系统的HTTP网络请求增加了几个HTTP需要用到的参数。
<li>3:AFHTTPRequestOperationManager
这个类是AFN类库的核心类。它封装完成了一种通用的模式,可以帮助我们轻松友好的完成请求的创建、响应的系列化,网络状态的监控以及安全策略以及每一个请求operation的管理(operation的相互依赖或状态改变)。
<li>4:AFURLSessionManager
iOS7之后,苹果增加了新的网络请求类--NSURLSession。AFN官方推荐iOS 7 或者 Mac OS X 10.9以上的,最好使用该类发起网络请求,取代AFHTTPRequestOperationManager。不过基于目前国内app大都最低适配的iOS6,该类的用途还不是太广泛。NSURLSession的说明或者使用不再赘述。自行查看API文档。以后有时间再加上该类的使用。
<li>5: AFURLSessionManager
继承自AFURLSessionManager。类似于1和2的关系。也是方便HTTP以及https请求的使用,增加了一些接口,方便调用。
<li>6:AFNetworkReachabilityManager
网络的连通状态监控以及网络的类型。实际是将苹果官方提供的Reachability的类名和通知名更换了一下,防止和系统提供的类的通知名以及类名的冲突。
<li>7:AFSecurityPolicy
这个我不太懂,安全策略的类。一般貌似用不到,有需要自行google。
<li>8:AFURLRequestSerialization
1:符合这个协议的对象用于处理请求,它将请求参数转换为 query string 或是 entity body 的形式,并设置必要的 header。
2:构建multipart请求。
<li>9:AFURLResponseSerialization
遵循AFURLResponseSerialization协议的对象,用于验证、序列化响应及相关数据,转换为有用的形式,比如 JSON 对象、图像、甚至基于mantle的模型对象。
二、重点类的实现分析
1、AFURLConnectionOperation的实现
1、综述
AFURLConnectionOperation将Operation和URLConnection结合到一起,利用operation可以监听到状态以及可以建立相互之间的依赖关系的特性,实现了对于一个NSURLConnection对象的完美控制,并将请求的结果通过block友好的返回。
2、实现文件.m
我们总结下.m中这个类主要有哪些方法。
<li>1:首先我们可以看到它创建了一个单例线程。这个线程将会常驻内存,用来处理AFN发起的所有请求任务。当然,线程也跟随着一个runloop,AFN将这个runloop的模式设置为NSDefaultRunLoopMode。NSDefaultRunLoopMode是无法检测到connection的状态的。这说明了,AFN将不会在这该线程处理connection完成后的UI刷新等工作,而是会将数据抛给主线程,让主线程去完成UI的刷新。
<li>2:我们可以看到该类通过接受请求的字符串,创建了URLRequest以及NSURLConnection对象。从而去进行请求。
<li>3:实现文件多次使用到了锁,可以保证数据的安全。当然他也实现了几个数据的NSCoping协议。
<li>4:请求的创建、进行、取消、完成、暂停恢复、异常等问题及状态的控制。这里讲一下暂停和恢复。暂停实际上将网络请求取消掉了。但是由于实现了nscoping协议,已经下载到数据得以保存下来。下次进行相同请求的时候,我们会将已经下载到的数据的节点一起发送给服务器,告诉服务器这些部门的数据我们不需要了,服务器根据我发送的返回节点给我返回相应的数据即可。从而实现了暂停和恢复功能,也就是断点续传。
<li>5:operation方法的重写。自行google,这里不赘述。
<li>6:状态的各种控制方法的实现以及发送状态改变的通知
3、接口文件.h
接口文档中的属性方法,基本可以概括为以下几个方法
<li>1:只读的数据,让管理者可以接收到。
<li>2:设置runloop的modes。不再使用类库默认设置的defaultmodes。
<li>3:状态的控制方法
<li>4:安全策略的设置总而言之,接口文件.h暴露的接口都是为了让manager可以去完全控制这个operation以及其中的网络请求。
2:AFHTTPRequestOperationManger
1、综述
这个类可以说是整个类库的核心类了。据说AFN2.0之前的时候,所有的网络请求相关的设置都杂糅到一个client中,导致client特别的臃肿。2.0后,AFN将一些设置提取出来,线程了专门的类【AFSecurityPolicy、AFURLRequestSerialization、AFURLResponseSerialization】。现在看来,AFN整体的设计是非常完美的。耦合性变得非常低,一些1.0版本中存在的问题也得到了改善。
2、实现文件.m
实现文件较为简单,可以看到他创建了一个队列。并将各个operation加入到队列中。在队列中,各个请求就可以设置依赖关系,并发的数量等等。
3、接口文件.h
接口文件中,我们可以看到。这个类可以设置AFSecurityPolicy、AFURLRequestSerialization、AFURLResponseSerialization 等参数了。这就是综述所说的降低耦合性的方式。基本使用很简单,这里就不再赘述了。