详细解析几个和网络请求有关的类(十二) —— URL Sessi
版本记录
版本号 | 时间 |
---|---|
V1.0 | 2018.03.13 |
前言
我们做APP发起网络请求,一般都是使用框架,这些框架的底层也都是苹果的API,接下来几篇就一起来看一下和网络有关的几个类。感兴趣的可以看上面几篇文章。
1. 详细解析几个和网络请求有关的类 (一) —— NSURLSession
2. 详细解析几个和网络请求有关的类(二) —— NSURLRequest和NSMutableURLRequest
3. 详细解析几个和网络请求有关的类(三) —— NSURLConnection
4. 详细解析几个和网络请求有关的类(四) —— NSURLSession和NSURLConnection的区别
5. 详细解析几个和网络请求有关的类(五) —— 关于NSURL加载系统(一)
6. 详细解析几个和网络请求有关的类(六) —— 使用NSURLSession(二)
7. 详细解析几个和网络请求有关的类(七) —— URL数据的编码和解码(三)
8. 详细解析几个和网络请求有关的类(八) —— 处理重定向和其他请求更改(四)
9. 详细解析几个和网络请求有关的类(九) —— 身份验证挑战和TLS链验证(五)
10. 详细解析几个和网络请求有关的类(十) —— 理解获取缓存(六)
11. 详细解析几个和网络请求有关的类(十一) —— Cookies和自定义协议(七)
回顾
上一篇主要讲述关于Cookies和自定义协议,这一篇我们主要看一下URL Session的生命周期。
Life Cycle of a URL Session - URL Session的生命周期
您可以通过两种方式使用NSURLSession API
:使用系统提供的代理或使用您自己的代理。一般来说,如果您的应用程序执行以下任何操作,您必须使用您自己的代理:
- 当您的应用程序未运行时,使用后台会话下载或上传内容。
- 执行自定义验证。
- 执行自定义SSL证书验证。
- 决定传输是下载到磁盘还是根据服务器返回的MIME类型或其他类似标准显示。
- 上传来自正文流的数据(与NSData对象相反)。
- 以编程方式限制缓存。
- 以编程方式限制HTTP重定向。
如果您的应用不需要执行任何这些操作,则您的应用可以使用系统提供的代理。根据您选择的技术,您应该阅读以下部分之一:
- 使用Life Cycle of a URL Session with System-Provided Delegates提供了一个轻量级的视图,显示您的代码如何创建和使用URL会话。即使您打算编写自己的代理,也应该阅读本节,因为它可以让您完整了解代码的配置对象并使用它。
- 使用Life Cycle of a URL Session with Custom Delegates提供了URL会话操作中每个完整参考步骤。您应参考本节以帮助您了解会话如何与其代理进行交互。特别是,这解释了何时调用每个代理方法。
Life Cycle of a URL Session with System-Provided Delegates - 使用系统提供的代理的URL会话的生命周期
如果您在未提供代理对象的情况下使用NSURLSession类,则系统提供的委托将为您处理许多细节。这是您的应用程序必须完成的方法调用的基本顺序,以及在使用系统提供的代理使用NSURLSession时应用程序接收到的完成处理程序调用。
- 创建会话配置。对于后台会话,此配置必须包含唯一标识符。存储该标识符,并在应用程序崩溃或终止或挂起时使用该标识符与会话重新关联。
- 创建一个会话,指定一个配置对象和一个nil代理。
- 在每个表示资源请求的会话中创建任务对象。
每个任务都以暂停状态开始。在您的应用程序调用任务的resume方法后,它开始下载指定的资源。任务对象是NSURLSessionTask-NSURLSessionDataTask,NSURLSessionUploadTask或NSURLSessionDownloadTask
的子类,具体取决于您尝试实现的行为。
- 在每个表示资源请求的会话中创建任务对象。
尽管您的应用程序可以(并且通常应该)向会话添加多个任务,但为了简单起见,其余步骤按照单个任务来描述生命周期。
重要提示:如果您在未提供委托的情况下使用NSURLSession类,则您的应用程序必须使用带有completionHandler参数的调用来创建任务,否则它无法从类中获取数据。
- 对于下载任务,在从服务器传输期间,如果用户通知您的应用程序暂停下载,则通过调用cancelByProducingResumeData:方法来取消该任务。稍后,将返回的resume数据传递给
downloadTaskWithResumeData:
或downloadTaskWithResumeData:completionHandler:
方法以创建一个新的下载任务,以继续下载。
- 对于下载任务,在从服务器传输期间,如果用户通知您的应用程序暂停下载,则通过调用cancelByProducingResumeData:方法来取消该任务。稍后,将返回的resume数据传递给
- 当任务完成时,NSURLSession对象调用任务的完成处理程序。
注意:NSURLSession不会通过错误参数报告服务器错误。您的应用程序通过error参数收到的唯一错误是客户端错误,例如无法解析主机名或连接到主机。
URL Loading System Error Codes
中描述了错误代码。通过NSHTTPURLResponse
对象中的HTTP状态代码报告服务器端错误。有关更多信息,请阅读NSHTTPURLResponse和NSURLResponse类的文档。
- 当您的应用程序不再需要会话时,通过调用invalidateAndCancel(取消未完成的任务)或finishTasksAndInvalidate(以允许未完成的任务在使对象失效之前完成)来使其失效。
Life Cycle of a URL Session with Custom Delegates - 自定义代理的URL会话的生命周期
您通常可以在不提供代理的情况下使用NSURLSession
API。但是,如果您使用NSURLSession
API进行后台下载和上载,或者您需要以非默认方式处理身份验证或缓存,则必须提供遵循会话代理协议的代理,一个或多个任务代理协议或这些协议的一些组合。这个代理有许多用途:
- 与下载任务一起使用时,NSURLSession对象使用代理为您的应用程序提供文件URL,以便它可以获取下载的数据。所有后台下载和上传都需要代理。这些代理必须提供
NSURLSessionDownloadDelegate
协议中的所有代理方法。 - 代理们可以处理特定的认证挑战。
- 代理提供正文流以将基于流的数据上传到远程服务器。
- 代理可以决定是否遵循HTTP重定向。
- NSURLSession对象使用代理为您的应用程序提供每次传输的状态。数据任务代理既可以接收初始调用(可以将请求转换为下载),也可以接收随后的调用,这些调用在从远程服务器到达时提供数据片段。
- 代理是NSURLSession对象在传输完成时可以告诉您的应用程序的一种方式。
如果您正在使用具有URL会话的自定义代理(后台任务需要),则URL会话的完整生命周期更加复杂。以下是您的应用程序必须进行的方法调用的基本顺序,以及使用带有自定义代理的NSURLSession时你的APP接收的代理调用。
- 创建会话配置。对于后台会话,此配置必须包含唯一标识符。存储该标识符,并在应用程序崩溃或终止或挂起时使用该标识符与会话重新关联。
- 创建一个会话,指定一个配置对象以及一个可选的代理。
- 在每个表示资源请求的会话中创建任务对象。每个任务都以暂停状态开始。在您的应用程序调用任务resume方法后,它开始下载指定的资源。任务对象是
NSURLSessionTask-NSURLSessionDataTask,NSURLSessionUploadTask或NSURLSessionDownloadTask
的子类,具体取决于您尝试实现的行为。尽管您的应用程序可以(并且通常应该)向会话添加多个任务,但为了简单起见,下面其余步骤按照单个任务来描述生命周期。
- 在每个表示资源请求的会话中创建任务对象。每个任务都以暂停状态开始。在您的应用程序调用任务resume方法后,它开始下载指定的资源。任务对象是
-
- 如果远程服务器返回一个状态码,该状态码指示需要身份验证,并且该身份验证需要连接级别质询(如SSL客户端证书),则NSURLSession将调用身份验证质询代理方法。
- 对于会话级挑战-
NSURLAuthenticationMethodNTLM,NSURLAuthenticationMethodNegotiate,NSURLAuthenticationMethodClientCertificate或NSURLAuthenticationMethodServerTrust
-NSURLSession
对象调用会话委托的URLSession:didReceiveChallenge:completionHandler:
方法。如果您的应用程序未提供会话代理方法,则NSURLSession对象会调用任务代理的URLSession:task:didReceiveChallenge:completionHandler:
方法来处理该挑战。 - 对于非会话级挑战(所有其他挑战),
NSURLSession
对象调用会话代理的URLSession:task:didReceiveChallenge:completionHandler:
方法来处理挑战。如果您的应用程序提供了会话代理,并且您需要处理身份验证,那么您必须在任务级别处理身份验证,或者提供明确调用每会话处理程序的任务级别处理程序。会话代理的URLSession:didReceiveChallenge:completionHandler:
方法低于非会话级别的挑战不会调用。
注意:
Kerberos
身份验证是透明处理的。
如果上传任务的认证失败,如果任务的数据是从流中提供的,则NSURLSession
对象将调用代理的URLSession:task:needNewBodyStream:代理方法。代理必须提供一个新的NSInputStream
对象来为新的请求提供正文数据。
有关为NSURLSession
编写身份验证代理方法的更多信息,请参阅Authentication Challenges and TLS Chain Validation。
-
- 在收到HTTP重定向响应后,
NSURLSession
对象调用代理的URLSession:task:willPerformHTTPRedirection:newRequest:completionHandler:方法。该代理方法调用提供的NSURLRequest
对象(遵循重定向),新的NSURLRequest对象(重定向到不同的URL)或nil(将重定向的响应主体视为有效的响应并将其返回)完成处理程序作为结果)。
- 如果遵循重定向,请返回到步骤4(验证质询处理)。
- 如果代理没有实现此方法,则重定向会跟随最大数量的重定向。
- 在收到HTTP重定向响应后,
- 对于通过调用ddownloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:创建的(重新)下载任务,
NSURLSession
使用新任务对象调用代理的URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:方法。
- 对于通过调用ddownloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:创建的(重新)下载任务,
- 对于数据任务,NSURLSession对象调用代理的URLSession:dataTask:didReceiveResponse:completionHandler:方法。决定是否将数据任务转换为下载任务,然后调用完成回调来继续接收数据或下载数据。如果您的应用程序选择将数据任务转换为下载任务,则NSURLSession将新下载任务作为参数调用代理的URLSession:dataTask:didBecomeDownloadTask:方法。在这次调用之后,代理不再接收来自数据任务的进一步回调,并开始接收来自下载任务的回调。
- 如果任务是使用uploadTaskWithStreamedRequest:创建的,则NSURLSession将调用代理的URLSession:task:needNewBodyStream:方法来提供正文数据。
- 在将主体内容初始上传到服务器(如果适用)期间,代理会定期接收 URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:报告上载进度的回调。
- 在从服务器传输过程中,任务代理会定期收到一个回调来报告传输进度。对于下载任务,会话调用代理的URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:方法,其中可以获得成功写入磁盘的字节数。对于数据任务,会话会在接收到实际的数据段时调用委托的URLSession:dataTask:didReceiveData:方法。
对于下载任务,在从服务器传输期间,如果用户通知您的应用程序暂停下载,则通过调用cancelByProducingResumeData:方法取消该任务。
- 在从服务器传输过程中,任务代理会定期收到一个回调来报告传输进度。对于下载任务,会话调用代理的URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:方法,其中可以获得成功写入磁盘的字节数。对于数据任务,会话会在接收到实际的数据段时调用委托的URLSession:dataTask:didReceiveData:方法。
稍后,如果用户要求您的应用程序继续下载,请将所返回的resume数据传递给downloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:方法以创建一个可继续下载的新下载任务,然后转到步骤3(创建并恢复任务对象)。
- 对于数据任务,NSURLSession对象调用代理的URLSession:dataTask:willCacheResponse:completionHandler:方法。然后你的应用程序应该决定是否允许缓存。如果您未实现此方法,则默认行为是使用会话配置对象中指定的缓存策略。
- 如果下载任务成功完成,则NSURLSession对象调用任务的URLSession:downloadTask:didFinishDownloadingToURL:方法并获取临时文件的位置。在此代理方法返回之前,您的应用必须从此文件读取响应数据或将其移至应用沙箱容器目录中的永久位置。
- 当任何任务完成时,NSURLSession对象调用返回错误对象或nil(如果任务成功完成)的代理的URLSession:task:didCompleteWithError:方法。如果任务失败,则大多数应用程序都应该重试请求,直到用户取消下载或服务器返回错误,表明请求永远不会成功。但是,您的应用不应该立即重试。相反,它应该使用reachability API来确定服务器是否可联通,并且仅当它收到reachability已更改的通知时才应发出新请求。
如果可以恢复下载任务,则NSError
对象的userInfo
字典包含NSURLSessionDownloadTaskResumeData键的值。您的应用应该传递此值调用downloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:创建一个新的下载任务,以继续现有的下载。
如果任务无法恢复,您的应用程序应该创建一个新的下载任务并从头开始重新启动事务。
无论哪种情况,如果由于服务器错误以外的其他原因导致传输失败,请转至步骤3(创建并恢复任务对象)。
注意:
NSURLSession
不会通过错误参数报告服务器错误。代理通过error参数收到的唯一错误是客户端错误,例如无法解析主机名或连接到主机。URL Loading System Error Codes
中描述了错误代码。
通过NSHTTPURLResponse
对象中的HTTP状态代码报告服务器端错误。有关更多信息,请阅读NSHTTPURLResponse和NSURLResponse类的文档。
- 如果响应是多部分编码的,那么会话可以再次调用代理的
didReceiveResponse
方法,然后再调用零个或多个额外的didReceiveData
调用。如果发生这种情况,请转到步骤7(处理didReceiveResponse
调用)。
- 如果响应是多部分编码的,那么会话可以再次调用代理的
- 当您不再需要会话时,通过调用
invalidateAndCancel
(取消未完成的任务)或finishTasksAndInvalidate
(以允许未完成的任务在使对象失效之前完成)来使其无效。在使会话无效之后,当所有未完成的任务已被取消或完成时,会话向委托发送一个URLSession:didBecomeInvalidWithError:
消息。当该代理方法返回时,会话将处理其对代理的强烈引用。
- 当您不再需要会话时,通过调用
重要提示:会话对象保持对代理的强引用,直到您的应用程序明确地使会话失效。如果您不会使会话失效,您的应用程序会泄漏内存。
如果您的应用取消正在进行的下载,则NSURLSession对象会像发生错误一样调用代理的URLSession:task:didCompleteWithError:方法。
后记
本篇介绍了关于URL Session的生命周期问题,喜欢的就给个赞或者点个关注~~~