AFNetworking源码 - NSURLSessionDelegate

最新推荐文章于 2024-02-20 16:49:06 发布
最新推荐文章于 2024-02-20 16:49:06 发布
阅读量990 收藏
点赞数
分类专栏： iOS 网络编程
本文深入剖析了AFNetworking中AFURLSessionManager的NSURLSession相关代理方法，包括NSURLSessionDelegate、NSURLSessionTaskDelegate、NSURLSessionDataDelegate及NSURLSessionDownloadDelegate等核心组件的实现原理与应用场景。
摘要由CSDN通过智能技术生成

1. 前言

上一篇的话，主要是讲了如何通过构建一个request来生成一个data task。但是对于NSURLSession部分却没有提及。主要是精力有限，准备在这一部分把NSURLSession的知识好好梳理一遍。一切先从上一篇中的addDelegateForDataTask:函数说起，然后再介绍AFURLSessionManagerTaskDelegate，最后结合AFURLSessionManager中的NSURLSession梳理一遍（可能会将部分内容放到下一篇）。

2. 由addDelegateForDataTask引发

注意addDelegateForDataTask:这个函数并不是AFURLSessionManagerTaskDelegate的函数，而是AFURLSessionManager的一个函数。这也侧面说明了AFURLSessionManagerTaskDelegate和NSURLSessionTask的关系是由AFURLSessionManager管理的。

该函数除了对于AFURLSessionManagerTaskDelegate类型的成员变量delegate设置之外，最关键的代码就是

  
  
  1. [self setDelegate:delegate forTask:dataTask];

这个setDelegate:forTask:函数字面意思是将一个session task和一个AFURLSessionManagerTaskDelegate类型的delegate变量绑在一起，而这个绑在一起的工作是由我们的AFURLSessionManager所做。至于绑定的过程，就是以该session task的taskIdentifier为key，delegate为value，赋值给mutableTaskDelegatesKeyedByTaskIdentifier这个NSMutableDictionary类型的变量。知道了这两者是关联在一起的话，马上就会产生另外的问题 —— 为什么要关联以及怎么关联在一起？索性我们好好研究下setDelegate:forTask:这个函数：

  
  
  1. - (void)setDelegate:(AFURLSessionManagerTaskDelegate *)delegate
  2.             forTask:(NSURLSessionTask *)task
  3. {
  4.     NSParameterAssert(task);
  5.     NSParameterAssert(delegate);
  7.     [self.lock lock];
  8.     self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)] = delegate;
  9.     [delegate setupProgressForTask:task];
  10.     [self addNotificationObserverForTask:task];
  11.     [self.lock unlock];
  12. }

代码首先是基本的判断，判断session task和delegate是否为空，这里实现方式（NSParameterAssert）每次看到都加深一下印象。接着就是使用NSLock来加锁，这个很简单，和@synchronized作用类似，不过@synchronized多了一个可以使用变量作为互斥信号量的功能，这里就不细说了。临界区的代码（lock和unlock之间的代码）也是分为三个部分：

  
  
  1. 1. self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)] = delegate;
  2. 2. [delegate setupProgressForTask:task];
  3. 3. [self addNotificationObserverForTask:task];
  • 第一部分不赘述了。
  • 第二部分我扫了下代码，好像是设置两个NSProgress的变量 - uploadProgress和downloadProgress。
  • 第三部分就是给session task添加了两个KVO事件。

具体细节详述如下（包含第二部分和第三部分详述）：

2.1 –[AFURLSessionManager setupProgressForTask:]

上面简单提了下该函数是为了设置uploadProgress和downloadProgress这两个NSProgress变量。这种设置也是很合理的，毕竟session task的任务中需要记录进度的，要不是上传任务，要不就是下载任务。

我们来看看setupProgressForTask:的具体实现：

  
  
  1. - (void)setupProgressForTask:(NSURLSessionTask *)task {
  2.     __weak __typeof__(task) weakTask = task;
  4.     self.uploadProgress.totalUnitCount = task.countOfBytesExpectedToSend;
  5.     self.downloadProgress.totalUnitCount = task.countOfBytesExpectedToReceive;
  6.     [self.uploadProgress setCancellable:YES];
  7.     [self.uploadProgress setCancellationHandler:^{
  8.         __typeof__(weakTask) strongTask = weakTask;
  9.         [strongTask cancel];
  10.     }];
  11.     [self.uploadProgress setPausable:YES];
  12.     [self.uploadProgress setPausingHandler:^{
  13.         __typeof__(weakTask) strongTask = weakTask;
  14.         [strongTask suspend];
  15.     }];
  16.     if ([self.uploadProgress respondsToSelector:@selector(setResumingHandler:)]) {
  17.         [self.uploadProgress setResumingHandler:^{
  18.             __typeof__(weakTask) strongTask = weakTask;
  19.             [strongTask resume];
  20.         }];
  21.     }
  23.     [self.downloadProgress setCancellable:YES];
  24.     [self.downloadProgress setCancellationHandler:^{
  25.         __typeof__(weakTask) strongTask = weakTask;
  26.         [strongTask cancel];
  27.     }];
  28.     [self.downloadProgress setPausable:YES];
  29.     [self.downloadProgress setPausingHandler:^{
  30.         __typeof__(weakTask) strongTask = weakTask;
  31.         [strongTask suspend];
  32.     }];
  34.     if ([self.downloadProgress respondsToSelector:@selector(setResumingHandler:)]) {
  35.         [self.downloadProgress setResumingHandler:^{
  36.             __typeof__(weakTask) strongTask = weakTask;
  37.             [strongTask resume];
  38.         }];
  39.     }
  41.     [task addObserver:self
  42.            forKeyPath:NSStringFromSelector(@selector(countOfBytesReceived))
  43.               options:NSKeyValueObservingOptionNew
  44.               context:NULL];
  45.     [task addObserver:self
  46.            forKeyPath:NSStringFromSelector(@selector(countOfBytesExpectedToReceive))
  47.               options:NSKeyValueObservingOptionNew
  48.               context:NULL];
  50.     [task addObserver:self
  51.            forKeyPath:NSStringFromSelector(@selector(countOfBytesSent))
  52.               options:NSKeyValueObservingOptionNew
  53.               context:NULL];
  54.     [task addObserver:self
  55.            forKeyPath:NSStringFromSelector(@selector(countOfBytesExpectedToSend))
  56.               options:NSKeyValueObservingOptionNew
  57.               context:NULL];
  59.     [self.downloadProgress addObserver:self
  60.                             forKeyPath:NSStringFromSelector(@selector(fractionCompleted))
  61.                                options:NSKeyValueObservingOptionNew
  62.                                context:NULL];
  63.     [self.uploadProgress addObserver:self
  64.                           forKeyPath:NSStringFromSelector(@selector(fractionCompleted))
  65.                              options:NSKeyValueObservingOptionNew
  66.                              context:NULL];
  67. }

先是设置两个progress的totalUnitCount:

  
  
  1. self.uploadProgress.totalUnitCount = task.countOfBytesExpectedToSend;
  2. self.downloadProgress.totalUnitCount = task.countOfBytesExpectedToReceive;

上传的totalUnitCount就对应期望发送(send)的数据大小，下载任务的就对应期望接收(receive)的数据大小。

接着就是设置这两个NSProgress对应的cancel、pause和resume这三个状态，正好对应session task的cancel、suspend和resume三个状态，详见上方源码。

最后一部分代码是关键，给session task和两个progress添加KVO。也就是说该AFURLSessionManager的对象需要观察以下属性：

  • NSURLSessionTask的countOfBytesReceived、countOfBytesExpectedToReceive、countOfBytesSent、countOfBytesExpectedToSend属性
  • NSProgress的fractionCompleted属性（任务已经完成的比例，取值为0~1）

看了KVO，马上跳到observeValueForKeyPath:ofObject:change:context:函数中：

  
  
  1. - (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSString *,id> *)change context:(void *)context {
  2.     if ([object isKindOfClass:[NSURLSessionTask class]]) {
  3.         if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesReceived))]) {
  4.             self.downloadProgress.completedUnitCount = [change[@"new"] longLongValue];
  5.         } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesExpectedToReceive))]) {
  6.             self.downloadProgress.totalUnitCount = [change[@"new"] longLongValue];
  7.         } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesSent))]) {
  8.             self.uploadProgress.completedUnitCount = [change[@"new"] longLongValue];
  9.         } else if ([keyPath isEqualToString:NSStringFromSelector(@selector(countOfBytesExpectedToSend))]) {
  10.             self.uploadProgress.totalUnitCount = [change[@"new"] longLongValue];
  11.         }
  12.     }
  13.     else if ([object isEqual:self.downloadProgress]) {
  14.         if (self.downloadProgressBlock) {
  15.             self.downloadProgressBlock(object);
  16.         }
  17.     }
  18.     else if ([object isEqual:self.uploadProgress]) {
  19.         if (self.uploadProgressBlock) {
  20.             self.uploadProgressBlock(object);
  21.         }
  22.     }
  23. }

总结一下，也就是说

  • downloadProgress.completedUnitCount 《==      countOfBytesReceived更新
  • downloadProgress.totalUnitCount          《==      countOfBytesExpectedToReceive更新
  • uploadProgress.completedUnitCount      《==      countOfBytesSent更新
  • uploadProgress.totalUnitCount               《==      countOfBytesExpectedToSend更新
  • 调用自定义的downloadProgressBlock        《==      downloadProgress.fractionCompleted更新
  • 调用自定义的uploadProgressBlock             《==      uploadProgress.fractionCompleted更新

最后两个KVO事件中使用的block其实就是根据NSProgress的状态做用户自定义的行为，比如需要更新UI进度条的状态之类的。

2.2 –[AFURLSessionManager addNotificationObserverForTask:]

  
  
  1. - (void)addNotificationObserverForTask:(NSURLSessionTask *)task {
  2.     [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidResume:) name:AFNSURLSessionTaskDidResumeNotification object:task];
  3.     [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidSuspend:) name:AFNSURLSessionTaskDidSuspendNotification object:task];
  4. }

此处如果往深的地方研究，会涉及到很多runtime甚至methodSwizzle的代码，后面会专门开一个章节，研究下这段代码。此处我们只需知道，当NSURLSessionTask调用resume函数时，会postNotificationName:AFNSURLSessionTaskDidResumeNotification，从而执行taskDidResume:方法：

  
  
  1. - (void)taskDidResume:(NSNotification *)notification {
  2.     NSURLSessionTask *task = notification.object;
  3.     if ([task respondsToSelector:@selector(taskDescription)]) {
  4.         if ([task.taskDescription isEqualToString:self.taskDescriptionForSessionTasks]) {
  5.             dispatch_async(dispatch_get_main_queue(), ^{
  6.                 [[NSNotificationCenter defaultCenter] postNotificationName:AFNetworkingTaskDidResumeNotification object:task];
  7.             });
  8.         }
  9.     }
  10. }

有了AFNetworkingTaskDidResumeNotification就方便了，之前我们UIRefreshControl+AFNEtworking中就使用AFNetworkingTaskDidResumeNotification作为NotificationName。同理，参考源码对AFNSURLSessionTaskDidSuspendNotification的处理，这里就不赘述了。

3. 详解AFURLSessionManager的NSURLSession的相关代理

我们之前在看GET:等这些上层函数时，发现内部实现就是为了生成一个session task。而这个session task与网络具体如何交互，如何处理数据的方法，则是写在NSURLSession的相关代理方法中。虽然GET:这些方法是AFHTTPSessionManager的方法，但是AFURLSessionManager是AFHTTPSessionManager的父类，所以调用的NSURLSession的相关代理的实现其实是在AFURLSessionManager中实现的，我们可以看看AFURLSessionManager实现了哪些NSURLSession相关的代理方法：

  
  
  1.  ### `NSURLSessionDelegate`
  3.  - `URLSession:didBecomeInvalidWithError:`
  4.  - `URLSession:didReceiveChallenge:completionHandler:`
  5.  - `URLSessionDidFinishEventsForBackgroundURLSession:`
  7.  ### `NSURLSessionTaskDelegate`
  9.  - `URLSession:willPerformHTTPRedirection:newRequest:completionHandler:`
  10.  - `URLSession:task:didReceiveChallenge:completionHandler:`
  11.  - `URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:`
  12.  - `URLSession:task:didCompleteWithError:`
  14.  ### `NSURLSessionDataDelegate`
  16.  - `URLSession:dataTask:didReceiveResponse:completionHandler:`
  17.  - `URLSession:dataTask:didBecomeDownloadTask:`
  18.  - `URLSession:dataTask:didReceiveData:`
  19.  - `URLSession:dataTask:willCacheResponse:completionHandler:`
  21.  ### `NSURLSessionDownloadDelegate`
  23.  - `URLSession:downloadTask:didFinishDownloadingToURL:`
  24.  - `URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesWritten:totalBytesExpectedToWrite:`
  25.  - `URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:`

3.1 NSURLSessionDelegate

3.1.1 - URLSession:didBecomeInvalidWithError:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session didBecomeInvalidWithError:(NSError *)error

函数作用：

当前这个session已经失效时，该代理方法被调用。

函数讨论：

如果你使用finishTasksAndInvalidate函数使该session失效，那么session首先会先完成最后一个task，然后再调用URLSession:didBecomeInvalidWithError:代理方法，如果你调用invalidateAndCancel方法来使session失效，那么该session会立即调用上面的代理方法。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2. didBecomeInvalidWithError:(NSError *)error
  3. {
  4.     // 自定义的一个block，用来处理session无效的情况。
  5.     // 此处插一句，刚才突然灵光一现，体验到了block的好处。具体说不清楚，
  6.     // 我只能说好处就是此处并不是让用户自己实现didBecomeInvalidWithError:方法，
  7.     // 而是让用户实现sessionDidBecomeInvalid这个block，隐藏细节。
  8.     // 确实很妙，以后要学会使用block
  9.     if (self.sessionDidBecomeInvalid) {
  10.         self.sessionDidBecomeInvalid(session, error);
  11.     }
  12.     
  13.     // 当一个session无效时，post名为AFURLSessionDidInvalidateNotification的Notification
  14.     // 不过源代码中没有举例如何使用这个Notification，所以需要用户自己定义，比如结束进度条的显示啊。
  15.     [[NSNotificationCenter defaultCenter] postNotificationName:AFURLSessionDidInvalidateNotification object:session];
  16. }
3.1.2 - URLSession:didReceiveChallenge:completionHandler:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * __nullable credential))completionHandler;

函数作用：

web服务器接收到客户端请求时，有时候需要先验证客户端是否为正常用户，再决定是够返回真实数据。这种情况称之为服务端要求客户端接收挑战（NSURLAuthenticationChallenge *challenge）。接收到挑战后，客户端要根据服务端传来的challenge来生成completionHandler所需的NSURLSessionAuthChallengeDisposition disposition和NSURLCredential *credential（disposition指定应对这个挑战的方法，而credential是客户端生成的挑战证书，注意只有challenge中认证方法为NSURLAuthenticationMethodServerTrust的时候，才需要生成挑战证书）。最后调用completionHandler回应服务器端的挑战。

函数讨论：

该代理方法会在下面两种情况调用：

  1. 1. 当服务器端要求客户端提供证书时或者进行NTLM认证（Windows NT LAN Manager，微软提出的WindowsNT挑战/响应验证机制）时，此方法允许你的app提供正确的挑战证书。
  2. 2. 当某个session使用SSL/TLS协议，第一次和服务器端建立连接的时候，服务器会发送给iOS客户端一个证书，此方法允许你的app验证服务期端的证书链（certificate keychain）

如果你没有实现该方法，该session会调用其NSURLSessionTaskDelegate的代理方法URLSession:task:didReceiveChallenge:completionHandler: 。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2. didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge
  3.  completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler
  4. {
  5.     //挑战处理类型为 默认
  6.     /*
  7.     NSURLSessionAuthChallengePerformDefaultHandling：默认方式处理
  8.     NSURLSessionAuthChallengeUseCredential：使用指定的证书
  9.     NSURLSessionAuthChallengeCancelAuthenticationChallenge：取消挑战
  10.     */
  11.     NSURLSessionAuthChallengeDisposition disposition = NSURLSessionAuthChallengePerformDefaultHandling;
  12.     __block NSURLCredential *credential = nil;
  13.     // sessionDidReceiveAuthenticationChallenge是自定义方法，用来如何应对服务器端的认证挑战
  14.     if (self.sessionDidReceiveAuthenticationChallenge) {
  15.         disposition = self.sessionDidReceiveAuthenticationChallenge(session, challenge, &credential);
  16.     } else {
  17.         // 此处服务器要求客户端的接收认证挑战方法是NSURLAuthenticationMethodServerTrust
  18.         // 也就是说服务器端需要客户端返回一个根据认证挑战的保护空间提供的信任（即challenge.protectionSpace.serverTrust）产生的挑战证书。
  19.         // 而这个证书就需要使用credentialForTrust:来创建一个NSURLCredential对象
  20.         if ([challenge.protectionSpace.authenticationMethod isEqualToString:NSURLAuthenticationMethodServerTrust]) {
  21.             // 基于客户端的安全策略来决定是否信任该服务器，不信任的话，也就没必要响应挑战
  22.             if ([self.securityPolicy evaluateServerTrust:challenge.protectionSpace.serverTrust forDomain:challenge.protectionSpace.host]) {
  23.                 // 创建挑战证书（注：挑战方式为UseCredential和PerformDefaultHandling都需要新建挑战证书）
  24.                 credential = [NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust];
  25.                 // 确定挑战的方式 
  26.                  if (credential) {
  27.                     disposition = NSURLSessionAuthChallengeUseCredential;
  28.                 } else {
  29.                     disposition = NSURLSessionAuthChallengePerformDefaultHandling;
  30.                 }
  31.             } else {
  32.                 // 取消挑战
  33.                 disposition = NSURLSessionAuthChallengeRejectProtectionSpace;
  34.             }
  35.         } else {
  36.             disposition = NSURLSessionAuthChallengePerformDefaultHandling;
  37.         }
  38.     }
  39.     
  40.     // 必须调用此方法，完成认证挑战
  41.     if (completionHandler) {
  42.         completionHandler(disposition, credential);
  43.     }
  44. }
3.1.3 – URLSessionDidFinishEventsForBackgroundURLSession:

函数声明：

  
  
  1. - (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session

函数作用：

当session中所有已经入队的消息被发送出去后，会调用该代理方法。

函数讨论：

在iOS中，当一个后台传输任务完成或者后台传输时需要证书，而此时你的app正在后台挂起，那么你的app在后台会自动重新启动运行，并且这个app的UIApplicationDelegate会发送一个application:handleEventsForBackgroundURLSession:completionHandler:消息。该消息包含了对应后台的session的identifier，而且这个消息会导致你的app启动。你的app随后应该先存储completion handler，然后再使用相同的identifier创建一个background configuration，并根据这个background configuration创建一个新的session。这个新创建的session会自动与后台任务重新关联在一起。

当你的app获取了一个URLSessionDidFinishEventsForBackgroundURLSession:消息，这就意味着之前这个session中已经入队的所有消息都转发出去了，这时候再调用先前存取的completion handler是安全的，或者因为内部更新而导致调用completion handler也是安全的。

函数实现：

  
  
  1. - (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session {
  2.     if (self.didFinishEventsForBackgroundURLSession) {
  3.         // 意味着background session中的消息已经全部发送出去了，返回到主进程执行自定义的函数
  4.         dispatch_async(dispatch_get_main_queue(), ^{
  5.             self.didFinishEventsForBackgroundURLSession(session);
  6.         });
  7.     }
  8. }

3.2 NSURLSessionTaskDelegate

3.2.1 - URLSession:task:willPerformHTTPRedirection:newRequest:completionHandler:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task willPerformHTTPRedirection:(NSHTTPURLResponse *)response newRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLRequest *))completionHandler

函数作用：

客户端告知服务器端需要HTTP重定向。

函数讨论：
此方法只会在default session或者ephemeral session中调用，而在background session中，session task会自动重定向。

知识点

对于NSURLSession对象的初始化需要使用NSURLSessionConfiguration，而NSURLSessionConfiguration有三个类工厂方法：

+defaultSessionConfiguration 返回一个标准的 configuration，这个配置实际上与 NSURLConnection 的网络堆栈（networking stack）是一样的，具有相同的共享 NSHTTPCookieStorage，共享 NSURLCache 和共享NSURLCredentialStorage。

+ephemeralSessionConfiguration 返回一个预设配置，这个配置中不会对缓存，Cookie 和证书进行持久性的存储。这对于实现像秘密浏览这种功能来说是很理想的。

+backgroundSessionConfiguration:(NSString *)identifier 的独特之处在于，它会创建一个后台 session。后台 session 不同于常规的，普通的 session，它甚至可以在应用程序挂起，退出或者崩溃的情况下运行上传和下载任务。初始化时指定的标识符，被用于向任何可能在进程外恢复后台传输的守护进程（daemon）提供上下文。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.               task:(NSURLSessionTask *)task
  3. willPerformHTTPRedirection:(NSHTTPURLResponse *)response
  4.         newRequest:(NSURLRequest *)request
  5.  completionHandler:(void (^)(NSURLRequest *))completionHandler
  6. {
  7.     NSURLRequest *redirectRequest = request;
  8.     // 自定义如何处理重定向请求，注意会生成一个新的request
  9.     if (self.taskWillPerformHTTPRedirection) {
  10.         redirectRequest = self.taskWillPerformHTTPRedirection(session, task, response, request);
  11.     }
  13.     if (completionHandler) {
  14.         completionHandler(redirectRequest);
  15.     }
  16. }
3.2.2 - URLSession:task:didReceiveChallenge:completionHandler:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler

函数作用：

同NSURLSessionDelegate中的- URLSession:didReceiveChallenge:completionHandler:

函数讨论：

该方法是处理task-level的认证挑战。在NSURLSessionDelegate中提供了一个session-level的认证挑战代理方法。该方法的调用取决于认证挑战的类型：

  • 对于session-level的认证挑战，挑战类型有 — NSURLAuthenticationMethodNTLM, NSURLAuthenticationMethodNegotiate, NSURLAuthenticationMethodClientCertificate, 或NSURLAuthenticationMethodServerTrust — 此时session会调用其代理方法URLSession:didReceiveChallenge:completionHandler:。如果你的app没有提供对应的NSURLSessionDelegate方法，那么NSURLSession对象就会调用URLSession:task:didReceiveChallenge:completionHandler:来处理认证挑战。
  • 对于non-session-level的认证挑战，NSURLSession对象调用URLSession:task:didReceiveChallenge:completionHandler:来处理认证挑战。如果你在app中使用了session代理方法，而且也确实要处理认证挑战这个问题，那么你必须还是在task level来处理这个问题，或者提供一个task-level的handler来显式调用每个session的handler。而对于non-session-level的认证挑战，session的delegate中的URLSession:didReceiveChallenge:completionHandler:方法不会被调用。

函数实现：

参考URLSession:didReceiveChallenge:completionHandler:实现，除了自定义了taskDidReceiveAuthenticationChallenge这个block处理task-level的认证挑战，其他都一样。

3.2.3 - URLSession:task:needNewBodyStream:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task needNewBodyStream:(void (^)(NSInputStream *bodyStream))completionHandler

函数作用：

当一个session task需要发送一个新的request body stream到服务器端的时候，调用该代理方法。

函数讨论：

该代理方法会在下面两种情况被调用：

  • 如果task是由uploadTaskWithStreamedRequest:创建的，那么提供初始的request body stream时候会调用该代理方法。
  • 因为认证挑战或者其他可恢复的服务器错误，而导致需要客户端重新发送一个含有body stream的request，这时候会调用该代理。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.               task:(NSURLSessionTask *)task
  3.  needNewBodyStream:(void (^)(NSInputStream *bodyStream))completionHandler
  4. {
  5.     NSInputStream *inputStream = nil;
  7.     if (self.taskNeedNewBodyStream) {
  8.         // 自定义的获取到新的bodyStream方法
  9.         inputStream = self.taskNeedNewBodyStream(session, task);
  10.     } else if (task.originalRequest.HTTPBodyStream && [task.originalRequest.HTTPBodyStream conformsToProtocol:@protocol(NSCopying)]) {
  11.         // 拷贝一份数据出来到新的bodyStream中（即inputStream）
  12.         inputStream = [task.originalRequest.HTTPBodyStream copy];
  13.     }
  15.     if (completionHandler) {
  16.         completionHandler(inputStream);
  17.     }
  18. }
3.2.4 - URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend

函数作用：

周期性地通知代理发送到服务器端数据的进度。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.               task:(NSURLSessionTask *)task
  3.    didSendBodyData:(int64_t)bytesSent
  4.     totalBytesSent:(int64_t)totalBytesSent
  5. totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
  6. {
  7.     // 如果totalUnitCount获取失败，就使用HTTP header中的Content-Length作为totalUnitCount
  8.     int64_t totalUnitCount = totalBytesExpectedToSend;
  9.     if(totalUnitCount == NSURLSessionTransferSizeUnknown) {
  10.         NSString *contentLength = [task.originalRequest valueForHTTPHeaderField:@"Content-Length"];
  11.         if(contentLength) {
  12.             totalUnitCount = (int64_t) [contentLength longLongValue];
  13.         }
  14.     }
  15.     // 每次发送数据后的相关自定义处理，比如根据totalBytesSent来进行UI界面的数据上传显示
  16.     if (self.taskDidSendBodyData) {
  17.         self.taskDidSendBodyData(session, task, bytesSent, totalBytesSent, totalUnitCount);
  18.     }
  19. }
3.2.5 - URLSession:task:didCompleteWithError:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error

函数作用：

告知该session task已经完成了数据传输任务。

函数讨论：

注意这里的error不会报告服务期端的error，他表示的是客户端这边的eroor，比如无法解析hostname或者连不上host主机。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.               task:(NSURLSessionTask *)task
  3. didCompleteWithError:(NSError *)error
  4. {
  5.     // 这里第一次展示了AFURLSessionManagerTaskDelegate的作用
  6.     AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];
  8.     // 如果task是在后台完成的，可能delegate会为nil
  9.     if (delegate) {
  10.         // 调用了一样的代理方法，不过是AFURLSessionManagerTaskDelegate中实现的
  11.         [delegate URLSession:session task:task didCompleteWithError:error];
  12.         // 该task结束了，就移除对应的delegate
  13.         [self removeDelegateForTask:task];
  14.     }
  15.     // 自定义处理方法
  16.     if (self.taskDidComplete) {
  17.         self.taskDidComplete(session, task, error);
  18.     }
  19. }

3.3 NSURLSessionDataDelegate

3.3.1 - URLSession:dataTask:didReceiveResponse:completionHandler:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler

函数作用：

告诉代理，该data task获取到了服务器端传回的最初始回复（response）。注意其中的completionHandler这个block，通过传入一个类型为NSURLSessionResponseDisposition的变量来决定该传输任务接下来该做什么：

  • NSURLSessionResponseAllow 该task正常进行
  • NSURLSessionResponseCancel 该task会被取消
  • NSURLSessionResponseBecomeDownload 会调用URLSession:dataTask:didBecomeDownloadTask:方法来新建一个download task以代替当前的data task

函数讨论：

该方法是可选的，除非你必须支持“multipart/x-mixed-replace”类型的content-type。因为如果你的request中包含了这种类型的content-type，服务器会将数据分片传回来，而且每次传回来的数据会覆盖之前的数据。每次返回新的数据时，session都会调用该函数，你应该在这个函数中合理地处理先前的数据，否则会被新数据覆盖。如果你没有提供该方法的实现，那么session将会继续任务，也就是说会覆盖之前的数据。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.           dataTask:(NSURLSessionDataTask *)dataTask
  3. didReceiveResponse:(NSURLResponse *)response
  4.  completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler
  5. {  
  6.     // 默认方式为继续执行该task
  7.     NSURLSessionResponseDisposition disposition = NSURLSessionResponseAllow;
  8.     // 自定义
  9.     if (self.dataTaskDidReceiveResponse) {
  10.         disposition = self.dataTaskDidReceiveResponse(session, dataTask, response);
  11.     }
  13.     if (completionHandler) {
  14.         completionHandler(disposition);
  15.     }
  16. }
3.3.2 - URLSession:dataTask:didBecomeDownloadTask:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didBecomeDownloadTask:(NSURLSessionDownloadTask *)downloadTask

函数作用：

如果data task变化成了下载任务（download task），那么就会调用该代理方法

函数讨论：

比如在- URLSession:dataTask:didReceiveResponse:completionHandler:给completionHandler方法传递NSURLSessionResponseBecomeDownload，就会使data task变成download task。而且之前的data task不会再响应代理方法了。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.           dataTask:(NSURLSessionDataTask *)dataTask
  3. didBecomeDownloadTask:(NSURLSessionDownloadTask *)downloadTask
  4. {
  5.     AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:dataTask];
  6.     if (delegate) {
  7.         // 将delegate关联的data task移除，换成新产生的download task
  8.         [self removeDelegateForTask:dataTask];
  9.         [self setDelegate:delegate forTask:downloadTask];
  10.     }
  11.     // 自定义
  12.     if (self.dataTaskDidBecomeDownloadTask) {
  13.         self.dataTaskDidBecomeDownloadTask(session, dataTask, downloadTask);
  14.     }
  15. }
3.3.3 - URLSession:dataTask:didReceiveData:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data

函数作用：

当接收到部分期望得到的数据（expected data）时，会调用该代理方法。

函数讨论：

一个NSData类型的数据通常是由一系列不同的数据整合到一起得到的，不管是不是这样，请使用- enumerateByteRangesUsingBlock:来遍历数据然不是使用bytes方法（因为bytes缺少enumerateByteRangesUsingBlock方法中的range，有了range，enumerateByteRangesUsingBlock就可以对NSData不同的数据块进行遍历，而不像bytes把所有NSData看成一个数据块）。

该代理方法可能会调用多次（比如分片获取数据），你需要自己实现函数将所有数据整合在一起。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.           dataTask:(NSURLSessionDataTask *)dataTask
  3.     didReceiveData:(NSData *)data
  4. {
  5.     AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:dataTask];
  6.     // 调用的是AFURLSessionManagerTaskDelegate的didReceiveData方法
  7.     [delegate URLSession:session dataTask:dataTask didReceiveData:data];
  8.     // 自定义
  9.     if (self.dataTaskDidReceiveData) {
  10.         self.dataTaskDidReceiveData(session, dataTask, data);
  11.     }
  12. }
3.3.4 - URLSession:dataTask:willCacheResponse:completionHandler:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask willCacheResponse:(NSCachedURLResponse *)proposedResponse completionHandler:(void (^)(NSCachedURLResponse *cachedResponse))completionHandler

函数作用：

询问data task或上传任务（upload task）是否缓存response。

函数讨论：

当task接收到所有期望的数据后，session会调用此代理方法。如果你没有实现该方法，那么就会使用创建session时使用的configuration对象决定缓存策略。这个代理方法最初的目的是为了阻止缓存特定的URLs或者修改NSCacheURLResponse对象相关的userInfo字典。

该方法只会当request决定缓存response时候调用。作为准则，responses只会当以下条件都成立的时候返回缓存：

  • 该request是HTTP或HTTPS URL的请求（或者你自定义的网络协议，并且确保该协议支持缓存）
  • 确保request请求是成功的（返回的status code为200-299）
  • 返回的response是来自服务器端的，而非缓存中本身就有的
  • 提供的NSURLRequest对象的缓存策略要允许进行缓存
  • 服务器返回的response中与缓存相关的header要允许缓存
  • 该response的大小不能比提供的缓存空间大太多（比如你提供了一个磁盘缓存，那么response大小一定不能比磁盘缓存空间还要大5%）

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.           dataTask:(NSURLSessionDataTask *)dataTask
  3.  willCacheResponse:(NSCachedURLResponse *)proposedResponse
  4.  completionHandler:(void (^)(NSCachedURLResponse *cachedResponse))completionHandler
  5. {
  6.     NSCachedURLResponse *cachedResponse = proposedResponse;
  7.     // 自定义方法，你可以什么都不做，返回原始的cachedResponse，或者使用修改后的cachedResponse
  8.     // 当然，你也可以返回NULL，这就意味着不需要缓存Response
  9.     if (self.dataTaskWillCacheResponse) {
  10.         cachedResponse = self.dataTaskWillCacheResponse(session, dataTask, proposedResponse);
  11.     }
  13.     if (completionHandler) {
  14.         completionHandler(cachedResponse);
  15.     }
  16. }

3.4 NSURLSessionDownloadDelegate

3.4.1 - URLSession:downloadTask:didFinishDownloadingToURL:（必须实现）

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location

函数作用：

告诉代理，该下载任务已完成。

函数实现：

  
  
  1. - (void)URLSession:(NSURLSession *)session
  2.       downloadTask:(NSURLSessionDownloadTask *)downloadTask
  3. didFinishDownloadingToURL:(NSURL *)location
  4. {
  5.     AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:downloadTask];
  6.     if (self.downloadTaskDidFinishDownloading) {
  7.         // 自定义函数，根据从服务器端获取到的数据临时地址location等参数构建出你想要将临时文件移动的位置
  8.         NSURL *fileURL = self.downloadTaskDidFinishDownloading(session, downloadTask, location);
  9.         // 如果fileURL存在的话，表示用户希望把临时数据存起来
  10.         if (fileURL) {
  11.             delegate.downloadFileURL = fileURL;
  12.             NSError *error = nil;
  13.             // 将位于location位置的文件全部移到fileURL位置
  14.             [[NSFileManager defaultManager] moveItemAtURL:location toURL:fileURL error:&error];
  15.             if (error) {
  16.                 // 如果移动文件失败，就发送AFURLSessionDownloadTaskDidFailToMoveFileNotification
  17.                 [[NSNotificationCenter defaultCenter] postNotificationName:AFURLSessionDownloadTaskDidFailToMoveFileNotification object:downloadTask userInfo:error.userInfo];
  18.             }
  20.             return;
  21.         }
  22.     }
  23.     // 这一步比较诡异，感觉有重复的嫌疑。或许是为了兼容以前代码吧
  24.     if (delegate) {
  25.         [delegate URLSession:session downloadTask:downloadTask didFinishDownloadingToURL:location];
  26.     }
  27. }
3.4.2 - URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite

函数作用：

周期性地通知下载进度。

函数实现：

  
  
  1. // bytesWritten 表示自上次调用该方法后，接收到的数据字节数
  2. // totalBytesWritten 表示目前已经接收到的数据字节数
  3. // totalBytesExpectedToWrite 表示期望收到的文件总字节数，是由Content-Length header提供。如果没有提供，默认是NSURLSessionTransferSizeUnknown
  4. - (void)URLSession:(NSURLSession *)session
  5.       downloadTask:(NSURLSessionDownloadTask *)downloadTask
  6.       didWriteData:(int64_t)bytesWritten
  7.  totalBytesWritten:(int64_t)totalBytesWritten
  8. totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
  9. {
  10.     // 自定义
  11.     if (self.downloadTaskDidWriteData) {
  12.         self.downloadTaskDidWriteData(session, downloadTask, bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
  13.     }
  14. }
3.4.3 - URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:

函数声明：

  
  
  1. - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes

函数作用：

告诉代理，下载任务重新开始下载了。

函数讨论：

如果一个resumable（不是很会翻译）下载任务被取消或者失败了，你可以请求一个resumeData对象（比如在userInfo字典中通过NSURLSessionDownloadTaskResumeData这个键来获取到resumeData）并使用它来提供足够的信息以重新开始下载任务。随后，你可以使用resumeData作为downloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:的参数。

当你调用这些方法时，你将开始一个新的下载任务。一旦你继续下载任务，session会调用它的代理方法URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:其中的downloadTask参数表示的就是新的下载任务，这也意味着下载重新开始了。

函数实现：

  
  
  1. // fileOffset如果文件缓存策略或者最后文件更新日期阻止重用已经存在的文件内容，那么该值为0。
  2. // 否则，该值表示已经存在磁盘上的，不需要重新获取的数据——— 这是断点续传啊！
  3. - (void)URLSession:(NSURLSession *)session
  4.       downloadTask:(NSURLSessionDownloadTask *)downloadTask
  5.  didResumeAtOffset:(int64_t)fileOffset
  6. expectedTotalBytes:(int64_t)expectedTotalBytes
  7. {
  8.     if (self.downloadTaskDidResume) {
  9.         self.downloadTaskDidResume(session, downloadTask, fileOffset, expectedTotalBytes);
  10.     }
  11. }

4. 还没结束

这一篇由于篇幅原因，不想继续写下去了。后续内容，包括AFURLSessionManagerTaskDelegate、uploadTask、downloadTask、测试等零散的东西准备放在下一篇进行学习。不过，一切还没结束，AFNetworking源码之路还很长。


转：http://www.cnblogs.com/polobymulberry/p/5140806.html

sharpyl
关注
专栏目录
《AFNetworking 3.0 源码解读》系列文章整理版
12-15
AFNetworking 3.0 源码解读 系列文章的整理全篇版，强烈推荐，分章可查看我的博客
【原】AFNetworking源码阅读（三）
weixin_30411819的博客
01-26 147
【原】AFNetworking源码阅读（三） 本文转载请注明出处 —— polobymulberry-博客园 1. 前言 上一篇的话，主要是讲了如何通过构建一个request来生成一个data task。但是对于NSURLSession部分却没有提及。主要是精力有限，准备在这一部分把NSURLSession的知识好好梳理一遍。一切先从上一篇中的addDelegateForDat...
AFNetworking源码简析
chenhui3831的博客
07-21 168
AFNetworking基本是苹果开发中网络请求库的标配，它是一个轻量级的网络库，专门针对iOS和OS X的网络应用设计，具有模块化的架构和丰富的APIs接口，功能强大并且使用简单，深受苹果应用开发人员的喜爱。 本文主要介绍一下AFNetworking（版本：3.1.0）的模块结构、请求的执行...
AFNetworking源码学习
weixin_34235457的博客
03-03 153
AFNetworking源码学习 简介 AFNetWorking是使用Objective-c开发iOS程序主流的网络请求开源库。 AFNetworking组织结构 AFNetWorking主要分为5个部分。NSURLSession、Reachability、security、Serialization、UIKit。其中NSURLSessi...
"深度解读iOS网络框架AFNetworking3.1.0源码 - 简书分享
在AFNetworking3.1.0源码解读文章中，作者详细介绍了AFNetworking3.1.0的设计原理和实现细节，为读者提供了深入理解该框架的机会。文章首先从AFNetworking的基本功能出发，讲解了如何使用AFNetworking发起网络请求...
AFNetworking最新源码
10-08
这个压缩包包含的是AFNetworking的最新源码，下面我们将深入探讨AFNetworking的核心知识点及其在实际开发中的应用。 1. **网络请求基础** - **URLSession**: AFNetworking基于Apple的URLSession API构建，提供了对...
AFNetworking-master_音乐_
10-01
在学习和使用这个“AFNetworking-master”项目时，开发者可以通过阅读源码来理解其内部实现机制，如何处理各种网络请求，以及如何优化网络通信。此外，如果项目中包含与音乐服务相关的代码，那么还可以了解到如何...
微信公众平台java开发完整项目示例程序源码---图灵机器人 微信智能回复
08-21
本例中列出了微信公众平台开发的所有流程的代码，包括接收xml数据、解析xml数据、调用图灵机器人api接口获取智能回复内容、封装结果xml数据等，简单明了，不明之处可查看个人博客中的讲解。
微信小程序源码-合集5.rar
09-04
在这个名为“微信小程序源码-合集5.rar”的压缩包中，包含了多个不同功能的小程序源代码，涵盖了娱乐、生活服务、社交等多个领域，下面将对这些源码中的关键知识点进行详细介绍。 1. **豆瓣小程序**：这个小程序...
AFNetWorking第三方类的学习体会
Apple_0611的专栏
07-30 933
等等
AFNetWorking源码
最新发布
weixin_61196797的博客
02-20 1254
的职责比较单一，只处理公钥和验证的逻辑，其定义是一个单例对象。此类主要由四个属性和一个方法构成。// 证书验证方式// 本地自签名证书集合// 是否验证证书的合法性(是否允许自签名证书)// 是否验证域名是否有效如果进行细分的话，的功能基本就两个。一个是通过CA的方式进行验证，另一个就是进行自签名验证。:是最主要的方法，用来进行证书的合法性验证。对请求数据的序列化，以及返回数据的反序列化做了很多处理。使开发者只需要传入一个字典即可构建请求参数，无需处理拼接到URL后面或参数转换为body。
AFNetworking源码<一>
wuyouyee的博客
04-05 470
AFNURLConnectionOperationAFNURLConnectionOperation是AFNetworking之前框架中完成网络请求的最主要的类, AFNURLConnectionOperation继承于NSOperation,服从NSURLConnectionDelegate,NSURLConnectionDataDelegate, NSSecureCoding,NSCopying
【原】AFNetworking源码阅读（五）
weixin_30363817的博客
02-01 161
【原】AFNetworking源码阅读（五） 本文转载请注明出处 —— polobymulberry-博客园 1. 前言 上一篇中提及到了Multipart Request的构建方法- [AFHTTPRequestSerializer multipartFormRequestWithMethod:URLString:parameters:constructingBodyWith...
iOS开发——AFNetworking源码（一）
weixin_51638861的博客
05-29 1784
iOS开发——AFNetworking源码（一） 简介 我们在学习AFNetworking之前，就必须知道AFNetworking是什么，具体有什么作用？ 首先，AFNetworking是一个功能非常强大的框架，主要是用于网络请求，把复杂的原生代码封装好，我们只需要简单的几步就可以完成网络请求。 代码组成 从上图可以看出AFNetworking中含有很多类，那么这些类与类之间有什么关系呢，具体关系如图所示： 我们来解读一下这个图，按照我的理解来说，显而易见的是AFURLSessionManager应该是主
AFNetworking-源码解析
Focus Now
05-27 6411
最近看AFNetworking2的源码，学习这个知名网络框架的实现，顺便梳理写下文章。AFNetworking2的大体架构和思路在这篇文章已经说得挺清楚了，就不再赘述了，只说说实现的细节。AFNetworking的代码还在不断更新中，我看的是AFNetworking2.3.1。 本篇先看看AFURLConnectionOperation，AFURLConnectionOperation继承自
iOS网络开发NSURLSession（二）DataTask＋Demo
热门推荐
Leo的专栏
03-23 1万+
原创blog，转载请注明出处 blog.csdn.net/hello_hwc欢迎关注我的IOS－SDK讲解专栏 http://blog.csdn.net/column/details/huangwenchen-ios-sdk.html前言： 这是IOS 网络开发系列的第三篇文章，这篇文章主要介绍了NSURLSession以及NSURLSessionTask这个抽象类，和NSURLSession
【AFNetWorking源码（二）AFURLSessionManger和AFHTTPSessionManager】
weixin_61639290的博客
05-17 952
在该模块中主要的任务就是发起网络请求。分成AFURLSessionManger和 AFHTTPSessionManager两部分来做处理。AFURLSessionManger是AFHTTPSessionManager的父类，其中AFURLSessionManger内部还包含AFURLSessionManagerTaskDelegate和_AFURLSessionTaskSwizzling；
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值