当前位置: > > > Swift - 使用URLSession加载数据、下载、上传文件

Swift - 使用URLSession加载数据、下载、上传文件

URLSession 类支持三种类型的任务:加载数据、下载和上传。下面通过样例分别进行介绍。(本文代码已升级至 Swift3

1,使用Data Task加载数据
使用全局的 URLSession.shareddataTask 方法创建。
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
  • 8楼
    2017-08-19 15:18
    航哥的粉丝

    感谢航哥

    站长回复

    不客气。

  • 7楼
    2017-02-13 02:31
    sundin

    航哥你好, $receiveFile = $_SERVER["DOCUMENT_ROOT"]."/uploadFiles/hangge.png";
    怎样可以从swift 传送一个文件名的值到php,然后php怎么提取这个值,保存为特定的文件名?
    谢谢航哥

    站长回复

    我在文章末尾补充了相关内容,你可以看下。

  • 6楼
    2016-03-11 14:08
    飘仙人

    请问的currentSession()的错误 Use of unresolved identifier 'currentSession'是怎么回事?
    let session = currentSession() as NSURLSession

    站长回复

    currentSession()这方法你是不是没定义

  • 5楼
    2016-02-28 12:14
    wxd

    站长回复: 客户端这边request的HTTPMethod要设成"POST",我文章相关代码已修改,你可以看下。

    按照您的回复和最新的SWIFT程序,问题解决了。
    谢谢航哥!!!

    站长回复

    不客气,很高兴能帮上忙。

  • 4楼
    2016-02-28 12:09
    wxd

    按照您提供的服务器PHP代码,我测试是OK的,能够正确上传了。
    谢谢航哥!!!

    站长回复

    不客气,很高兴能帮上忙。

  • 3楼
    2016-02-28 10:52
    wxd

    你好:
    关于使用Upload Task来上传文件,能否提供一下服务器端接收文件的PHP程序。
    谢谢!

    站长回复

    已附上服务端代码。

  • 2楼
    2016-02-27 16:36
    wxd

    使用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楼
    2016-02-24 16:20

    航哥,上面的例子是上传到网页吧?如果是上传到某个特定的服务器呢?或者后台上传呢?

    站长回复

    (1)把文件上传到服务器上,最方便的就是服务器架设个Web服务,通过HTTP上传后保存到服务器(也就是本文样例)
    (2)还可以在服务器上开启FTP服务,通过ftp上传(http://www.hangge.com/blog/cache/detail_990.html)
    (3)或者通过Socket同服务器传输文件(这个最麻烦,我目前还没写相关样例,你可以上网找下)