
自己動手寫一個 iOS 網絡請求庫(一)—— NSURLSession 初探
自己動手寫一個 iOS 網絡請求庫(二)——封裝接口
自己動手寫一個 iOS 網絡請求庫(三)——降低耦合
程式碼範例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary
開源專案:Pitaya,適合大檔案上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya
這是系列文章的最終篇,我們要一起為自己的網絡請求庫加上「快速檔案上傳」的能力。
找資料
我翻出了以前買的《圖解 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 網絡請求庫》系列文章到此結束,謝謝大家!