# 也许你根本不需要Alamofire,何不尝试下NSURLSession?

语言：zh-CN
原文：[也许你根本不需要Alamofire,何不尝试下NSURLSession?](<https://allluckly.cn/%E6%8A%95%E7%A8%BF/tuogao10>)
中文：[中文 HTML](<https://allluckly.cn/%E6%8A%95%E7%A8%BF/tuogao10>)
English: [English HTML](<https://allluckly.cn/en/journal/2016-01-25-do-you-need-alamofire-trying-nsurlsession-instead/>)
发布于: 2016-01-25T00:00:00+08:00
内容更新于: 2016-01-25T00:00:00+08:00
署名：大石头布

从最简单的数据请求开始介绍 NSURLSession，区分数据、下载和上传任务，并比较默认、临时与后台配置，说明缓存、Cookie 和网络任务组织之间的关系。

原文署名大石头布，Bison 编辑收录。

[原文所列来源](<http://www.jianshu.com/p/e9acff2d990f>)

**阅读前** 这是 2015–2017 年间的技术记录，本次整理未重新运行验证示例。原文发表于 2016 年，保留当时的 Swift 与 NSURLSession 命名。

编辑：[Bison](<https://allluckly.cn/>)  
 投稿：[大石头布](<http://www.jianshu.com/p/e9acff2d990f>)

> "很多同学在遇到要使用网络请求的时候，无脑Alamofire，不是说这个库不好用。毕竟第三方，毕竟还要学习他得使用方法，还要引入他得代码。为何不尝试下使用NSURLSession，以前NSURLConnection操作起来有很多不便，大家可能都愿意使用第三方库。但是现在的NSURLSession使用起来已经很方便了。我们何不利用学习Alamofire的时间来学习学习NSURLSession呢？第三方库也许有很多对json处理方便的加强功能，但是我们有时候只需要用他来做get , put ,post delete 请求 。还有一些下载上传 、断点下载等功能 其实NSURLSession已经够用了。"

最简单的调用

```

if let url = NSURL(string: "https://httpbin.org/get") {

    NSURLSession.sharedSession().dataTaskWithURL(url){ data, response, error in

    //...

}.resume()

}

```

拿到一个 url 获取默认的session来处理url返回我们想要的数据

> resume() 方法的调用，NSURLSession 默认是不启动的，我们必须手工调用 resume() 方法，才会开始请求

NSURLSession 本身是不会进行请求的，而是通过创建 task 的形式进行网络请求，同一个 NSURLSession 可以创建多个 task，并且这些 task 之间的 cache 和 cookie 是共享的。那么我们就来看看 NSURLSession 都能创建哪些 task 吧。

- NSURLSessionDataTask: 这个就是我们第一个例子中创建的 DataTask,它主要用于读取服务端的简单数据，比如 JSON 数据。其实这个请求不只是可以去数据，修改，新增都是可以的，put , post
- NSURLSessionDownloadTask: 这个 task 的主要用途是进行文件下载，它针对大文件的网络请求做了更多的处理，比如下载进度，断点续传等等。
- NSURLSessionUploadTask: 和下载任务对应，这个 task 主要是用于对服务端发送文件类型的数据使用的。

图片来源于网络  
 ![1](<https://allluckly.cn/images/blog/tuogao/tougao10/1.png>)

那么NSURLSession只能通过NSURLSession.sharedSession()获得吗？ – NO，NSURLSession很强大 也是高度可配置的

### NSURLSessionConfiguration

我们还可以通过NSURLSessionConfiguration来创建一个NSURLSession 。有三种配置类型可供我们选择

- defaultSessionConfiguration - 这个配置会使用全局的缓存，cookie 等信息，这个相当于 NSURLSessionConfiguration 的默认配置行为。
- ephemeralSessionConfiguration - 这个配置不会对缓存或 cookie 以及认证信息进行存储，相当于一个私有的 Session，如果你开发一个浏览器产品，这个配置就相当于浏览器的隐私模式。
- backgroundSessionConfiguration - 这个配置可以让你的网络操作在你的应用切换到后台的时候还能继续工作。

整个结构大概就是这样的

图片来源于网络  
 ![1](<https://allluckly.cn/images/blog/tuogao/tougao10/2.png>)

`NSURLSessionConfiguration` 还支持配置session的一些属性，比如timeout 、cache添加http header等，可以在[这里](<https://developer.apple.com/library/mac/documentation/Foundation/Reference/NSURLSessionConfiguration_class/index.html#//apple_ref/occ/cl/NSURLSessionConfiguration>)查阅所有可配置信息

那么我们来尝试创建一个任务

```
//定义一个默认的session
lazy var defaultSession = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
//获取data的task
var dataTask:NSURLSessionDataTask?

/**
任务
*/
func doTask(){
    guard let url = NSURL(string: "http://your.url") else { return }
    dataTask = defaultSession.dataTaskWithURL(url)
    dataTask?.resume()
}
```

这个例子 跟上面的简单例子如出一辙，不过时我们自己创建的session，把步骤分开了。

看看如何去配置呢

```
func doTask2(){
    let configuration = NSURLSessionConfiguration.defaultSessionConfiguration()
    configuration.timeoutIntervalForRequest = 10 //超时时间
    configuration.requestCachePolicy = .UseProtocolCachePolicy //缓存策略
    configuration.HTTPAdditionalHeaders = ["Content-Type":"application/json"] //header 配置

    //更多配置详见官方文档...

    let defaultSession2 = NSURLSession(configuration:configuration)
    //获取data的task
    var dataTask:NSURLSessionDataTask?

    guard let url = NSURL(string: "http://your.url") else { return }
    let request = NSMutableURLRequest(URL: url)
    request.HTTPMethod = "get" //post put delete 等
    //还有很多可以设置  更多设置 详细 command + 点击 NSMutableURLRequest  就可以看到了

    dataTask = defaultSession2.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in

    //操作数据

    })

    dataTask?.resume() //开启任务
}
```

我们可以对configuration和request进行配置 来达到我们想要的目的

对请求的操作室基于task的 这里的task也是可以cancel的

那么下载呢？

```

lazy var downloadsSession:NSURLSession = {
    let configuration = NSURLSessionConfiguration.defaultSessionConfiguration()

    //delegateQueue设置为nil session会自己创建一个串行的队列
    return NSURLSession(configuration: configuration, delegate: self, delegateQueue: nil)
}()
下载创建session和普通的请求差不多，我们这里添加了代理就可以拿到下载进度

func doDownload(){
    guard let url = NSURL(string: "http://your.download.url") else { return }
    let downloadTask = downloadsSession.downloadTaskWithURL(url)
    downloadTask.resume()
}

```

完成回调可以用闭包 也可以代理。但是要拿到下载进度 必须用代理了

```
class yourClass:NSURLSessionDownloadDelegate{
    func URLSession(session: NSURLSession, downloadTask: NSURLSessionDownloadTask, didFinishDownloadingToURL location: NSURL) {

        print("下载完成")
        if let originalURL = downloadTask.originalRequest?.URL?.absoluteString,destinationURL = localFilePathForUrl(originalURL){
            print("本地的临时地址 : \(destinationURL)")

            let fileManager = NSFileManager.defaultManager()

        do {
            try fileManager.removeItemAtURL(destinationURL)

        } catch let error as NSError {
            print("Error: \(error.localizedDescription)")
        }

        do {
            try fileManager.copyItemAtURL(location, toURL: destinationURL)
        } catch let error as NSError {
            print("Error: \(error.localizedDescription)")
        }

        }
    }


    /**
    监控下载进度
    */
    func URLSession(session: NSURLSession, downloadTask: NSURLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {

        if let downloadUrl = downloadTask.originalRequest?.URL?.absoluteString,download = activeDownloads[downloadUrl]{

                download.progress =  Float(totalBytesWritten)/Float(totalBytesExpectedToWrite)
                let totalSize = NSByteCountFormatter.stringFromByteCount(totalBytesExpectedToWrite, countStyle: NSByteCountFormatterCountStyle.Binary)
                if let trackIndex = trackIndexForDownloadTask(downloadTask),trackCell = tableView.cellForRowAtIndexPath(NSIndexPath(forRow: trackIndex, inSection: 0)) as? TrackCell{


                }

        }

}
```

当然下载过程中也是可以取消的 直接调用task.cancel()

如果需要暂停

```
task.cancelByProducingResumeData { data in
    if data != nil {
        //将data保存本地 或者 内存 
    }
}
```

继续下载

```
//resumeData 为上次保存的data
task = downloadsSession.downloadTaskWithResumeData(resumeData)

task.resume()
```

上传参照下载。。

本文参照 以及推荐扩展阅读

http://www.raywenderlich.com/110458/nsurlsession-tutorial-getting-started

http://swiftcafe.io/2015/12/20/nsurlsession/

http://swiftcafe.io/2015/12/23/nsurlsession-app/

http://www.jianshu.com/p/fb5aaeac06ef

建议大家去读下raywenderlich的这片文章 讲的很细

---

好文推荐：[iOS开发之详解连连支付集成](<https://allluckly.cn/ios%E6%94%AF%E4%BB%98/lianlianzhifu>)

