AFNetWorking的原理及常用操作

一.简介

AFNetworking是一个轻量级的iOS网络通信类库,它建立在NSURLConnection和NSOperation等类库的基础上。AFNetworking可用于发送HTTP请求(包括GET、POST、 PUT、DELETE等),接收HTTP的响应,但是不会缓存服务器的响应,不能执行HTML页面中的JAvascript代码,同时,AFNetworking还内置支持JSON,plist文件和XML文件的解析,使用比较方便。

二.AFN的六大模块

1.主要对NSURLConnection进行了进一步的封装(iOS9-NSURLConnection已经不能使用),包含以下核心的类:

AFURLConnectionOperation
AFHTTPRequestOperationManager
AFHTTPRequestOperation

2.要对象NSURLSession对象进行了进一步的封装,包含以下核心的类:

AFURLSessionManager
AFHTTPSessionManager

3.Reachability,提供了与网络状态相关的操作接口,包含以下核心的类:

AFNetworkReachabilityManager

4.Security,提供了与安全性相关的操作接口,包含以下核心的类:

AFSecurityPolicy

5.Serialization,提供了与解析数据相关的操作接口,包含以下核心的类:

AFURLRequestSerialization
AFURLResponseSerialization

6.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
}]
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • 13.服务器图片改了,url没有变,需求,服务器的图片变了,就从服务器加载图片,如果服务器的没变,就从本地加载 1...
    AlanGe阅读 5,151评论 0 1
  • AFN 2.x 的六大模块: NSURLConnection 主要对NSURLConnection进行了进一步的封...
    CoderLocus阅读 11,719评论 2 26
  • 首先祝中国足球队胜利,虽然我不看足球。 在正式开始之前,给大家看一段话:这也是前段时间朋友圈有人发的。 -----...
    联络兵阅读 2,299评论 0 0
  • 亲爱的晋善: 一次,爸爸下班回来,匆匆地走进房间,然后抱起你,开始在房间里走来走去,豆丁妈妈吗就问我,在学校里的时...
    丁爸阅读 3,671评论 0 50
  • 昨天已经到工作的地方了,感觉心情很郁闷真不想离开家,在离开家前爸妈已经给我做好了准备早早就为我做起了饭。我爸...
    小草_379e阅读 1,315评论 0 1

友情链接更多精彩内容