Swift - 使用URLSession加载数据、下载、上传文件
作者:hangge | 2015-07-02 15:38
URLSession 类支持三种类型的任务:加载数据、下载和上传。下面通过样例分别进行介绍。(本文代码已升级至 Swift3)

2,使用Download Task来下载文件
(2)实时获取进度
需要使用自定义的 URLSession 对象和 downloadTask 方法

3,使用Upload Task来上传文件
1,使用Data Task加载数据
使用全局的 URLSession.shared 和 dataTask 方法创建。
func sessionLoadData(){
//创建URL对象
let urlString = "http://hangge.com"
let url = URL(string:urlString)
//创建请求对象
let request = URLRequest(url: url!)
let session = URLSession.shared
let dataTask = session.dataTask(with: request,
completionHandler: {(data, response, error) -> Void in
if error != nil{
print(error.debugDescription)
}else{
let str = String(data: data!, encoding: String.Encoding.utf8)
print(str)
}
}) as URLSessionTask
//使用resume方法启动任务
dataTask.resume()
}
运行结果如下:

2,使用Download Task来下载文件
(1)不需要获取进度
使用全局的 URLSession.shared 和 downloadTask 方法即可
func sessionSimpleDownload(){
//下载地址
let url = URL(string: "http://hangge.com/blog/images/logo.png")
//请求
let request = URLRequest(url: url!)
let session = URLSession.shared
//下载任务
let downloadTask = session.downloadTask(with: request,
completionHandler: { (location:URL?, response:URLResponse?, error:Error?)
-> Void in
//输出下载文件原来的存放目录
print("location:\(location)")
//location位置转换
let locationPath = location!.path
//拷贝到用户目录
let documnets:String = NSHomeDirectory() + "/Documents/1.png"
//创建文件管理器
let fileManager = FileManager.default
try! fileManager.moveItem(atPath: locationPath, toPath: documnets)
print("new location:\(documnets)")
})
//使用resume方法启动任务
downloadTask.resume()
}
运行结果如下: 
(2)实时获取进度
需要使用自定义的 URLSession 对象和 downloadTask 方法
import UIKit
class ViewController: UIViewController, URLSessionDownloadDelegate {
private lazy var session:URLSession = {
//只执行一次
let config = URLSessionConfiguration.default
let currentSession = URLSession(configuration: config, delegate: self,
delegateQueue: nil)
return currentSession
}()
override func viewDidLoad() {
super.viewDidLoad()
sessionSeniorDownload()
}
//下载文件
func sessionSeniorDownload(){
//下载地址
let url = URL(string: "http://hangge.com/blog/images/logo.png")
//请求
let request = URLRequest(url: url!)
//下载任务
let downloadTask = session.downloadTask(with: request)
//使用resume方法启动任务
downloadTask.resume()
}
//下载代理方法,下载结束
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask,
didFinishDownloadingTo location: URL) {
//下载结束
print("下载结束")
//输出下载文件原来的存放目录
print("location:\(location)")
//location位置转换
let locationPath = location.path
//拷贝到用户目录
let documnets:String = NSHomeDirectory() + "/Documents/2.png"
//创建文件管理器
let fileManager = FileManager.default
try! fileManager.moveItem(atPath: locationPath, toPath: documnets)
print("new location:\(documnets)")
}
//下载代理方法,监听下载进度
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask,
didWriteData bytesWritten: Int64, totalBytesWritten: Int64,
totalBytesExpectedToWrite: Int64) {
//获取进度
let written:CGFloat = (CGFloat)(totalBytesWritten)
let total:CGFloat = (CGFloat)(totalBytesExpectedToWrite)
let pro:CGFloat = written/total
print("下载进度:\(pro)")
}
//下载代理方法,下载偏移
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask,
didResumeAtOffset fileOffset: Int64, expectedTotalBytes: Int64) {
//下载偏移,主要用于暂停续传
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
运行结果如下:
3,使用Upload Task来上传文件
func sessionUpload(){
//上传地址
let url = URL(string: "http://hangge.com/upload.php")
//请求
var request = URLRequest(url: url!, cachePolicy: .reloadIgnoringCacheData)
request.httpMethod = "POST"
let session = URLSession.shared
//上传数据流
let documents = NSHomeDirectory() + "/Documents/1.png"
let imgData = try! Data(contentsOf: URL(fileURLWithPath: documents))
let uploadTask = session.uploadTask(with: request, from: imgData) {
(data:Data?, response:URLResponse?, error:Error?) -> Void in
//上传完毕后
if error != nil{
print(error)
}else{
let str = String(data: data!, encoding: String.Encoding.utf8)
print("上传完毕:\(str)")
}
}
//使用resume方法启动任务
uploadTask.resume()
}
附:服务端代码(upload.php)
<?php
/** php 接收流文件
* @param String $file 接收后保存的文件名
* @return boolean
*/
function receiveStreamFile($receiveFile){
$streamData = isset($GLOBALS['HTTP_RAW_POST_DATA'])? $GLOBALS['HTTP_RAW_POST_DATA'] : '';
if(empty($streamData)){
$streamData = file_get_contents('php://input');
}
if($streamData!=''){
$ret = file_put_contents($receiveFile, $streamData, true);
}else{
$ret = false;
}
return $ret;
}
//定义服务器存储路径和文件名
$receiveFile = $_SERVER["DOCUMENT_ROOT"]."/uploadFiles/hangge.png";
$ret = receiveStreamFile($receiveFile);
echo json_encode(array('success'=>(bool)$ret));
?>
如何在上传时附带上文件名?
有时我们在文件上传的同时还会想要附带一些其它参数,比如文件名。这样服务端接收到文件后,就可以根据我们传过来的文件名来保存。实现这个其实很简单,客户端和服务端分别做如下修改。
有时我们在文件上传的同时还会想要附带一些其它参数,比如文件名。这样服务端接收到文件后,就可以根据我们传过来的文件名来保存。实现这个其实很简单,客户端和服务端分别做如下修改。
- 客户端:将文件名以参数的形式跟在链接后面。比如:http://hangge.com/upload.php?fileName=image1.png
- 服务端:通过 $_GET["fileName"] 得到这个参数,并用其作为文件名保存。
全部评论(8)
感谢航哥
站长回复:不客气。
航哥你好, $receiveFile = $_SERVER["DOCUMENT_ROOT"]."/uploadFiles/hangge.png";
怎样可以从swift 传送一个文件名的值到php,然后php怎么提取这个值,保存为特定的文件名?
谢谢航哥
站长回复:我在文章末尾补充了相关内容,你可以看下。
请问的currentSession()的错误 Use of unresolved identifier 'currentSession'是怎么回事?
let session = currentSession() as NSURLSession
站长回复:currentSession()这方法你是不是没定义
站长回复: 客户端这边request的HTTPMethod要设成"POST",我文章相关代码已修改,你可以看下。
按照您的回复和最新的SWIFT程序,问题解决了。
谢谢航哥!!!
站长回复:不客气,很高兴能帮上忙。
按照您提供的服务器PHP代码,我测试是OK的,能够正确上传了。
谢谢航哥!!!
站长回复:不客气,很高兴能帮上忙。
你好:
关于使用Upload Task来上传文件,能否提供一下服务器端接收文件的PHP程序。
谢谢!
站长回复:已附上服务端代码。
使用Upload Task来上传文件时,如果打印错误信息:
let uptask = session.uploadTaskWithRequest(req, fromData: data) {
(data1, response, error) -> Void in
if error != nil {
print(error?.code)
print(error?.description)
} else {
print(data1)
print("upload OK")
}
调试时,出现如下报错:
Optional(-1017)
Optional("Error Domain=NSURLErrorDomain Code=-1017 \"cannot parse response\" UserInfo={NSUnderlyingError=0x7f849b80b3d0 {Error Domain=kCFErrorDomainCFNetwork Code=-1017 \"(null)\" UserInfo={_kCFStreamErrorCodeKey=-1, _kCFStreamErrorDomainKey=4}}, NSErrorFailingURLStringKey=http://192.168.1.106/test/ios_1/upload2.php, NSErrorFailingURLKey=http://192.168.1.106/test/ios_1/upload2.php, _kCFStreamErrorDomainKey=4, _kCFStreamErrorCodeKey=-1, NSLocalizedDescription=cannot parse response}")
服务器的php代码:
function receiveStreamFile($receiveFile){
$streamData = isset($GLOBALS['HTTP_RAW_POST_DATA'])? $GLOBALS['HTTP_RAW_POST_DATA'] : '';
if(empty($streamData)){
$streamData = file_get_contents('php://input');
}
if($streamData!=''){
$ret = file_put_contents($receiveFile, $streamData, true);
}else{
$ret = false;
}
return $ret;
}
//定义服务器存储路径和文件名
$receiveFile = "dog.jpg";
$ret = receiveStreamFile($receiveFile);
echo json_encode(array('success'=>(bool)$ret));
航哥,麻烦抽空帮忙看看是哪里有bug?
还有服务器上,如果采用如下通用的表单上传时:
$srcfile=$_FILES["file"][tmp_name];
$dstfile="uploads/".$_FILES["file"][name];
move_uploaded_file($srcfile, $dstfile);
.$_FILES数组的"file",应该写什么呢?
谢谢!!!
站长回复:客户端这边request的HTTPMethod要设成"POST",我文章相关代码已修改,你可以看下。
航哥,上面的例子是上传到网页吧?如果是上传到某个特定的服务器呢?或者后台上传呢?
站长回复:(1)把文件上传到服务器上,最方便的就是服务器架设个Web服务,通过HTTP上传后保存到服务器(也就是本文样例)
(2)还可以在服务器上开启FTP服务,通过ftp上传(http://www.hangge.com/blog/cache/detail_990.html)
(3)或者通过Socket同服务器传输文件(这个最麻烦,我目前还没写相关样例,你可以上网找下)