AFNetworking 3.x 阅读笔记（四）

sessiont task完成时候的处理

在一个session task结束时候会进行如下回调方法,方法中会获取task对应的delegate helper类完成结果处理.

// 通知delegate, task已经完成, 会直接调用 taskDelegateHelper -> 将数据通过responseSerializer处理
- (void)URLSession:(NSURLSession *)session
              task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error
{
    // 1 获取delegate -> 2 调用delegate 的相似方法 -> 3 从dict中删除(删除以后,注意清理现场)
    AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];

    // delegate may be nil when completing a task in the background
    if (delegate) {
        [delegate URLSession:session task:task didCompleteWithError:error];
        // 2 将task从[task:delegate]中删除
        [self removeDelegateForTask:task];
    }

    if (self.taskDidComplete) {
        self.taskDidComplete(session, task, error);
    }
}

// AFURLSessionManagerTaskDelegate中的方法 ,responseSerializer的入口delegate
- (void)URLSession:(__unused NSURLSession *)session
              task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error
{
    __strong AFURLSessionManager *manager = self.manager;

    __block id responseObject = nil;

    // 1 如果出错userInfo的信息
    __block NSMutableDictionary *userInfo = [NSMutableDictionary dictionary];
    userInfo[AFNetworkingTaskDidCompleteResponseSerializerKey] = manager.responseSerializer;

    //Performance Improvement from #2672
    // 2 将接受到的data数据保存
    NSData *data = nil;
    if (self.mutableData) {
        data = [self.mutableData copy];
        //We no longer need the reference, so nil it out to gain back some memory.
        self.mutableData = nil;
    }

    // 3 如果是下载结束,在userInfo中放入资源路径, 如果是data Task,在userInfo中传入收到的data数据
    if (self.downloadFileURL) {
        userInfo[AFNetworkingTaskDidCompleteAssetPathKey] = self.downloadFileURL;
    } else if (data) {
        userInfo[AFNetworkingTaskDidCompleteResponseDataKey] = data;
    }

    // 4 判断结束时候是否有error, 如果有error,直接执行completionHanlder,并且发送AFNetworkingTaskDidCompleteNotification广播,带上userInfo dict
    if (error) {
        userInfo[AFNetworkingTaskDidCompleteErrorKey] = error;
        // ps: 在单独的completion_group 中间执行completionHanlder -> 这里使用group的dispatch方法主要是为了监听某一组task是否完成,如果这个group里面的所有任务都完成可以使用dispatch_group_notify方法,通知以后一起做UI方面的控制
        dispatch_group_async(manager.completionGroup ?: url_session_manager_completion_group(), manager.completionQueue ?: dispatch_get_main_queue(), ^{
            if (self.completionHandler) {
                self.completionHandler(task.response, responseObject, error);
            }

            dispatch_async(dispatch_get_main_queue(), ^{
                [[NSNotificationCenter defaultCenter] postNotificationName:AFNetworkingTaskDidCompleteNotification object:task userInfo:userInfo];
            });
        });
    } else {
        // 5 如果没有出错,说明下载以后数据完好,所有responseData相关处理都在processing queue中完成的
        dispatch_async(url_session_manager_processing_queue(), ^{
            NSError *serializationError = nil;
            // 6 使用responseSerializer序列化收到的responseData, 将responseData -> responseObjcet
            responseObject = [manager.responseSerializer responseObjectForResponse:task.response data:data error:&serializationError];

            // 7 如果是downloadTask,responseObjcet -> URL
            if (self.downloadFileURL) {
                responseObject = self.downloadFileURL;
            }

            // 8 更新userInfo,带上responseObject
            if (responseObject) {
                userInfo[AFNetworkingTaskDidCompleteSerializedResponseKey] = responseObject;
            }

            // 9 判断序列化中是否发生错误.并更新userInfo
            if (serializationError) {
                userInfo[AFNetworkingTaskDidCompleteErrorKey] = serializationError;
            }

            // ps: 在单独的completion_group 中间执行completionHanlder -> 这里使用group的dispatch方法主要是为了监听某一组task是否完成,如果这个group里面的所有任务都完成可以使用dispatch_group_notify方法,通知以后一起做UI方面的控制
            dispatch_group_async(manager.completionGroup ?: url_session_manager_completion_group(), manager.completionQueue ?: dispatch_get_main_queue(), ^{
                if (self.completionHandler) {
                    self.completionHandler(task.response, responseObject, serializationError);
                }

                dispatch_async(dispatch_get_main_queue(), ^{
                    [[NSNotificationCenter defaultCenter] postNotificationName:AFNetworkingTaskDidCompleteNotification object:task userInfo:userInfo];
                });
            });
        });
    }
}

在responseData的处理过程中主要有三个内容:

• 1 使用responseSerializer
• 2 调用completionHanlder
• 3 发送AFNetworkingTaskDidCompleteNotification通知

responseData -> responseObject

在responseData转化成responseObject需要使用AFHTTPResponseSerializer类,该类的主要类继承图主要如下图:

版面 6.png

其中AFURLResponseSerialization是一个protocol,它只有一个方法: 将NSData -> responseObject. 具体得到何种object,需要根据不同的serialization实现的protocol方法赖确定,默认的AFHTTPResponseSerializer实现了该协议. 主要增加验证NSURLResponse的合法性校验,但是并没有对responseData做任何处理,返回的responseObject仍然是NSData,其中校验分成两部分:

• 1 response status code
• 2 接受的response 的MIME Type的类型是否满足

网络框架中还实现了其他的serializer,可以将data数据转化成JSON,XML等等.也可以根据自己的需求定制responseSerializer, AFJSONResponseSerializer的源码是很好的参考.