最近一直在研究AFN,觉得有必要记录一下自己的心得,一是可以自己加深印象,二是可以帮助一下不太了解AFN的人,都是自己的一些观点,若有错误之处,还请大神帮忙指出来!觉得鸡肋的请略过,谢谢!
AFN最新版本已经来到了3.x了,也从以前基于NSURLConnection重构到基于NSURLSession的新版本。新版本的AFN更加简洁你只需要知道几个主要的类就可以了解AFN的工作流程。先列举一下:
1、AFURLSessionManager;
2、AFHTTPSessionManager;
3、AFURLRequestSerialization;
4、AFURLResponseSerialization;
AFURLSessionManager 是AFN的核心文件,集成了管理请求的建立、管理、销毁、安全、请求重定向、请求重启等功能。主要实现了对NSURLSession和NSURLSessionTask的封装,以及重定向处理结果。
AFHTTPSessionManager 是AFURLSessionManager的子类,主要用于处理HTTP和HTTPS的请求,我们平时用的最多的也是这个类,对这个类做一个二次封装,然后完成我们请求接口的业务。
AFURLRequestSerialization这个类说白了就是创建一个NSURLRequest请求体,AFN直接把这一块给抽离出来,把所有关于request的业务都放在了这里,如设置GET\POST方法,设置请求头、超时时间、请求的缓存策略、如何处理请求参数(GET与POST的方法不同),清晰明了!
AFURLResponseSerialization 很明显这个类是用来处理网络请求的返回值的。对返回数据序列化、编码解码、数据处理等。这里AFURLResponseSerialization只是一个协议,AFHTTPResponseSerializer类遵守这个协议,实现了协议方法,还有其他几个类继承了AFHTTPResponseSerializer,如:AFJSONResponseSerializer、AFXMLParserResponseSerializer、AFPropertyListResponseSerializer、AFImageResponseSerializer,所以在处理数据的时候,看你的返回值是什么类型的就用那个类去处理就好了,AFN使用的是AFJSONResponseSerializer。
废话不多说,上代码:
1、AFHTTPSessionManager中,常用的两个请求方法,POST\GET方法
- (NSURLSessionDataTask *)POST:(NSString *)URLString
parameters:(id)parameters
progress:(void (^)(NSProgress * _Nonnull))uploadProgress
success:(void (^)(NSURLSessionDataTask * _Nonnull, id _Nullable))success
failure:(void (^)(NSURLSessionDataTask * _Nullable, NSError * _Nonnull))failure
{
NSURLSessionDataTask *dataTask = [self dataTaskWithHTTPMethod:@"POST" URLString:URLString parameters:parameters uploadProgress:uploadProgress downloadProgress:nil success:success failure:failure];
[dataTask resume];
return dataTask;
}
- (NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(id)parameters
progress:(void (^)(NSProgress * _Nonnull))downloadProgress
success:(void (^)(NSURLSessionDataTask * _Nonnull, id _Nullable))success
failure:(void (^)(NSURLSessionDataTask * _Nullable, NSError * _Nonnull))failure
{
NSURLSessionDataTask *dataTask = [self dataTaskWithHTTPMethod:@"GET"
URLString:URLString
parameters:parameters
uploadProgress:nil
downloadProgress:downloadProgress
success:success
failure:failure];
[dataTask resume];
return dataTask;
}
//两个方法都调用了dataTaskWithHTTPMethod:这个方法,返回一个task,这个task就是我们的请求任务。拿到这个//task我们还可以Cancel请求。下面去看看 dataTaskWithHTTPMethod:这个方法。
- (NSURLSessionDataTask *)dataTaskWithHTTPMethod:(NSString *)method
URLString:(NSString *)URLString
parameters:(id)parameters
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgress
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgress
success:(void (^)(NSURLSessionDataTask *, id))success
failure:(void (^)(NSURLSessionDataTask *, NSError *))failure
{
NSError *serializationError = nil;
//这里使用requestSerialize 去获取一个request请求体,如果是post就把参数设置在body里,如果是get就把键值对添加到url后面,关于baseURL使用的时候可以去SDK的介绍中去看看,介绍的很清楚。
NSMutableURLRequest *request = [self.requestSerializer requestWithMethod:method URLString:[[NSURL URLWithString:URLString relativeToURL:self.baseURL] absoluteString] parameters:parameters error:&serializationError];
if (serializationError) {
if (failure) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wgnu"
dispatch_async(self.completionQueue ?: dispatch_get_main_queue(), ^{
failure(nil, serializationError);
});
#pragma clang diagnostic pop
}
return nil;
}
//这里创建下载任务、跳转到AFURLSessionManager去执行方法,block是成功和失败的回调。注意success参数是task,responseObject,failure的参数的task和error;
__block NSURLSessionDataTask *dataTask = nil;
dataTask = [self dataTaskWithRequest:request
uploadProgress:uploadProgress
downloadProgress:downloadProgress
completionHandler:^(NSURLResponse * __unused response, id responseObject, NSError *error) {
if (error) {
if (failure) {
failure(dataTask, error);
}
} else {
if (success) {
success(dataTask, responseObject);
}
}
}];
return dataTask;
}
接下来去AFURLSessionManger中去看生成task的方法。
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler {
__block NSURLSessionDataTask *dataTask = nil;
//很明显,在这里生成了task,self.session就是NSURLSession,在创建AFURLSessionManger的是就创建了,这里session是默认是defaultSessionConfiguration格式的,AFURLSessionManger会实现session的代理方法,不过,不会在这里处理这些方法返回的数据,而是做了一个重定向,转到别的地方去处理了。具体在哪处理,往下看。。。
url_session_manager_create_task_safely(^{
dataTask = [self.session dataTaskWithRequest:request];
});
//这里是定义的处理重定向数据的代理
[self addDelegateForDataTask:dataTask uploadProgress:uploadProgressBlock downloadProgress:downloadProgressBlock completionHandler:completionHandler];
return dataTask;
}
//生成代理对象,注意:这里只有一个session,却生成了多个task。代理方法返回的数据可以根据task.taskIdentifier来区分是那个任务返回数据了。之所以使用一个session,http的底层其实也是通过TCP/IP完成的,只不过http是一问一答,回答以后就结束链接了,但是在建立链接和断开连接的时候需要三次握手、四次挥手,每次建立链接会消耗一定的内存。但是在使用NSURLSession以后,可以复用TCP链接。这也是iOS9以后,NSURLConnection背弃的原因之一吧。
- (void)addDelegateForDataTask:(NSURLSessionDataTask *)dataTask
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgressBlock
completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
{
AFURLSessionManagerTaskDelegate *delegate = [[AFURLSessionManagerTaskDelegate alloc] init];
delegate.manager = self;
delegate.completionHandler = completionHandler;
dataTask.taskDescription = self.taskDescriptionForSessionTasks;
[self setDelegate:delegate forTask:dataTask];
delegate.uploadProgressBlock = uploadProgressBlock;
delegate.downloadProgressBlock = downloadProgressBlock;
}
- (void)addDelegateForUploadTask:(NSURLSessionUploadTask *)uploadTask
progress:(void (^)(NSProgress *uploadProgress)) uploadProgressBlock
completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
{
AFURLSessionManagerTaskDelegate *delegate = [[AFURLSessionManagerTaskDelegate alloc] init];
delegate.manager = self;
delegate.completionHandler = completionHandler;
uploadTask.taskDescription = self.taskDescriptionForSessionTasks;
[self setDelegate:delegate forTask:uploadTask];
delegate.uploadProgressBlock = uploadProgressBlock;
}
AFURLSessionManagerTaskDelegate这个就是重定向去处理回调数据的类。AFURLSessionManagerTaskDelegat里面会有很多对 task属性的KVO监听,以此来保证数据的实时性。当task任务完成以后,通过block回调数据,然后移除KVO.
暂时写到这里,大概就是一个流水账,主要是自己加深印象,有问题的请指出,觉得很鸡肋的请略过!