SwiftHTTP 是一個以 Swift 撰寫、底層基於 NSURLSession 並加以封裝的網路庫。它讓取得資料、送出資料、上傳與下載檔案等常見操作變得更簡潔直觀,定位上與另一個知名庫 Alamofire 頗為相似。本文帶你從安裝配置一路走到實際的資料請求。
它有哪些特性?
(1)便利的閉包 API;(2)支援運行隊列(NSOperationQueue);(3)支援參數編碼;(4)內建 JSON 請求序列化;(5)上傳/下載檔案時可取得進度;(6)整體程式碼簡潔易讀。
如何安裝?
(1)從 GitHub 下載最新程式碼:https://github.com/daltoniam/SwiftHTTP
(2)將解壓後的 SwiftHTTP.xcodeproj 拖曳進你的專案。

(3)在「專案 → General → Embedded Binaries」中加入 SwiftHTTP.framework。

(4)在需要的地方 import 即可:
import SwiftHTTP
1. GET 請求——不帶參數
do {
let opt = try HTTP.GET("https://111cn.net")
opt.start { response in
if let err = response.error {
print("error: \(err.localizedDescription)")
return
}
print("獲取到資料: \(response.description)")
}
} catch let error {
print("請求失敗: \(error)")
}
GET 請求——帶參數,參數會自動拼接成查詢字串:
do {
// 實際的 url 是: https://111cn.net?hello=world¶m2=1
let opt = try HTTP.GET("https://111cn.net", parameters: ["hello": "world", "param2": 1])
opt.start { response in
if let err = response.error {
print("error: \(err.localizedDescription)")
return
}
print("獲取到資料: \(response.description)")
}
} catch let error {
print("請求失敗: \(error)")
}
2. POST 請求,參數可以是包含陣列與字典的巢狀結構:
let params = ["param": "param1",
"array": ["first array element", "second", "third"],
"num": 23,
"dict": ["someKey": "someVal"]]
do {
let opt = try HTTP.POST("https://www.111cn.net", parameters: params)
opt.start { response in
// 進行具體的響應操作...
}
} catch let error {
print("請求失敗: \(error)")
}
3. 自訂 HTTP 標頭:
do {
let opt = try HTTP.GET("https://www.111cn.net", parameters: ["hello": "there"],
headers: ["header": "value"])
opt.start { response in
// 進行具體的響應操作...
}
} catch let error {
print("請求失敗: \(error)")
}
SwiftHTTP 同樣支援運行隊列。把多個請求放進 queue,就會自動以多執行緒異步執行;透過 maxConcurrentOperationCount 還能限制同時進行的請求數量。
let operationQueue = NSOperationQueue()
operationQueue.maxConcurrentOperationCount = 2 // 最大併發任務數
do {
let opt1 = try HTTP.New("https://www.111cn.net", method: .GET)
opt1.onFinish = { response in /* 處理響應... */ }
operationQueue.addOperation(opt1)
let opt2 = try HTTP.New("https://www.baidu.com", method: .GET)
opt2.onFinish = { response in /* 處理響應... */ }
operationQueue.addOperation(opt2)
let opt3 = try HTTP.New("https://www.111cn.net", method: .GET)
opt3.onFinish = { response in /* 處理響應... */ }
operationQueue.addOperation(opt3)
} catch let error {
print("請求失敗: \(error)")
}
需要取消任務時,可以用 cancel() 停止單一請求:
opt2.cancel() // 取消這個請求任務
也可以一次取消全部:
operationQueue.cancelAllOperations() // 取消所有操作
整體而言,SwiftHTTP 用極簡的 API 換取了很高的開發效率,無論是單發請求還是批次併發,都能以清爽的寫法完成,是 Swift 網路層不錯的選擇之一。