您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

自己動手寫一個 iOS 網絡請求庫(四)——快速文件上傳

編輯:iOS 開發基礎

自己動手寫一個 iOS 網絡請求庫(一)—— NSURLSession 初探

自己動手寫一個 iOS 網絡請求庫(二)——封裝接口

自己動手寫一個 iOS 網絡請求庫(三)——降低耦合

程式碼範例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary

開源專案:Pitaya,適合大檔案上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya

這是系列文章的最終篇,我們要一起為自己的網絡請求庫加上「快速檔案上傳」的能力。

HTTP 協議解析

找資料

我翻出了以前買的《圖解 HTTP》:

翻到第 46-47 頁,「發送多種數據的多部分對象集合」:

multipart/form-data

// HTTP 頭 開始
Content-Type: multipart/form-data; boundary=PitayaUGl0YXlh
// HTTP 頭 結束

// HTTP Body 開始
--PitayaUGl0YXlh
Content-Disposition: form-data; name="field1"

John Lui
--PitayaUGl0YXlh
Content-Disposition: form-data; name="text"; filename="file1.txt"

···[file1.txt 的數據]···
--PitayaUGl0YXlh--
// HTTP Body 結束

詳解

HTTP 協議本質上就是一套非常基礎的「字串格式化約定」,傳輸的內容依然是一堆字元,只是因為大家遵守了標準協議,後端的 HTTP 服務軟體(Apache、nginx)與前端的瀏覽器、NSData、NSURLSession 等接口才能順暢地溝通。

在 HTTP 協議中,上傳檔案的設定方式如下。

先設定 Content-Type 標頭欄位:

Content-Type: multipart/form-data; boundary=PitayaUGl0YXlh

其中 boundary 是我們自己指定的分隔符。

然後設定 HTTP Body:

  --PitayaUGl0YXlh
Content-Disposition: form-data; name="field1"

John Lui
--PitayaUGl0YXlh
Content-Disposition: form-data; name="text"; filename="file1.txt"

···[file1.txt 的數據]···
--PitayaUGl0YXlh--

每個欄位以「--分隔符」開頭,整體最後以「--分隔符--」作結。

換行

HTTP 協議中,換行必須使用 \r\n。我試過只用 \n,系統會原封不動地把這個換行送出去;如果後端的 HTTP 伺服器不支援這種容錯,就可能出問題。所以大家還是乖乖遵守標準協議吧。

程式碼實作

建立 File 結構體

上傳檔案也是表單的一部分,同樣需要一個 name,所以我們要設計一個 File 結構體來描述要上傳的檔案:

struct File {
    let name: String!
    let url: NSURL!
    
    init(name: String, url: NSURL) {
        self.name = name
        self.url = url
    }
}

這裡我們用 NSURL 來描述檔案位置。

新增 files 類成員變數並初始化

class NetworkManager {
    
    let method: String!
    let params: Dictionary
    let callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void
    
    // add files
    var files: Array
    
    let session = NSURLSession.sharedSession()
    let url: String!
    var request: NSMutableURLRequest!
    var task: NSURLSessionTask!
    
    // add files
    init(url: String, method: String, params: Dictionary = Dictionary(), files: Array = Array(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
        self.url = url
        self.request = NSMutableURLRequest(URL: NSURL(string: url)!)
        self.method = method
        self.params = params
        self.callback = callback
        
        // add files
        self.files = files
    }
    
    ......
}

新增 boundary 類成員常量

class NetworkManager {
    let boundary = "PitayaUGl0YXlh"
    
    ......
}

修改 Content-Type

if self.files.count > 0 {
    request.addValue("multipart/form-data; boundary=" + self.boundary, forHTTPHeaderField: "Content-Type")
} else if self.params.count > 0 {
    request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
}

改寫 buildBody 函數

func buildBody() {
    let data = NSMutableData()
    if self.files.count > 0 {
        if self.method == "GET" {
            NSLog("\n\n------------------------\nThe remote server may not accept GET method with HTTP body. But Pitaya will send it anyway.\n------------------------\n\n")
        }
        for (key, value) in self.params {
            data.appendData("--\(self.boundary)\r\n".nsdata)
            data.appendData("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n".nsdata)
            data.appendData("\(value.description)\r\n".nsdata)
        }
        for file in self.files {
            data.appendData("--\(self.boundary)\r\n".nsdata)
            data.appendData("Content-Disposition: form-data; name=\"\(file.name)\"; filename=\"\(file.url.description.lastPathComponent)\"\r\n\r\n".nsdata)
            if let a = NSData(contentsOfURL: file.url) {
                data.appendData(a)
                data.appendData("\r\n".nsdata)
            }
        }
        data.appendData("--\(self.boundary)--\r\n".nsdata)
    } else if self.params.count > 0 && self.method != "GET" {
        data.appendData(buildParams(self.params).nsdata)
    }
    request.HTTPBody = data
}

.nsdata 是我替 String 做的擴充屬性,程式碼在:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary/BuildYourHTTPRequestLibrary/Network.swift#L46-L50

調整 Network.request 接口群,加上上傳檔案的 API

static func request(method: String, url: String, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let manager = NetworkManager(url: url, method: method, callback: callback)
    manager.fire()
}
static func request(method: String, url: String, params: Dictionary, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let manager = NetworkManager(url: url, method: method, params: params, callback: callback)
    manager.fire()
}
static func request(method: String, url: String, files: Array, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let manager = NetworkManager(url: url, method: method, files: files, callback: callback)
    manager.fire()
}
static func request(method: String, url: String, params: Dictionary, files: Array, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let manager = NetworkManager(url: url, method: method, params: params, files: files, callback: callback)
    manager.fire()
}

檢驗成果

先準備一張圖片來做上傳測試:

測試程式碼如下:

let file = File(name: "file", url: NSURL(fileURLWithPath: NSBundle.mainBundle().pathForResource("Pitaya", ofType: "png")!)!)

Network.request("POST", url: "https://pitayaswift.sinaapp.com/pitaya.php", files: [file]) {(data, response, error) -> Void in
    let string = NSString(data: data, encoding: NSUTF8StringEncoding) as! String
    if string == "1" {
        println("上傳檔案成功!")
    }
}

https://pitayaswift.sinaapp.com/pitaya.php 會在收到 name="file" 的檔案之後輸出 1。

執行專案、點擊按鈕、看到輸出——成功!

快在哪裡?

Alamofire 並不支援表單檔案上傳(似乎只支援串流上傳,不確定)。所以我先前使用 Alamofire 時,是先把二進位檔案讀出來做 base64 編碼,再當成字串欄位傳輸。除了資料體積會膨脹三分之一之外,最嚴重的問題在於極長的 HTTP 準備時間(開始送出封包之前的處理時間),而這段時間是阻塞的。實測結果,不論是 A5 處理器的 touch5 還是 A8 處理器的 iPhone6,一個 500KB 的語音檔都需要將近 30 秒的預處理時間。阻塞問題可以用超執行緒解決,但整體上傳時間依然很長——500KB 語音檔的預處理時間與網路傳輸時間幾乎一樣長。

那快在哪裡?改用 NSData 直接賦值給 HTTP Body 之後,這種方式完全不消耗預處理時間,自然也不會阻塞主執行緒。而且傳輸的字串長度還少了 25%。實測 500KB 語音檔的上傳時間從 57 秒縮短到 21 秒,提速相當可觀。

《自己動手寫一個 iOS 網絡請求庫》系列文章到此結束,謝謝大家!

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