AFNetworking（v3.0+）框架学习总结(二内部逻辑处理过程)

最新推荐文章于 2023-07-31 22:43:28 发布

置顶上天眷顾我

最新推荐文章于 2023-07-31 22:43:28 发布

阅读量1.9k

点赞数

分类专栏： iOS开发文章标签： iOS 资源大全 iOS学习资料 AFNetworking

iOS开发专栏收录该内容

721 篇文章 17 订阅

订阅专栏

本文来自简书，原文地址:http://www.jianshu.com/p/4f1818568bc4

Write in the first【写在最前】

AFNetWorking 基本是iOS开发中使用网络通信框架的标配，这个框架本身比较庞大，也很复杂，但是使用起来非常非常简单。

本篇文章主要从【AFN 内部逻辑处理过程】以Get请求为例，学习总结，
时间有限，知识并未全覆盖，有遗漏或者错误，忘指正。

 AFNetworking

目录：

AFN GET内部逻辑处理
AFN POST内部逻辑处理
总结
后续【AFN 框架 | 源码学习总结】

Business logic【AFN GET 内部逻辑处理】

这是 AFNetworking 发起一个 Get 请求的流程图，大概可以分为这几个步骤，下面会逐个解读这个流程。

AFN-->GET业务逻辑处理.png

1. AFHTTPSessionManager 发起GET请求

manager-->GET请求

这个方法是 AFN 的 Get请求的起点，其他 Get 请求的方法也都是直接或者间接调用这个方法来发起 Get 请求。这个方法的代码量很少也很直观，就是调用其他方法生成 NSURLSessionDataTask对象的实例，然后调用 NSURLSessionDataTask 的 resume 方法发起请求。

2. 创建 NSURLSessionDataTask

创建-->NSURLSessionDataTask

这个方法是创建 NSURLSessionDataTask 对象实例并返回这个实例。首先创建一个 NSMutableURLRequest 对象的实例，然后配置。之后是使用 NSMutableURLRequest 对象的实例创建NSURLSessionDataTask 对象实例，然后配置，可以选择性地传入各类Block回调，用于监听网络请求的进度比如上传进度，下载进度，请求成功，请求失败。

3. 配置 NSMutableURLRequest对象

配置-->NSMutableURLRequest对象

在这个方法中先使用了 url 创建了一个 NSMutableURLRequest 对象的实例,并且设置了 HTTPMethod 为 Get 方法（如果是Post方法，那么这里就是设置Post方法）然后使用KVC的方法设置了 NSMutableURLRequest 的一些属性。

// 设置 NSMutableURLRequest 的属性
static NSArray * AFHTTPRequestSerializerObservedKeyPaths() {
    static NSArray *_AFHTTPRequestSerializerObservedKeyPaths = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        //allowsCellularAccess 允许使用数据流量
        //cachePolicy 缓存策略
        //HTTPShouldHandleCookies 处理Cookie
        //HTTPShouldUsePipelining 批量请求
        //networkServiceType 网络状态
        //timeoutInterval 超时
        _AFHTTPRequestSerializerObservedKeyPaths = @[NSStringFromSelector(@selector(allowsCellularAccess)), NSStringFromSelector(@selector(cachePolicy)), NSStringFromSelector(@selector(HTTPShouldHandleCookies)), NSStringFromSelector(@selector(HTTPShouldUsePipelining)), NSStringFromSelector(@selector(networkServiceType)), NSStringFromSelector(@selector(timeoutInterval))];
    });

    return _AFHTTPRequestSerializerObservedKeyPaths;
}

配置-->NSMutableURLRequest对象

先设置 HTTP header，之后格式化请求参数，设置参数的编码类型。这个是这个方法的基本操作流程。对于Get操作来说，参数是直接拼接在请求地址后面。

4. 配置 NSURLSessionDataTask对象

配置-->NSURLSessionDataTask对象

之后配置 NSMutableURLRequest 对象就需要配置 NSURLSessionDataTask 对象了。主要分为2个步骤，第一个步骤是创建 NSURLSessionDataTask 对象实例，第二个步骤是给NSURLSessionDataTask 对象实例设置 Delegate。用于实时了解网络请求的过程。

给NSURLSessionDataTask对象实例设置Delegate.png

AFN 的代理统一使用 AFURLSessionManagerTaskDelegate 对象来管理，使用 AFURLSessionManagerTaskDelegate 对象来接管NSURLSessionTask 网络请求过程中的回调，然后再传入 AFN 内部进行管理。

@interface AFURLSessionManagerTaskDelegate : NSObject <NSURLSessionTaskDelegate, 
NSURLSessionDataDelegate, NSURLSessionDownloadDelegate>

如代码所示 AFURLSessionManagerTaskDelegate 接管了NSURLSessionTaskDelegate，NSURLSessionDataDelegate，NSURLSessionDownloadDelegate的各种回调，然后做内部处理。这也是第三方网络请求框架的重点，让网络请求更加易用，好用。

// 通过 task 的标识符管理代理
- (void)setDelegate:(AFURLSessionManagerTaskDelegate *)delegate
            forTask:(NSURLSessionTask *)task
{
    NSParameterAssert(task);
    NSParameterAssert(delegate);

    [self.lock lock];
    // 将task和代理类绑定，task的taskIdentifier作为字典的key,delegate作为字典的value
    self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)] = delegate;
    // 给该task添加两个KVO事件（Resume 和 Suspend）
    [self addNotificationObserverForTask:task];
    [self.lock unlock];
}

通过NSURLSessionTask的taskIdentifier标识符对delegate进行管理，只要是用于识别该NSURLSessionTask的代理。

NSURLSessionTask 设置进度回调

设置各类回调 Block,给 NSURLSessionTask 使用 KVO 进行各种过程进度监听。

#pragma mark -
// 给task添加暂停和恢复的通知
- (void)addNotificationObserverForTask:(NSURLSessionTask *)task {
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidResume:) name:AFNSURLSessionTaskDidResumeNotification object:task];
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidSuspend:) name:AFNSURLSessionTaskDidSuspendNotification object:task];
}

监听 NSURLSessionTask 被挂起和恢复的通知。

5. 网络请求开始

// 发送GET请求
/**
 GET: 请求路径(不包含参数),url
 parameters: 字典(发送给服务器的数据~参数)
 progress: 进度回调
 success: 成功回调（task:请求任务、responseObject:响应体信息JSON->OC对象）
 failure: 失败回调（error:错误信息）
 task.response: 响应头
 */
- (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;
}

当 NSURLSessionTask 创建和配置完毕之后，它并不会主动执行，而是需要我们主动调用 resume 方法，NSURLSessionTask 才会开始执行。

6. 网络请求回调

NSURLSessionDelegate 方法

NSURLSessionTaskDelegate 方法

AFN 里面有关 NSURLSessionDelegate 的回调方法非常的多，这里我们只说和 NSURLSessionTask 相关的部分方法和 KVO 处理来进行说明，其他的大家可以参考源码细看。

KVO监听请求过程.png

收到响应数据.png

请求完成.png

对于我们的 Get请求来说，我们最关注的莫过于关注请求过程进度，收到响应数据和请求完成这2个回调。

KVO监听的属性值发生变化：

// KVO监听的属性值发生变化
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSString *,id> *)change context:(void *)context {
    if ([object isKindOfClass:[NSURLSessionTask class]] || [object isKindOfClass:[NSURLSessionDownloadTask class]]) {
        if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesReceived))]) {
            NSLog(@"countOfBytesReceived");
            // 这个是在Get请求下，网络响应过程中已经收到的数据量
            // 已经收到
            self.downloadProgress.completedUnitCount = [change[NSKeyValueChangeNewKey] longLongValue];
        } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesExpectedToReceive))]) {
            NSLog(@"countOfBytesExpectedToReceive");
            // 这个是在Get请求下，网络响应过程中期待收到的数据量
            // 期待收到
            self.downloadProgress.totalUnitCount = [change[NSKeyValueChangeNewKey] longLongValue];
        } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesSent))]) {
            NSLog(@"countOfBytesSent");
            // 已经发送
            self.uploadProgress.completedUnitCount = [change[NSKeyValueChangeNewKey] longLongValue];
        } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesExpectedToSend))]) {
            NSLog(@"countOfBytesExpectedToSend");
            // 期待发送
            self.uploadProgress.totalUnitCount = [change[NSKeyValueChangeNewKey] longLongValue];
        }
    }
    else if ([object isEqual:self.downloadProgress]) {
        // 下载进度变化
        if (self.downloadProgressBlock) {
            self.downloadProgressBlock(object);
        }
    }
    else if ([object isEqual:self.uploadProgress]) {
        // 上传进度变化
        if (self.uploadProgressBlock) {
            self.uploadProgressBlock(object);
        }
    }
}

收到请求响应：

// 收到请求响应
- (void)URLSession:(NSURLSession *)session
          dataTask:(NSURLSessionDataTask *)dataTask
          didReceiveResponse:(NSURLResponse *)response
          completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler {
    NSLog(@"收到请求响应");
    // 允许处理服务器的响应，才会继续接收服务器返回的数据
    NSURLSessionResponseDisposition disposition = NSURLSessionResponseAllow;

    // 是否有收到请求响应的回调Block
    if (self.dataTaskDidReceiveResponse) {
        // 若有调用该Block
        disposition = self.dataTaskDidReceiveResponse(session, dataTask, response);
    }
    // 是否有请求响应完成的回调Block
    if (completionHandler) {
        // 若有调用该Block
        completionHandler(disposition);
    }
}

请求完成：

// 请求完成
- (void)URLSession:(NSURLSession *)session
              task:(NSURLSessionTask *)task
              didCompleteWithError:(NSError *)error {
    NSLog(@"请求完成");
    // 取出该NSURLSessionTask的代理对象
    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];
        // NSURLSessionTask任务完成之后，移除该NSURLSessionTask的代理对象
        [self removeDelegateForTask:task];
    }
    // 是否有请求完成的回调Block
    if (self.taskDidComplete) {
        // 若有调用改Block
        self.taskDidComplete(session, task, error);
    }
}

因为在配置 NSURLSessionDataTask 对象的时候我们有给 NSURLSessionTask 做了一系列配置，那么当 NSURLSessionDataTask 任务完成之后，我们需要将该 NSURLSessionDataTask 的一系列配置全部清理掉。

这个是我们的配置过程：

// 通过task的标识符管理代理
- (void)setDelegate:(AFURLSessionManagerTaskDelegate *)delegate
            forTask:(NSURLSessionTask *)task
{
    NSParameterAssert(task);
    NSParameterAssert(delegate);

    [self.lock lock];
    self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)] = delegate;
    [delegate setupProgressForTask:task];
    [self addNotificationObserverForTask:task];
    [self.lock unlock];
}

那么对应的清理过程是这样的，就是设置过程中做了什么，在清理过程中就需要去掉什么。

// 给task移除delegate
- (void)removeDelegateForTask:(NSURLSessionTask *)task {
    NSParameterAssert(task);

    AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];
    [self.lock lock];
    [delegate cleanUpProgressForTask:task];
    [self removeNotificationObserverForTask:task];
    [self.mutableTaskDelegatesKeyedByTaskIdentifier removeObjectForKey:@(task.taskIdentifier)];
    [self.lock unlock];
}

cleanUpProgressForTask.png

removeNotificationObserverForTask.png

Business logic【AFN POST内部逻辑处理】

请求序列化方法

#pragma mark - AFURLRequestSerialization
// 设置Header和请求参数
- (NSURLRequest *)requestBySerializingRequest:(NSURLRequest *)request
                               withParameters:(id)parameters
                                        error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(request);

    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    [self.HTTPRequestHeaders enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
        // 判断header的field是否存在,如果不存在则设置，存在则跳过
        if (![request valueForHTTPHeaderField:field]) {
            // 设置 header
            [mutableRequest setValue:value forHTTPHeaderField:field];
        }
    }];

    NSString *query = nil;
    if (parameters) {
        // 用传进来的自定义block格式化请求参数
        if (self.queryStringSerialization) {
            NSError *serializationError;
            query = self.queryStringSerialization(request, parameters, &serializationError);
            if (serializationError) {
                if (error) {
                    *error = serializationError;
                }
                return nil;
            }
        } else {
            switch (self.queryStringSerializationStyle) {
                case AFHTTPRequestQueryStringDefaultStyle:
                    // 默认的格式化方式
                    query = AFQueryStringFromParameters(parameters);
                    break;
            }
        }
    }
    // 判断是否是GET/HEAD/DELETE方法， 对于GET/HEAD/DELETE方法，把参数加到URL后面
    if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
        // 判断是否有参数
        if (query && query.length > 0) {
            // 拼接请求参数
            NSLog(@"query-->%@",query);
            mutableRequest.URL = [NSURL URLWithString:[[mutableRequest.URL absoluteString] stringByAppendingFormat:mutableRequest.URL.query ? @"&%@" : @"?%@", query]];
        }
    } else {
        // #2864: an empty string is a valid x-www-form-urlencoded payload
        if (!query) {
            query = @"";
        }
        // 参数带在body上，大多是POST PUT
        if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
            // 设置Content-Type HTTP头，告诉服务端body的参数编码类型
            [mutableRequest setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
        }
        [mutableRequest setHTTPBody:[query  dataUsingEncoding:self.stringEncoding]];
    }

    return mutableRequest;
}

如果是 Post 请求，那么请求参数是没有拼接在 URL 上面，而是放在 body 上，这是 Post 和 Get 请求的最大区别了，其他过程和Get 请求并没有太多区别。

总结

AFN发起Get请求主要分为以下步骤：

1.创建NSURLSessionDataTask
2.配置NSURLSessionDataTask
3.设置NSURLSessionDataTask的Delegate
4.调用NSURLSessionDataTask的resume方法开始请求
5.在Delegate的方法里面处理网络请求的各个过程
6.清理NSURLSessionDataTask的配置

其实也就是使用 NSURLSessionDataTask 的步骤，AFN在这几个步骤加了一些封装，让我们的使用更简单。

【转载原著】iOS网络框架－AFNetworking3.1.0源码解读

期待

如果在阅读过程中遇到 error，希望你能 Issues 我，谢谢。
如果你想为【本文相关】分享点什么，也希望你能 Issues 我，我非常想为这篇文章增加更多实用的内容，谢谢。
「博客原文」，对本文我会【不定时、持续更新、一些学习心得与文章、实用才是硬道理】^_^.

上天眷顾我

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
AFNetworking（v3.0+）框架学习总结(二内部逻辑处理过程)

本文来自简书，原文地址:http://www.jianshu.com/p/4f1818568bc4Write in the first【写在最前】AFNetWorking 基本是iOS开发中使用网络通信框架的标配，这个框架本身比较庞大，也很复杂，但是使用起来非常非常简单。本篇文章主要从【AFN 内部逻辑处理过程】以Get请求为例，学习总结，时间有限，知识并未全覆盖，
复制链接

扫一扫