AFNetworking 理解<一>[入门级]

AFN框架的横空出现是我等程序员请求数据时的一个大招，现在就紧跟我的脚步咱们简要看看其内部原理，先上图，我们再说话： 

AFN封装了NSURLConnection和NSURLSession的功能，只需一行代码我们就可以轻松愉快的请求数据了还有两个辅助功能就是：安全策略（HTTPS）和网络连接状态（Reachability）：

我感觉最好的就是Json数据的序列话和反序列话，但是对于XML数据的解析就有点扯淡了！

AFN请求和相应的数据格式已经默认设置： 

 设置请求的数据格式：self.requestSerializer = [AFHTTPRequestSerializer serializer]; // 二进制 

设置相应的数据格式：self.responseSerializer = [AFJSONResponseSerializer serializer]; // 默认是JSON

 AFN可供选择的请求格式有：

 AFHTTPRequestSerializer 二进制的(默认的) 

 AFJSONRequestSerializer JSON 

 AFPropertyListRequestSerializer PList 

 AFN可供选择的响应的格式： 

 AFHTTPResponseSerializer 二进制的 

AFJSONResponseSerializer JSON(默认的) 

AFXMLParserResponseSerializer XMLParser 

AFXMLDocumentResponseSerializer XML DOM(仅 MAC 可用) 

AFPropertyListResponseSerializer PList 

 AFImageResponseSerializer 图像 

 AFCompoundResponseSerializer 组合 

对于常规的网络请求数据格式如下（不做任何修改） －发送数据的格式，就是二进制的 －接收的数据格式，JSON是最流行的数据格式，没有之一！ 最坑的就是AFN对于返回数据是XML类型的，顿时傻逼了！！这可怎么办？唯一的办法只有我们自己手动解析了！

解析XML文件有两种方式：

SAX解析：manager.responseSerializer = [AFXMLParserResponseSerializer serializer]; 

DOM解析：manager.responseSerializer = [AFHTTPResponseSerializer serializer];但是DOM解析的话只实用于小文件。 如果我们要请求 Image图像数据的话最好实用 SDWebImage框架，因为它的缓存机制是屌爆的。

 综上所述：AFN框架的主要作用就是进行数据的传输和简单的数据解析，在这里我们不需要考虑HTTP和线程间的通讯问题，因为返回来的数据就在主线程内。

一、AFNetworking作用

AFNetworking可以用于发送HTTP请求，接受HTTP响应，但是不会缓存服务器响应，不能执行HTML页面中的JAvascript代码，同时，AFNetworking还内置支持JSON，plist文件和XML文件解析，使用起来比较方便。

扩展：

 Session：就是指某个客户端在访问服务器起到停止访问这段时间间隔内被称为时域。

Cookie：由服务器发送给客户端，把Cookie的key:value值储存在本地文件夹下，当下次请求的时候能够直接发送Cookie获得权限验证。

二、AFNetworking怎么用？

1、提交Get[获取]、Post[发送“有两种形式”]、Put[将....送往]、Patch[修补]、Delete[删除]请求。

上述几种方法基本上都遵循这几个步骤：

1>.调用self.requestSerializer的requestWithMethod:URLString:Parameters:Error 方法得到一个request。

2>.用这个request作为参数传入HTTPRequestOperationWithRequest:Success:Failure 这个方法中得到一个operation。

3>.将operation加入到请求列队里面开始请求。

2、创建一个下载文件的任务。（NSURLSessionDownLoadTask）

3、创建一个上传文件的任务。（NSURLSessionloadTask）

4、处理JSON或者Plist响应。

三、AFNetworking的源码实现。

1、AFURLConnectionOperation ----AFNetworking最核心的类。

    1>、NSURLConnection是被设计成异步发送的，调用了start方法后，NSURLConnection会新建一些线程用底层的CFScoket去发送和接收请求，在发送和接收的一些事件发生后通知原来线程的Runloop去回调事件。                        2>.NSURLConnection发送有以下三种方式：在主线程调异步接口，在子线程调同步接口，在子线程调异步接口。而AFNetworking使用的是在子线程调异步接口。

2、AFURLConnectionOperation类的实现

    ①：综述

AFURLConnectionOperation 将Operation和URLConnection结合到一起，利用operation可以监听到状态以及可以建立相互之间的依赖关系的特性，实现了对于 一个NSURLConnection对象的完美控制，并将请求的结果通过block友好的返回。

    ②：接口文件.h

接口文档中的属性方法，基本可以概括为以下几个方法

    1>、只读的数据，让管理者可以接收到。

    2>、设置runloop的modes。不再使用类库默认设置的defaultmodes。

    3>、状态的控制方法

    4>、安全策略的设置

总而言之，接口文件.h暴露的接口都是为了让manager可以去完全控制这个operation以及其中的网络请求。

    ③：实现文件.m

我们总结下.m中这个类主要有哪些方法。

    1>、 首先我们可以看到它创建了一个单例线程。这个线程将会常驻内存，用来处理AFN发起的所有请求任务。当然，线程也跟随着一个runloop，AFN将这个 runloop的模式设置为NSDefaultRunLoopMode。NSDefaultRunLoopMode是无法检测到connection的状 态的。这说明了，AFN将不会在这该线程处理connection完成后的UI刷新等工作，而是会将数据抛给主线程，让主线程去完成UI的刷新。

    2>、我们可以看到该类通过接受请求的字符串，创建了URLRequest以及NSURLConnection对象。从而去进行请求。

    3>、实现文件多次使用到了锁，可以保证数据的安全。当然他也实现了几个数据的NSCoping协议。

    4>、请求的创建、进行、取消、完成、暂停恢复、异常等问题及状态的控制。这里讲一下暂停和恢复。

暂 停实际上将网络请求取消掉了。但是由于实现了nscoping协议，已经下载到数据得以保存下来。下次进行相同请求的时候，我们会将已经下载到的数据的节 点一起发送给服务器，告诉服务器这些部门的数据我们不需要了，服务器根据我发送的返回节点给我返回相应的数据即可。从而实现了暂停和恢复功能，也就是断点 续传。

    5>、operation方法的重写。自行google，这里不赘述。

    6>、状态的各种控制方法的实现以及发送状态改变的通知

3、AFHTTPRequestOperationManger类的实现

    ①：综述

这个类可以说是整个类库的核心类了。据说AFN2.0之前的时候，所有的网络请求相关的设置都杂糅到一个client中，导致client特别的臃肿。2.0后，AFN将一些设置提取出来，线程了专门的类【AFSecurityPolicy、AFURLRequestSerialization、AFURLResponseSerialization】。现在看来，AFN整体的设计是非常完美的。耦合性变得非常低，一些1.0版本中存在的问题也得到了改善。

    ②：接口文件.h

接口文件中，我们可以看到。这个类可以设置AFSecurityPolicy、AFURLRequestSerialization、AFURLResponseSerialization 等参数了。这就是综述所说的降低耦合性的方式。基本使用很简单，这里就不再赘述了。

    ③：实现文件.m

实现文件较为简单，可以看到他创建了一个队列。并将各个operation加入到队列中。在队列中，各个请求就可以设置依赖关系，并发的数量等等。

4、setCompleteBlock  、锁、序列化、backgroundTask

    1>、setCompleteBlock：AFNetwoking重写NSOperation提供的setCompletionBlock，用于任务完成时回调传进来的block，并且实现消除循环引用。

    2>、锁：AFURLConnectionOperation  有一把递归锁，在所有会访问/修改成员变量的外接口都加了锁，因为这些对外的接口用户是可以在任意线程调用的，对于访问和修改成员变量的接口，必须用锁保证线程安全。

    3>、序列化：AFNetworking的多数类都支持序列化，实现的是NSSecureCoding的接口，用-decodeObjectOfClass：forKey：方法，指定Class保证序列化后的数据不被篡改，若不指定Class，decode出来的对象可能不是原来的对象，有潜在的风险。

    4>、backgroundTask:这里提供了setShouldExecuteAsBackgroundTaskWithExpirationHandler接口，决定APP进入后台后是否继续发送接收请求，并在后台执行时间超时后取消所有请求。在dealloc 里需要调用[application endBackgroundTask:],告诉系统这个后台任务已经完成，不然系统会一直让你的APP运行在后台，直到超时。

3、浅谈AFHTTPRequestOperation  和 AFHTTPRequsetOperationManager

AFHTTPRequestOperation  继承了AFURLConnectionOperation，实现的功能比较少，主要多了responseSerializer，暂停下载，断点续传，以及提供接口请求成功失败的回调接口。理解了AFURLConnectionOperation,就会觉得AFHTTPRequestOperation比较简单，所以具体的就不写了。

AFHTTPRequsetOperationManager封装了AFNetworking其他功能的各个模块，如AFHTTPRequestSerializer(请求序列化)、AFHTTPResponseSerializer(响应序列化)、AFNetworkReachabilityManager(可达性)、AFSecurityPolicy(安全策略)，封装了HTTP请求所有相关的代码.并且将所有的请求添加到同一个NSOperationQueue请求队列里。并且封装HTTP请求的常见方式如Get、Post 、Put 、Patch、Delete等。

四、AFNetworking常见的简单的用法

1、GET请求

//获得网络请求管理者

AFHTTPRequestOperationManager  *manager = [AFHTTPRequestOperationManager manager]；

manager.responseSerializer = [AFJSONResponseSerializer serializer];

//发送网络请求

[manager GET:@"http://localhost/demo.json" parameters:nil  success:^(AFHTTPRequestOperation * operation,id responseObject)

{

}failure :^(AFHTTPRequestOperation * operation,NSError * error)

{

}

];

2、post请求XML  

AFHTTPRequestOperationManager * manager = [AFHTTPRequestOperationManager manager];

//修改相应解析对象

manager.responseSerializer = [AFXMLParserResponseSerializer serializer];

//发送网络请求

[manager POST:@"http//localhost/videos.xml" parameter:nil success:^(AFHTTPRequestOperation * operation,id responseObject)

{

}failure:^(AFHTTPRequestOperation * operation,NSErrpr * error)

{

}];

3、带有表单参数的POST请求

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

NSDictionary *parameters = @{@"foo": @"bar"};

[manager POST:@"http://example.com/resources.json" parameters:parameters success:^(AFHTTPRequestOperation *operation, id responseObject) {

    NSLog(@"JSON: %@", responseObject);

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

    NSLog(@"Error: %@", error);

}];

4、Multi-Part格式的表单文件上传POST请求

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

NSDictionary *parameters = @{@"foo": @"bar"};

NSURL *filePath = [NSURL fileURLWithPath:@"file://path/to/image.png"];

[manager POST:@"http://example.com/resources.json" parameters:parameters constructingBodyWithBlock:^(id formData) {

    [formData appendPartWithFileURL:filePath name:@"image" error:nil];

} success:^(AFHTTPRequestOperation *operation, id responseObject) {

    NSLog(@"Success: %@", responseObject);

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

    NSLog(@"Error: %@", error);

}];

5、创建一个下载任务

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];

AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];

NSURLRequest *request = [NSURLRequest requestWithURL:URL];

NSURL *filePath = [NSURL fileURLWithPath:@"file://path/to/image.png"];

NSURLSessionUploadTask *uploadTask = [manager uploadTaskWithRequest:request fromFile:filePath progress:nil completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {

    if (error) {

        NSLog(@"Error: %@", error);

    } else {

        NSLog(@"Success: %@ %@", response, responseObject);

    }

}];

[uploadTask resume];

6、创建一个数据流任务

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];

AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];

NSURLRequest *request = [NSURLRequest requestWithURL:URL];

NSURLSessionDataTask *dataTask = [manager dataTaskWithRequest:request completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {

    if (error) {

        NSLog(@"Error: %@", error);

    } else {

        NSLog(@"%@ %@", response, responseObject);

    }

}];

[dataTask resume];

7、通过GET方式

NSURL *URL = [NSURL URLWithString:@"http://example.com/resources/123.json"];

NSURLRequest *request = [NSURLRequest requestWithURL:URL];

AFHTTPRequestOperation *op = [[AFHTTPRequestOperation alloc] initWithRequest:request];

op.responseSerializer = [AFJSONResponseSerializer serializer];

[op setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {

    NSLog(@"JSON: %@", responseObject);

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

    NSLog(@"Error: %@", error);

}];

[[NSOperationQueue mainQueue] addOperation:op];

8、连续操作多个

NSMutableArray *mutableOperations = [NSMutableArray array];

for (NSURL *fileURL in filesToUpload) {

    NSURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:@"http://example.com/upload" parameters:nil constructingBodyWithBlock:^(id formData) {

        [formData appendPartWithFileURL:fileURL name:@"images[]" error:nil];

    }];

    AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];

    [mutableOperations addObject:operation];

}

NSArray *operations = [AFURLConnectionOperation batchOfRequestOperations:@[...] progressBlock:^(NSUInteger numberOfFinishedOperations, NSUInteger totalNumberOfOperations) {

    NSLog(@"%lu of %lu complete", numberOfFinishedOperations, totalNumberOfOperations);

} completionBlock:^(NSArray *operations) {

    NSLog(@"All operations in batch complete");

}];

[[NSOperationQueue mainQueue] addOperations:operations waitUntilFinished:NO];

五、总结

    1.AFURLConnectionOperation

    可以说是AFN最基础的类。继承自NSOperation类，将网络请求依附到一个operation上。从而让我们能够有效的控制并观察一个网络请求的创建、进行、取消、完成、暂停恢复、异常等问题及状态。

    2.AFHTTPRequestOperation 

    HTTP或HTTPS协议请求的AFURLConnectionOperation的子类。它封装的可接受状态码和内容的类型，判定一个请求结果是成功或失败。实际上对系统的HTTP网络请求增加了几个HTTP需要用到的参数.虽然AFHTTPRequestOperationManager通常是最好的去请求的方式，但是AFHTTPRequestOpersion也能够单独使用。

    3.AFHTTPRequestOperationManager 

    这个类是AFN类库的核心类。它封装完成了一种通用的模式，可以帮助我们轻松友好的完成请求的创建、响应的系列化，网络状态的监控以及安全策略以及每一个请求operation的管理（operation的相互依赖或状态改变）.该类封装与Web应用程序进行通信通过HTTP，包括要求制作，响应序列化，网络可达性监控和安全性，以及要求经营管理的常见模式。

    4.AFURLRequestSerialization 

       1>、符合这个协议的对象用于处理请求，它将请求参数转换为 query string 或是 entity body 的形式，并设置必要的 header.

      2>、构建Multipart请求.

    5.AFURLResponseSerialization 

    遵循AFURLResponseSerialization协议的对象，用于验证、序列化响应及相关数据，转换为有用的形式，比如 JSON 对象、图像、甚至基于mantle的模型对象.

    6.AFNetworkReachabilityManager 

    网络的连通状态监控以及网络的类型。实际是将苹果官方提供的Reachability的类名和通知名更换了一下，防止和系统提供的类的通知名以及类名的冲突

    7.AFURLSessionManager

     iOS7 之后，苹果增加了新的网络请求类--NSURLSession。AFN官方推荐iOS 7 或者 Mac OS X 10.9以上的，最好使用该类发起网络请求，取代AFHTTPRequestOperationManager。不过基于目前国内app大都最低适配的 iOS6，该类的用途还不是太广泛。创建和管理制定的NSURLSession对象。NSURLSessionConfiguration对象必须实现, , , 协议。

    8.AFSecurityPolicy

        网络通讯安全策略模块