Swift - 使用URLSession进行数据的提交和获取

从 iOS7 开始，苹果推出了 URLSession ，在 OC 中叫 NSURLSession
URLSession层级

再使用之前我们先看一下URLSession的层级结构

URLSession
URLSessionconfiguration
URLSessionTask
URLSessionDataTask
- URLSessionUploadTask
URLSessionDownloadTask
URLSessionStreamTask

URLSession相关的代理方法

URLSessionDelegate
URLSessionTaskDelegate
URLSessionDataDelegate
URLSessionDownloadDelegate
URLSessionStreamDelegate

URLSession使用的时候也会用到相关的若干类：

NSURL
NSURLRequest
URLResponse
HTTPURLResponse
CachedURLResponse

1、请求的基本流程

创建 configurations ➡️ 创建 session ➡️ 创建 task ➡️ resume() 开始请求➡️ 监听回调
最简单的请求：

func saveScore(score:Int, userid:String)
{
    let urlString:String = "http://gank.io/api/xiandu/categories"
    var url:URL!
    url = URL(string:urlString)
    //发出请求
    URLSession.shared.dataTask(with: url) { (objectData, response, error) in
        guard error == nil else {
            print("网络出错:\(error!.localizedDescription)")
            return
        }
        
        guard objectData != nil else {
            print("数据为空：")
            return
        }
        
        do {
            let jsonData = try JSONSerialization.jsonObject(with: objectData!, options: .mutableContainers)
            print(jsonData)
        } catch {
            print("解析出错")
        }
    }.resume()
}

上面是 URLSession 的一个最基本的请求格式，其中 URLSession.shared 为我们提供了一个单例 session 对象，它为创建任务提供了默认配置。
其中省略了configurations 的设置，其实上面的代码也可以详细展开写成下面这样：

func method() -> Void {
    let urlString = "http://gank.io/api/xiandu/categories"
    let url = URL(string: urlString)!
    let configure = URLSessionConfiguration.default
    let session = URLSession.init(configuration: configure)
    session.dataTask(with: url) { (data, response, error) in
        guard error == nil else {
            NSLog("网络请求出错 -\(error.debugDescription)")
            return
        }
        guard data != nil else {
            NSLog("data 数据出错")
            return
        }
        do {
            let jsonObject = try JSONSerialization.jsonObject(with: data!, options: .mutableContainers)
            NSLog("\(jsonObject)")
        } catch {
            NSLog("解析出错")
        }
    }.resume()
}

URLSessionConfiguration有三种类型：

default：是默认的值，这和 URLSession.shared 创建的 session 是一样的，但是比起这个单例，它可以进行更多的扩展配置。

ephemeral： ephemeral 和 URLSession.shared 很相似，区别是不会写入caches, cookies 或 credentials（证书）到磁盘。

background：后台 session，可以在程序切到后台、崩溃或未运行时进行上传和下载。

URLSessionTask:

URLSessionTask 是一个表示任务对象的抽象类，一个会话（session）创建一个任务（task），这里任务是指获取数据、下载或上传文件。
task 任务有四种类型：

URLSessionDataTask：处理从HTTP get请求中从服务器获取数据到内存中。

URLSessionUploadTask：上传硬盘中的文件到服务器，一般是HTTP POST 或 PUT方式

URLSessionDownloadTask：从远程服务器下载文件到临时文件位置。

NSURLSessionStreamTask：基于流的URL会话任务，提供了一个通过 NSURLSession 创建的 TCP/IP 连接接口。

任务操作

注意：我们的网络任务默认是挂起状态的（suspend），在获取到 dataTask以后需要使用 resume() 函数来恢复或者开始请求。

resume()：启动任务

suspend()：暂停任务

cancel()：取消任务

2、后台下载

自从有了 URLSession ，iOS 才真正实现了后台下载。下面是一个简单的后台下载的实现。

1、初始化一个 background 的模式的 configuration

let configuration = URLSessionConfiguration.background(withIdentifier: self.createID())

2、通过 configuration 初始化网络下载会话，设置相关代理，回调数据信号响应。

let session = URLSession.init(configuration: configuration, delegate: self, delegateQueue: OperationQueue.main)

3、session 创建 downloadTask 任务- resume 启动

session.downloadTask(with: url).resume()

4、发起连接 - 发送相关请求 - 回调代理响应

由于 http 的分片传输，所以下载进度是隔一段时间回调一次的。

下载进度 的代理回调 urlSession(_ session: downloadTask:didWriteData bytesWritten: totalBytesWritten: totalBytesExpectedToWrite: )来监听下载进度：

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
    print(" bytesWritten \(bytesWritten)\n totalBytesWritten \(totalBytesWritten)\n totalBytesExpectedToWrite \(totalBytesExpectedToWrite)")
    print("下载进度: \(Double(totalBytesWritten)/Double(totalBytesExpectedToWrite))\n")
}

下载完成 的代理回调 didFinishDownloadingTo，实现下载完成转移临时文件里的数据到相应沙盒保存

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
    // 下载完成 - 开始沙盒迁移
    print("下载完成 - \(location)")
    let locationPath = location.path
    // 拷贝到用户目录（文件名以时间戳命名）
    let documnets = NSHomeDirectory() + "/Documents/" + self.lgCurrentDataTurnString() + ".mp4"
    print("移动地址:\(documnets)")
    //创建文件管理器
    let fileManager = FileManager.default
    try! fileManager.moveItem(atPath: locationPath, toPath: documnets)
}

5、开启后台下载权限

除了这些，想要实现后台下载还必须在 AppDelegate 中实现 handleEventsForBackgroundURLSession，开启后台下载权限：

class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    //用于保存后台下载的completionHandler
    var backgroundSessionCompletionHandler: (() -> Void)?
    func application(_ application: UIApplication, handleEventsForBackgroundURLSession identifier: String, completionHandler: @escaping () -> Void) {
        self.backgroundSessionCompletionHandler = completionHandler
    }
}

6、在 urlSessionDidFinishEvents 中回调系统回调

还需要在主线程中回调系统回调，告诉系统及时更新屏幕

func urlSessionDidFinishEvents(forBackgroundURLSession session: URLSession) {
    print("后台任务下载回来")
    DispatchQueue.main.async {
        guard let appDelegate = UIApplication.shared.delegate as? AppDelegate, let backgroundHandle = appDelegate.backgroundSessionCompletionHandler else { return }
        backgroundHandle()
    }
}

⚠️ 如果不实现这个代理里面的回调函数，依然可以实现后台下载，但会出现卡顿的问题，控制台也会出现警告。

Warning: Application delegate received call to -
application:handleEventsForBackgroundURLSession:completionHandler:
but the completion handler was never called.

以上的总结参考了并部分摘抄了以下文章，非常感谢以下作者的分享！：
Alamofire 学习（二）-URLSession 知识准备