2018-07-19

NSURLRequest

概述

NSURLRequest封装了加载请求的两个基本数据元素:要加载的URL，以及在查询实现提供的URL内容缓存时要使用的策略。

重要的

这个类只用于封装关于URL请求的信息。您必须使用其他类(如URLSession)将这些请求发送到服务器。

NSURLRequest被设计成通过创建扩展来支持其他协议，这些扩展为您自己的特定于协议的属性提供访问器方法。这些方法可以通过调用URLProtocol methods属性(forKey:in:)和setProperty(_:forKey:in:)来获取和设置实际值。

NSURLRequest的可变子类是NSMutableURLRequest。

重要的

Foundation框架的Swift覆盖提供了URLRequest结构，它连接到NSURLRequest类及其可变子类NSMutableURLRequest。

UIWebView

在应用程序中嵌入web内容的视图。

SDK   在iOS 2.0 - -12.0弃用

框架   UIKit

请注意

在iOS 8及以后运行的应用程序中，使用WKWebView类而不是使用UIWebView。此外，如果呈现不应该运行JavaScript的文件，请考虑将WKPreferences属性JavaScript设置为false。

WKWebView

显示交互式web内容的对象，如应用程序内的浏览器。

SDK   在 iOS 8.0+    macOS 10.10 + 使用

框架   WebKit

重要的

从iOS 8.0和OS X 10.10开始，使用WKWebView向应用中添加web内容。不要使用UIWebView或WebView。

您可以使用WKWebView类在应用程序中嵌入web内容。为此，创建一个WKWebView对象，将其设置为视图，并发送一个请求来加载web内容。

请注意

您可以在WKWebView中使用httpBody内容发出POST请求。

在使用init(frame:configuration:)方法创建一个新的WKWebView对象之后，需要加载web内容。使用loadHTMLString(_:baseURL:)方法开始加载本地HTML文件或load(_:)方法开始加载web内容。使用stopLoading()方法停止加载，使用isLoading属性确定web视图是否正在加载。将委托属性设置为符合WKUIDelegate协议的对象，以跟踪web内容的加载。参见清单1以编程方式创建WKWebView的示例。

清单1

以编程方式创建一个WKWebView

import UIKit

import WebKit

class ViewController: UIViewController, WKUIDelegate {

    var webView: WKWebView!

        override func loadView() {

        let webConfiguration = WKWebViewConfiguration()

        webView = WKWebView(frame: .zero, configuration: webConfiguration)

        webView.uiDelegate = self

        view = webView

    }

    override func viewDidLoad() {

        super.viewDidLoad()

        let myURL = URL(string:ps://www.apple.com")

        let myRequest = URLRequest(url: myURL!)

        webView.load(myRequest)

    }}

要允许用户在页面历史中前后移动，可以使用goBack()和goForward()方法作为按钮的操作。使用canGoBack和canGoForward属性，在用户无法朝某个方向移动时禁用按钮。

默认情况下，web view会自动将出现在web内容中的电话号码转换为电话链接。当一个电话连接被监听时，手机应用程序就会启动并拨通号码。要关闭此默认行为，请使用不包含phoneNumber标志的WKDataDetectorTypes位字段设置datadectortypes属性。

还可以使用set放大率(_:centeredAt:)在web内容第一次显示在web视图中时以编程方式设置它的比例。之后，用户可以使用手势来改变缩放比例。

URLSession

协调一组相关网络数据传输任务的对象。

SDK   在 iOS 7.0 +       macOS 10.9 +       tvo 9.0 +        watchOS 2.0 + 使用

概述

URLSession类和相关类为下载内容提供了一个API。这个API为支持身份验证提供了一组丰富的委托方法，并使应用程序能够在应用程序不运行时执行后台下载，或者在iOS中，当应用程序暂停时执行后台下载。

重要的

URLSession API涉及到许多不同的类，它们以一种相当复杂的方式协同工作，如果您自己阅读参考文档，这可能并不明显。在使用此API之前，您应该阅读URL加载系统主题的概述。第一步部分中的文章提供了使用URLSession执行常见任务的示例。

使用URLSession API，您的应用程序创建一个或多个会话，每个会话协调一组相关的数据传输任务。例如，如果您正在创建一个web浏览器，您的应用程序可能会为每个选项卡或窗口创建一个会话，或者一个会话用于交互式使用，另一个会话用于后台下载。在每个会话中，您的应用程序添加一系列任务，每个任务表示对特定URL的请求(如果需要，遵循HTTP重定向)。

类型的URL会话

给定URL会话中的任务共享一个公共会话配置对象，该对象定义了连接行为，例如对单个主机进行的最大同时连接数量，是否允许通过蜂窝网络进行连接，等等。

URLSession有一个用于基本请求的单例共享会话(它没有配置对象)。它不像您创建的会话那样可定制，但如果您有非常有限的需求，它是一个很好的起点。通过调用共享类方法访问此会话。对于其他类型的会话，您使用以下三种配置之一实例化URLSession:

默认会话的行为类似于共享会话，但允许进行更多配置，并允许您使用委托增量地获取数据。

短暂的会话与共享会话类似，但是不要向磁盘写入缓存、cookie或凭据。

后台会话允许您在应用程序不运行时在后台执行内容的上传和下载。

有关创建每种配置类型的详细信息，请参见在URLSessionConfiguration类中创建会话配置对象。

URL会话任务的类型

在会话中，您可以创建任务，可选地将数据上载到服务器，然后以磁盘上的文件或内存中的一个或多个NSData对象的形式从服务器检索数据。URLSession API提供了三种类型的任务:

数据任务使用NSData对象发送和接收数据。数据任务是用于向服务器发出简短的、通常是交互式的请求。

上传任务与数据任务类似，但它们也发送数据(通常以文件的形式)，并在应用程序不运行时支持后台上传。

下载任务以文件的形式检索数据，并且在应用程序没有运行时支持后台下载和上传。

使用一个会话委托

会话中的任务还共享一个公共委托，该委托允许您在发生各种事件时提供和获取信息——当身份验证失败时，当来自服务器的数据到达时，当数据准备缓存时，等等。使用URL会话可以逐步地列出会话执行任务时发生的事件，以及调用哪个委托方法。

另一方面，如果您不需要委托提供的任何特性，您可以在创建会话时使用这个API，而不提供一个通过nil的方法。

重要的

会话对象保存对委托的强引用，直到应用程序退出或显式地使会话无效为止。如果你不让会话失效，你的应用程序会泄漏内存，直到它退出。

异步性和URL会话

与大多数网络API一样，URLSession API是高度异步的。它以两种方式向应用程序返回数据，具体取决于您调用的方法:

通过调用一个完成处理程序块，当传输完成成功或有错误时。

通过调用会话委托上的方法作为接收数据和传输完成时的方法。

除了向委托交付这些信息之外，URLSession API还提供了状态和进度属性，如果您需要根据任务的当前状态进行编程决策，您可以查询这些属性(需要注意的是，它的状态随时都可能改变)。

URL会话还支持取消、重新启动或恢复、暂停任务，并提供恢复暂停、取消或失败下载的能力。

协议支持

URLSession类本机支持数据、文件、ftp、http和https URL方案，对代理服务器和SOCKS网关进行透明的支持，在用户的系统首选项中配置。

URLSession支持HTTP/1.1、SPDY和HTTP/2协议。RFC 7540描述了HTTP/2支持，并要求服务器支持ALPN或NPN进行协议协商。

您还可以通过子类化URLProtocol为您自己的自定义网络协议和URL计划(为您的应用程序的私有使用)添加支持。

App Transport Security (ATS)

从iOS 9.0和OS X 10.11开始，默认情况下，所有使用URLSession建立的HTTP连接都会启用一个名为App Transport security (ATS)的新安全特性。ATS要求HTTP连接使用HTTPS (RFC 2818)。

使用一个URL会话

使用URLSession类发出请求:

1. 创建一个会话配置。对于后台会话，此配置必须包含唯一标识符。存储该标识符，并在应用程序崩溃或终止或暂停时使用它与会话重新关联。

2. 创建一个会话，指定一个配置对象和一个可选的委托。

3. 在会话中创建任务对象，每个对象表示一个资源请求。这些任务对象是URLSessionTask-URLSessionDataTask、URLSessionUploadTask或URLSessionDownloadTask的子类，具体取决于您试图实现的行为。每个任务都以暂停状态开始。在应用程序调用任务的resume()之后，它开始下载指定的资源。

启动任务后，会话调用其委托的方法，如下:

1. 如果与服务器的初始握手需要连接级别的挑战(比如SSL客户端证书)，则URLSession调用URLSession (_:task:didReceive:completionHandler:)或URLSession (_:didReceive:completionHandler:)委托方法。

2. 如果从流中提供任务的数据，则URLSession对象调用委托的URLSession (_:task:needNewBodyStream:)委托方法来获取InputStream实例，该实例为新请求提供主体数据。

3. 在将主体内容初始上载到服务器(如果适用的话)期间，委托定期接收urlSession(_:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:)回调，报告上传进度。

4. 服务器发送一个响应。

5. 如果响应表明需要身份验证，会话将调用其委托的urlSession(_:task:didReceive:completionHandler:)方法。回到步骤2。

6. 如果响应是一个HTTP重定向响应，URLSession对象调用委托的URLSession(_:任务:willPerformHTTPRedirection:newRequest:completionHandler:)方法。该委托方法使用提供的NSURLRequest对象(跟踪重定向)、新的NSURLRequest对象(重定向到不同的URL)或nil(将重定向的响应主体视为有效响应并将其作为结果返回)来调用提供的完成处理程序。

    — 如果您决定遵循重定向，请回到步骤2。

    — 如果委托没有实现此方法，那么重定向将被跟踪到重定向的最大数量。

7. 对于通过调用downloadTask(with resumedata:)或downloadTask(with resumedata:)创建的下载(或重新下载)任务，URLSession使用新的任务对象调用委托的URLSession (_:downloadTask:didResumeAtOffset:expected tedtotalbytes:)方法。

8. 对于数据任务，URLSession对象调用委托的URLSession (_:dataTask:didReceive:completionHandler:)方法。决定是否将数据任务转换为下载任务，然后调用完成处理程序来转换、继续或取消任务。如果您的应用程序选择将数据任务转换为下载任务，URLSession以新的下载任务为参数调用委托的URLSession (_:dataTask:didBecome:)方法。在此调用之后，委托不再接收来自数据任务的进一步回调，并开始接收来自下载任务的回调。

9. 在从服务器进行传输期间，委托定期接收任务级回调，以报告传输进度。对于数据任务，会话调用委托的urlSession(_:dataTask:didReceive:)方法，并在接收数据时调用它们的实际数据片段。对于一个下载任务，会话调用委托的urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:)方法，成功写入磁盘的字节数。如果用户告诉应用程序暂停下载，通过调用cancel(通过producingresumedata:)方法取消任务。稍后，如果用户要求您的应用程序继续下载，则将返回的简历数据传递给downloadTask(withResumeData:)或downloadTask(withResumeData:completionHandler:)，以创建一个新的下载任务，继续下载。(步骤1)。

10. 对于一个数据任务，URLSession对象可以调用委托的URLSession (_:dataTask:willCacheResponse:completionHandler:)方法。然后应用程序应该决定是否允许缓存。如果不实现此方法，默认行为是使用会话配置对象中指定的缓存策略。如果响应是多部分编码的，会话可能再次调用委托的didReceiveResponse方法，然后是零个或多个额外的didReceiveData调用。如果发生这种情况，请转到步骤8(处理didReceiveResponse调用)。

11. 如果下载任务成功完成，则URLSession对象调用任务的URLSession (_:downloadTask:didFinishDownloadingTo:)方法，该方法具有临时文件的位置。应用程序必须从这个文件中读取响应数据，或者在这个委托方法返回之前将其移动到一个永久位置。

12.如果下载任务成功完成，则URLSession对象调用任务的URLSession (_:downloadTask:didFinishDownloadingTo:)方法，该方法具有临时文件的位置。应用程序必须从这个文件中读取响应数据，或者在这个委托方法返回之前将其移动到一个永久位置。

13. 当任何任务完成时，URLSession对象调用委托的URLSession (_:task:didCompleteWithError:)方法，该方法具有错误对象或nil(如果任务成功完成)。如果可以继续下载任务，则NSError对象的userInfo字典包含nsurlsessiondownloadtask_taskresumedata键的值。应用程序应该将此值传递给downloadTask(withResumeData:)或downloadTask(withResumeData:completionHandler:)，以创建一个新的下载任务，继续现有的下载。如果任务无法恢复，您的应用程序应该创建一个新的下载任务，并从开始重新启动事务。在任何一种情况下，如果传输失败(除了服务器错误之外)，请转到步骤3(创建和恢复任务对象)。

14. 如果您不再需要会话，您可以通过调用invalidateAndCancel()(取消未完成的任务)或finishTasksAndInvalidate()(允许未完成的任务在对象无效之前完成)来使其无效。如果您不取消会话，那么当您的应用程序终止时，会话将自动消失(除非它是一个有活动任务的后台会话)。在使会话无效之后，当所有未完成的任务被取消或完成时，会话调用委托的urlSession(_:didBecomeInvalidWithError:)方法。当该委托方法返回时，会话处理它对委托的强引用。

如果应用程序取消正在进行的下载，URLSession对象会调用委托的URLSession (_:task:didCompleteWithError:)方法，就好像发生了错误一样。

NSCopying行为

会话和任务对象遵循以下NSCopying协议:

当你的应用程序复制一个会话或任务对象时，你会得到相同的对象。

当你的应用程序复制一个配置对象时，你会得到一个可以独立修改的新拷贝。

线程安全

URL会话API本身是线程安全的。您可以在任何线程上下文中自由地创建会话和任务，当您的委托方法调用所提供的完成处理程序时，工作将自动调度到正确的委托队列上。

警告

您的urlSessionDidFinishEvents(forBackgroundURLSession:)会话委托方法可以在辅助线程上调用。但是，在iOS中，该方法的实现可能需要调用应用程序中提供的完成处理程序(_:handleeventsforbackgrounddurlsession:completionHandler:)。您必须在主线程上调用完成处理程序。

上述是从苹果文档里翻译过来的，没有任何人为修饰加工，只是翻译的有点晦涩难懂。对付着看吧。