您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 7 技巧

Alamofire 詳解(二):四種檔案上傳方式與進度回報實戰

編輯:iOS 7 技巧

上一篇談完了資料請求,這篇把焦點轉到上傳。Alamofire 把上傳這件事抽象得很漂亮,無論你手上是一個檔案、一段 Data、串流,還是要模擬網頁表單的多檔送出,都有對應的方法。

一、支援的上傳型別

File(檔案網址)、Data(記憶體資料)、Stream(串流)、MultipartFormData(多段表單資料),四種涵蓋了日常所有情境。

二、以檔案流的形式上傳

最簡單的一種,直接把本機檔案的 URL 丟給它:

let fileURL = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")

Alamofire.upload(.POST, "https://www.hangge.com/upload.php", file: fileURL!)

對應的 PHP 接收端要從原始輸入流讀取內容,因為這種上傳方式並非標準的 multipart 表單:

<?php
/**
 * 接收串流檔案
 * @param  String $receiveFile 接收後要保存的檔名
 * @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.zip";
$ret = receiveStreamFile($receiveFile);
echo json_encode(array('success' => (bool)$ret));
?>

三、附帶上傳進度

大檔案上傳沒有進度條,使用者只會以為 App 當機了。加上 .progress 就能持續取得已送出的位元組數。要注意的是,這個 closure 為了效能考量不會在主執行緒呼叫,更新 UI 前必須自己 dispatch 回主 queue。

let fileURL = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")

Alamofire.upload(.POST, "https://www.hangge.com/upload.php", file: fileURL!)
    .progress { bytesWritten, totalBytesWritten, totalBytesExpectedToWrite in
        print(totalBytesWritten)

        // 此 closure 不在主 queue,更新 UI 請切回去
        dispatch_async(dispatch_get_main_queue()) {
            print("Total bytes written on main queue: \(totalBytesWritten)")
        }
    }
    .responseJSON { response in
        debugPrint(response)
    }

執行後主控台會不斷印出已上傳的資料量,正好可以拿來驅動進度條。

四、上傳 MultipartFormData(等同網頁表單提交)

這是最接近傳統 <form enctype="multipart/form-data"> 的做法,可以一次送出多個檔案,也能同時夾帶一般文字欄位。

let fileURL1 = NSBundle.mainBundle().URLForResource("hangge", withExtension: "png")
let fileURL2 = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")

Alamofire.upload(
    .POST,
    "https://www.hangge.com/upload2.php",
    multipartFormData: { multipartFormData in
        multipartFormData.appendBodyPart(fileURL: fileURL1!, name: "file1")
        multipartFormData.appendBodyPart(fileURL: fileURL2!, name: "file2")
    },
    encodingCompletion: { encodingResult in
        switch encodingResult {
        case .Success(let upload, _, _):
            upload.responseJSON { response in
                debugPrint(response)
            }
        case .Failure(let encodingError):
            print(encodingError)
        }
    }
)

伺服器端就單純多了,用標準的 $_FILES 接收即可:

<?php
move_uploaded_file($_FILES["file1"]["tmp_name"],
    $_SERVER["DOCUMENT_ROOT"] . "/uploadFiles/" . $_FILES["file1"]["name"]);

move_uploaded_file($_FILES["file2"]["tmp_name"],
    $_SERVER["DOCUMENT_ROOT"] . "/uploadFiles/" . $_FILES["file2"]["name"]);
?>

選哪一種?

如果後端是你自己能掌控的,串流方式最省事;若要相容既有的 PHP/Java 表單介面,就用 MultipartFormData。另外提醒,encodingCompletion 中的 .Success 取得 upload 物件後才能串 .progress 與 .responseJSON,這點和單檔上傳的鏈式寫法略有不同,是初學時最容易卡住的地方。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved