一 、 URLSession 的介绍
1、URLSession在2013年随着iOS7的发布一起面世，苹果对它的定位是作为NSURLConnection的替代者。
2、在七层网络协议中有：物理层->数据链路层->网络层->传输层->会话层->表示层->应用层。那我们可以将NSURLSession类理解为会话层，用于管理网络接口的创建、维护、删除等等工作，我们要做的工作也只是会话层之后的层。
二 、 URLSessionConfiguration 的介绍
1、URLSessionConfiguration 的介绍
URLSessionConfiguration 是一个配置对象，定义了一个 URL 会话的行为和规则。
2、 URLSessionConfiguration 的三种模式
1、默认会话模式（default）:使用的是基于磁盘缓存的持久化策略，使用用户keychain中保存的证书进行认证授权。
2、暂时会话模式（ephemeral）: 该模式不使用磁盘保存任何数据。所有和会话相关的caches，证书，cookies等都被保存在RAM中，因此当程序使会话无效，这些缓存的数据就会被自动清空。
3、后台会话模式 (background): 该模式在后台完成上传和下载，在创建Configuration对象的时候需要提供一个NSString类型的ID用于标识完成工作的后台会话。
样式如下：
URLSessionConfiguration.default
URLSessionConfiguration.ephemeral
URLSessionConfiguration.background(withIdentifier: "nw-Session")
三、在下面用到的一些函数，网址编码/ 数据解析
// TODO : 数据解析
func nwDataParsing(data:Data) -> Any {
/**
先判断是否可以解析
*/
return try! JSONSerialization.jsonObject(with: data as Data, options:.mutableContainers)
}
// TODO : 网址编码处理
func urlEncoding(str:String?) -> String {
if (str != nil) && str!.characters.count != 0 {
return str!.addingPercentEncoding(withAllowedCharacters: .urlFragmentAllowed)!
}
return str!
}
四 、URLSessionTask 的子类关联
2E921CC8-5035-48D5-B499-FEDF9EADED29.png
各个类的介绍
- URLSessionTask : 一个可撤销的对象,指的是生命周期内处理一个给定的请求。
- URLSessionDataTask : 一个 数据请求 的 URLSessionTask 的子类，用于数据的请求。
- URLSessionUploadTask : 是一个 上传数据 的 URLSessionDataTask 的子类。
- URLSessionDownloadTask ： 是一个下载数据 的 URLSessionTask 的子类。
- URLSessionStreamTask : 是一个双向会话的 URLSessionTask 的子类。
五 、URLSession 的 GET 类型的请求数据
// MARK : 一般的 URLSession 的请求（Get类型）
func urlSessionGet() -> Void {
/**
先创建一个请求链接
*/
var linkstr = "https://m.maoyan.com/movie/list.json?type=hot&offset=0&limit=1"
/**
链接转码
*/
linkstr = linkstr.addingPercentEncoding(withAllowedCharacters: .urlFragmentAllowed)!
/**
创建请求网址
*/
let url = URL.init(string: linkstr)
/**
创建请求体
*/
let request = URLRequest.init(url: url!, cachePolicy: .reloadIgnoringCacheData, timeoutInterval: 30)
/**
创建一个NSURLSession 对象
*/
let NwSession = URLSession.shared
/**
创建一个 Task 对象
*/
let NwTask = NwSession.dataTask(with: request) { ( data, urlRespone, error) in
/**
判断是否有数据
*/
if !(data == nil) && (error == nil) {
let Nwdictionary = self.nwDataParsing(data: data!)
print(Nwdictionary)
}
}
/**
开启Task
*/
NwTask.resume()
}
六、URLSession请求下载数据
1、普通的下载数据形式
// MARK : URLSession 的文件下载
func sessionDownloadTask() -> Void {
/**
创建一个链接
*/
var dlStr = "http://files.heweather.com/china-city-list.txt"
/**
网址编码
*/
dlStr = self.urlEncoding(str: dlStr)
/**
创建请求的网址
*/
let dlUrl = URL.init(string: dlStr)
/**
创建请求体
*/
let request = URLRequest.init(url: dlUrl!)
/**
创建Session对象
*/
let NwSession = URLSession.shared
/**
创建下载的Task
*/
let loadTask = NwSession.downloadTask(with: request) { (dLoadUrl, response, error) in
/**
下载文件的地址
*/
print(dLoadUrl!)
/**
获取下载文件的数据
*/
let data = try! NSData.init(contentsOfFile: dLoadUrl!.path, options: .mappedIfSafe)
print(String.init(data: data as Data, encoding: .utf8)!)
}
loadTask.resume()
}
2、 带进度条的下载方式
第一、 带进度的下载首先我们要添加一个代理 : URLSessionDownloadDelegate
第二、编写下载代码(这里需要有个注意的地方)
// TODO : 带进度的文件下载
func loadTaskProgress() -> Void {
/**
下载链接
*/
let loadUrl = URL.init(string: self.urlEncoding(str: "http://files.heweather.com/china-city-list.txt"))
/**
创建请求体
*/
var request = URLRequest.init(url: loadUrl!)
request .addValue("", forHTTPHeaderField: "Accept-Encoding")
/**
创建URLSession
*/
let NwSession = URLSession.init(configuration: .default, delegate: self, delegateQueue: nil)
/**
开始下载
*/
let dTask = NwSession.downloadTask(with: request)
dTask.resume()
}
注意的地方如下：
var request = URLRequest.init(url: loadUrl!)
request .addValue("", forHTTPHeaderField: "Accept-Encoding")'
这里需要这样书写，否则，在 URLSessionDownloadDelegate 的代理中** totalBytesExpectedToWrite** 会一直返回 -1。
第三、URLSessionDownloadDelegate 的代理事件
// MARK : URLSessionDownloadDelegate 的代理事件
// TODO : 下载结束调用的代理
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
print("下载结束")
print("下载地址" + location.path)
}
// TODO : 下载进度的监听
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
/**
写入字节
*/
print((CGFloat)(bytesWritten))
/**
已经下载的
*/
print((CGFloat)(totalBytesWritten))
/**
总共要下载数据的大小
*/
print((CGFloat)(totalBytesExpectedToWrite))
/**
下载进度的百分比
*/
print((CGFloat)(totalBytesWritten)/(CGFloat)(totalBytesExpectedToWrite))
print("----------")
}
七 、URLSession 的上传文件代码
// MARK : 文件上传
func sessionUploadTask() -> Void {
/**
创建上传网址
*/
var uploadStr = ""
uploadStr = self.urlEncoding(str: uploadStr)
let uploadUrl = URL.init(string: uploadStr)
/**
创建请求体
*/
let request = NSMutableURLRequest.init(url: uploadUrl!)
/**
设置请求的类型
*/
request.httpMethod = "POST"
/**
创建session的对象
*/
let NwSession = URLSession.shared
/**
发起上传，以数据流的形式，好处是不限制大小
*/
NwSession.uploadTask(with: request as URLRequest, from: try! Data.init(contentsOf: URL.init(fileURLWithPath: ""))) { (data, urlrequest, error) in
if error == nil {
print(String.init(data: data!, encoding: .utf8)!)
}
}
}
八、 URLSession 的POST 请求
// MARK : URLSession 的POST 请求
func urlSessionPost() -> Void {
/**
请求链接
*/
var linkStr = "https://m.maoyan.com/movie/list.json"
/**
网址编码
*/
linkStr = self.urlEncoding(str: linkStr)
/**
创建请求的URL
*/
let url = URL.init(string: linkStr)
/**
创建请求载体
*/
var request = URLRequest.init(url: url!)
/**
设置请求的类型
*/
request.httpMethod = "POST"
/**
请求参数
*/
let params = ["type":"hot","offset":0,"limit":2] as [String:Any]
/**
设置请求的Boby体
*/
request.httpBody = try! JSONSerialization.data(withJSONObject: params, options: .prettyPrinted)
/**
可以发起请求
*/
let postTask = URLSession.shared.dataTask(with: request) { ( data, response, error) in
if (data != nil) && error == nil {
}
/**
获取响应头
*/
let mutableResponse = response as! HTTPURLResponse
print(mutableResponse.allHeaderFields)
//[AnyHashable("Content-Type"): text/html;charset=ISO-8859-1, AnyHashable("Content-Length"): 1432, AnyHashable("allow"): GET, AnyHashable("Set-Cookie"): JSESSIONID=v8twzkxoyqvm3speg67sidfh;Path=/;Secure, AnyHashable("content-security-policy"): default-src *.meituan.com *.dianping.com *.qq.com *.gtimg.cn *.gtimg.com *.idqqimg.com *.idqqimg.cn *.tenpay.com *.qpic.cn jsbridge://* js://* 192.168.4.223:9999 cdn.bootcss.com *.maoyan.com *.sankuai.com *.meituan.net *.google-analytics.com wvjbscheme://* imeituan://* meituanmovie://* 'self' 'unsafe-inline' 'unsafe-eval' data:; report-uri http://csp.sankuai.com/reportURL/?bToken=4493e1bb;, AnyHashable("Server"): nginx, AnyHashable("Date"): Wed, 26 Jul 2017 03:40:02 GMT, AnyHashable("Cache-Control"): must-revalidate,no-cache,no-store]
}
/**
开始挂起
*/
postTask.resume()
}
九、URLSession 的一些属性
/**
获取URLSession的描述
*/
let sessionDescription = URLSession.shared.sessionDescription
print(sessionDescription!)
/**
等待 Task 完成后取消对相应的URLSession
*/
URLSession.shared.finishTasksAndInvalidate()
/**
无论正在进行什么任务都销毁对应的URLSession
*/
URLSession.shared.invalidateAndCancel()
/**
清空所有的Cookies,缓存和证书存储,删除磁盘文件,将正在进行的下载到磁盘,并确保未来发生在一个新的套接字的请求。
*/
URLSession.shared.reset {
print("one new URLSession")
}
/**
将Cookies和证书保存到磁盘,清除临时缓存,并确保未来发生在一个新的TCP连接请求。
*/
URLSession.shared.flush {
print("one new URLSession")
}
/*
注意： flush & reset 的异同。相同： 都是清楚当前的URLSession,确保下次创建一个新的Session。 不同： flush 再清除的缓存时，保留cookie和证书。而 reset 什么都不保留。
*/