系列前文:自己動手寫一個 iOS 網絡請求庫(一)NSURLSession 初探。
代碼示例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary
開源項目:Pitaya,適合大文件上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya
這一篇的目標:用一個類把之前的代碼封裝起來,加入動態傳參(params)的能力,最終收斂成一個強大的調用接口。

新建 Swift 文件 Network.swift,寫一個 Network 類和一個靜態方法 request():
class Network {
static func request() {
let session = NSURLSession.sharedSession()
let request = NSURLRequest(URL: NSURL(string: "https://baidu.com")!)
let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
println("just wait for 5 seconds!")
sleep(5)
let string = NSString(data: data, encoding: NSUTF8StringEncoding)
println(string)
})
task.resume()
}
}ViewController 中的按鈕方法相應改為:
@IBAction func mainButtonBeTapped(sender: AnyObject) {
Network.request()
}運行、點擊按鈕,效果與之前一致。
static func request(method: String, url: String) {
let session = NSURLSession.sharedSession()
let request = NSMutableURLRequest(URL: NSURL(string: url)!)
request.HTTPMethod = method
let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
println("just wait for 5 seconds!")
sleep(5)
let string = NSString(data: data, encoding: NSUTF8StringEncoding)
println(string)
})
task.resume()
}調用處改為:
@IBAction func mainButtonBeTapped(sender: AnyObject) {
Network.request("GET", url: "https://baidu.com")
}函數在 Swift 中是一等公民,閉包既能作參數也能作返回值。把一個回調閉包傳進 request():
static func request(method: String, url: String, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let session = NSURLSession.sharedSession()
let request = NSMutableURLRequest(URL: NSURL(string: url)!)
request.HTTPMethod = method
let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
callback(data: data, response: response, error: error)
})
task.resume()
}調用處傳入閉包:
@IBAction func mainButtonBeTapped(sender: AnyObject) {
Network.request("GET", url: "https://baidu.com") {(data, response, error) -> Void in
println("just wait for 5 seconds!")
sleep(5)
let string = NSString(data: data, encoding: NSUTF8StringEncoding)
println(string)
}
}GET 方法
GET 下,params 經過 url encode 之後直接附加在 URL 末尾。給 request() 加上一個参數字典:
static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
...
}params 的處理函數直接從 Alamofire 借來。完整代碼:
class Network {
static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let session = NSURLSession.sharedSession()
var newURL = url
if method == "GET" {
newURL += "?" + Network().buildParams(params)
}
let request = NSMutableURLRequest(URL: NSURL(string: newURL)!)
request.HTTPMethod = method
let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
callback(data: data, response: response, error: error)
})
task.resume()
}
// 從 Alamofire 借來的三個函數
func buildParams(parameters: [String: AnyObject]) -> String {
var components: [(String, String)] = []
for key in sorted(Array(parameters.keys), <) {
let value: AnyObject? = parameters[key]
components += queryComponents(key, value)
}
return join("&", components.map({"\($0.0)=\($0.1)"}))
}
func queryComponents(key: String, _ value: AnyObject?) -> [(String, String)] {
var components: [(String, String)] = []
if let dictionary = value as? [String: AnyObject] {
for (nestedKey, value) in dictionary {
components += queryComponents("\(key)[\(nestedKey)]", value)
}
} else if let array = value as? [AnyObject] {
for value in array {
components += queryComponents("\(key)", value)
}
} else {
components.extend([(escape(key), escape("\(value)"))])
}
return components
}
func escape(string: String) -> String {
let legalURLCharactersToBeEscaped: CFStringRef = ":&=;+!@#$()',*"
return CFURLCreateStringByAddingPercentEscapes(nil, string, nil, legalURLCharactersToBeEscaped, CFStringBuiltInEncodings.UTF8.rawValue) as String
}
}調用處:
@IBAction func mainButtonBeTapped(sender: AnyObject) {
Network.request("GET", url: "https://pitayaswift.sinaapp.com/pitaya.php", params: ["get": "Network"]) {(data, response, error) -> Void in
let string = NSString(data: data, encoding: NSUTF8StringEncoding)
println(string)
}
}這個測試服務端會直接返回 ?get=ooxx 中的 ooxx。

POST 方法
POST 有多種協議可選,這裡沒有文件上傳需求,採用最簡單的 application/x-www-form-urlencoded。request() 再補一段:
static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let session = NSURLSession.sharedSession()
var newURL = url
if method == "GET" {
newURL += "?" + Network().buildParams(params)
}
let request = NSMutableURLRequest(URL: NSURL(string: newURL)!)
request.HTTPMethod = method
if method == "POST" {
request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
request.HTTPBody = Network().buildParams(params).dataUsingEncoding(NSUTF8StringEncoding)
}
let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
callback(data: data, response: response, error: error)
})
task.resume()
}調用處:
@IBAction func mainButtonBeTapped(sender: AnyObject) {
Network.request("POST", url: "https://pitayaswift.sinaapp.com/pitaya.php", params: ["post": "Network"]) {(data, response, error) -> Void in
let string = NSString(data: data, encoding: NSUTF8StringEncoding)
println(string)
}
}服務端會返回 key 為 post 的 value,結果與 GET 一致。至此,接口封裝完成。
下一篇:自己動手寫一個 iOS 網絡請求庫(三)降低耦合。