AFNetworking源码解读

最近一直在研究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.

暂时写到这里,大概就是一个流水账,主要是自己加深印象,有问题的请指出,觉得很鸡肋的请略过!

你可能感兴趣的:(AFNetworking源码解读)