AFNetworking原理及常用操作

AFN的六大模块

---

• NSURLConnection，主要对NSURLConnection进行了进一步的封装，包含以下核心的类：

  • AFURLConnectionOperation
  • AFHTTPRequestOperationManager
  • AFHTTPRequestOperation

• NSURLSession，主要对象NSURLSession对象进行了进一步的封装，包含以下核心的类：

  • AFURLSessionManager
  • AFHTTPSessionManager

• Reachability，提供了与网络状态相关的操作接口，包含以下核心的类：

  • AFNetworkReachabilityManager

• Security，提供了与安全性相关的操作接口，包含以下核心的类：

  • AFSecurityPolicy

• Serialization，提供了与解析数据相关的操作接口，包含以下核心的类：

  • AFURLRequestSerialization
  • AFURLResponseSerialization

• UIKit，提供了大量网络请求过程中与UI界面显示相关的操作接口，通常用于网络请求过程中提示，使用户交互更加友好，包含以下核心的分类/类：

  • AFNetworkActivityIndicatorManager
  • UIActivityIndicatorView+AFNetworking
  • UIAlertView+AFNetworking
  • UIButton+AFNetworking
  • UIImageView+AFNetworking
  • UIKit+AFNetworking
  • UIProgressView+AFNetworking
  • UIRefreshControl+AFNetworking
  • UIWebView+AFNetworking

AFURLSessionManager

---

• 创建任务的方法

  • 普通任务

    - (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler/*** request：请求对象* completionHandler：请求完成调用的Block * response：服务器的响应信息* responseObject：服务器返回的数据* error：错误信息*/

  • 上传任务(分别上传不同类型的文件)

    // 1. 上传文件类型的数据- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromFile:(NSURL *)fileURL progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler/*** fileURL：所要上传文件的路径*/// 2. 上传NSData类型的数据- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromData:(NSData *)bodyData progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler/*** bodyData：所要上传的文件数据*/// 3. 上传流数据- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler/*** request：通过流数据初始化的请求对象*/

  • 下载任务

    // 1. 普通下载任务- (NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request progress:(NSProgress * __autoreleasing *)progress destination:(NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination completionHandler:(void (^)(NSURLResponse *response, NSURL *filePath, NSError *error))completionHandler/*** progress：管理下载进度* destination：保存数据调用的Block* targetPath：数据的保存路径* 服务器的响应信息*/// 2. 支持断点下载的下载任务- (NSURLSessionDownloadTask *)downloadTaskWithResumeData:(NSData *)resumeData progress:(NSProgress * __autoreleasing *)progress destination:(NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination completionHandler:(void (^)(NSURLResponse *response, NSURL *filePath, NSError *error))completionHandler /*** progress：管理下载进度* resumeData：断点下载时的断点信息*/                                   

AFHTTPSessionManager

---

• 常用的属性

  • baseURL(NSURL *)，用于监视网络可达性与创建请求对象
  • requestSerializer(AFHTTPRequestSerializer *)，指定指定GET、HEAD与DELETE请求参数的解析格式
  • responseSerializer(AFHTTPResponseSerializer *)，用于指定服务器返回数据的格式

• 常用方法

  • 初始化

    // 1. 通过工厂方法创建AFHTTPSessionManager对象+ (instancetype)manager// 2. 通过构造方法创建AFHTTPSessionManager对象- (instancetype)initWithBaseURL:(NSURL *)url/*** 根据url初始化AFHTTPSessionManager对象*/- (instancetype)initWithBaseURL:(NSURL *)url sessionConfiguration:(NSURLSessionConfiguration *)configuration/*** 根据url与configuration初始化AFHTTPSessionManager对象*/

  • 请求数据

    // 1. GET请求- (NSURLSessionDataTask *)GET:(NSString *)URLString parameters:(id)parameters success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure/*** URLString：请求路径* parameters：请求参数* success：请求成功时调用的Block* responseObject：服务器返回的数据* failure：请求失败时调用的Block* error：错误信息*/// 2. POST请求- (NSURLSessionDataTask *)POST:(NSString *)URLString parameters:(id)parameters success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure/*** 参数含义与GET请求相同*/- (NSURLSessionDataTask *)POST:(NSString *)URLString parameters:(id)parameters constructingBodyWithBlock:(void (^)(id <AFMultipartFormData> formData))block success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure/*** block：用于创建多个数据来源*/

使用AFN请求网络数据

---

• 请求数据（XML/JSON）

  • 创建AFHTTPSessionManager对象

    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

  • 指定对服务器的返回数据格式

    //以XML文档的形式返回数据manager.responseSerializer = [AFXMLParserResponseSerializer serializer];//以JSON形式返回数据manager.responseSerializer = [AFJSONResponseSerializer serializer];

  • 设置请求体(类型为XML或JSON)

    // 请求体通常由服务器指定格式NSDictionary *params = @{                         @"username" : @"账号",                         @"pwd" : @"密码",                         @"type" : @"XML/JSON"                         };                             

  • 发送请求

    [manager GET:@"请求路径" parameters:params success:^(NSURLSessionDataTask *task, id responseObject) {//responseObject：服务器返回的数据    NSLog(@"请求成功");} failure:^(NSURLSessionDataTask *task, NSError *error) {//error：错误信息    NSLog(@"请求失败");}];

• 上传数据

  • 创建AFHTTPSessionManager对象

    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

  • 创建上传任务

    /**基于NSURLConnection*/[manager POST:@"请求路径" parameters:@{@"用户名" : @"密码" constructingBodyWithBlock:^(id<AFMultipartFormData> formData) { //设置需要上传的文件    NSData *data = [NSData dataWithContentsOfFile:@"所要长传文件的路径"];    [formData appendPartWithFileData:data name:@"file" fileName:@"test.png" mimeType:@"image/png"];} success:^(NSURLSessionDataTask *task, id responseObject) {          //上传成功} failure:^(NSURLSessionDataTask *task, NSError *error) {    //上传失败}];/**基于NSURLSession*/[manager uploadTaskWithRequest:request fromData:data progress:progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {    //上传数据成功}];

• 下载数据

  • 创建AFHTTPSessionManager对象

    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

  • 创建下载任务

    /**基于NSURLSession*/[manager downloadTaskWithRequest:request progress:progress destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {    // 存储下载数据是调用的Block} completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {    //下载完成时调用的Block}]