系列前文:自己動手寫一個 iOS 網絡請求庫(一)NSURLSession 初探;(二)封裝接口。
代碼示例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary
開源項目:Pitaya,適合大文件上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya
這一篇要做的兩件事:把代碼的耦合度降下來,再用適配器模式封裝出一層獨立於底層實現的網絡 API,讓它真正像一個「庫」。
目前清湯掛面式的代碼好讀,但功能單一、結構凌亂。回顧一下 NSURLSession 的使用流程:
把這些步驟拆開、各自封裝,就是降低耦合的第一步。
在 Network 下新建 NetworkManager 類,把 URL、params 等作為成員變量在構造函數中初始化:
class NetworkManager {
let method: String!
let params: Dictionary
let callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void
let session = NSURLSession.sharedSession()
let url: String!
var request: NSMutableURLRequest!
var task: NSURLSessionTask!
init(url: String, method: String, params: Dictionary = Dictionary(), 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
}
}接著把「確定 URL/方法/HTTP 頭」封裝成一個函數,「填充 Body」封裝成一個函數,「驅動 dataTask」再封裝成一個函數:
func buildRequest() {
if self.method == "GET" && self.params.count > 0 {
self.request = NSMutableURLRequest(URL: NSURL(string: url + "?" + buildParams(self.params))!)
}
request.HTTPMethod = self.method
if self.params.count > 0 {
request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
}
}
func buildBody() {
if self.params.count > 0 && self.method != "GET" {
request.HTTPBody = buildParams(self.params).nsdata
}
}
func fireTask() {
task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
self.callback(data: data, response: response, error: error)
})
task.resume()
}再提供一個統一入口把三步串起來:
func fire() {
buildRequest()
buildBody()
fireTask()
}順手把之前從 Alamofire 借來的三個 params 解析函數也搬進這個類。至此,重構基本完成。
適配器模式是設計模式中最容易理解的一種:我的 App 需要「拿到某個 URL 返回的字符串」這個能力,目前底層用的是 Alamofire,但 Pitaya 看起來更有前途,以後想換。於是我在自己這層封裝一層網絡接口,把底層細節屏蔽掉,換實現時只需要改這個類,不必回頭改散落在項目各處的調用。
聽起來高大上,其實這是我們日常編碼中天天在用的模式。
class Network {
static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let manager = NetworkManager(url: url, method: method, params: params, callback: callback)
manager.fire()
}
}不帶 params 的版本:
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()
}兩個 get 接口:
static func get(url: String, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let manager = NetworkManager(url: url, method: "GET", callback: callback)
manager.fire()
}
static func get(url: String, params: Dictionary, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let manager = NetworkManager(url: url, method: "GET", params: params, callback: callback)
manager.fire()
}兩個 post 接口:
static func post(url: String, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let manager = NetworkManager(url: url, method: "POST", callback: callback)
manager.fire()
}
static func post(url: String, params: Dictionary, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
let manager = NetworkManager(url: url, method: "POST", params: params, callback: callback)
manager.fire()
}@IBAction func mainButtonBeTapped(sender: AnyObject) {
let url = "https://pitayaswift.sinaapp.com/pitaya.php"
Network.post(url, callback: {(data, response, error) -> Void in
println("POST 1 請求成功")
})
Network.post(url, params: ["post": "POST Network"], callback: {(data, response, error) -> Void in
let string = NSString(data: data, encoding: NSUTF8StringEncoding) as! String
println("POST 2 請求成功 " + string)
})
Network.get(url, callback: {(data, response, error) -> Void in
println("GET 1 請求成功")
})
Network.get(url, params: ["get": "GET Network"], callback: {(data, response, error) -> Void in
let string = NSString(data: data, encoding: NSUTF8StringEncoding) as! String
println("GET 2 請求成功 " + string)
})
Network.request("GET", url: url, params: ["get": "Request Network"]) {(data, response, error) -> Void in
let string = NSString(data: data, encoding: NSUTF8StringEncoding) as! String
println("Request 請求成功 " + string)
}
}運行項目、點擊按鈕查看結果。

多級 API 封裝成功。