之前篇目:自己動手寫一個 iOS 網絡請求庫(一)—— NSURLSession 初探
之前篇目:自己動手寫一個 iOS 網絡請求庫(二)——封裝接口
代碼示例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary
開源項目:Pitaya,適合大文件上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya
本文中,我們將一起降低之前代碼的耦合度,並使用適配器模式實現一層獨立於底層結構的網絡 API,造一個真正的網絡請求“庫”。
降低耦合度
如何降低耦合度
現在的清湯掛面式的代碼雖然便於理解,但是功能單一,代碼雜亂。我們一起來分析 NSURLSession 的使用過程:
構造 NSURLRequest
確定 URL
確定 HTTP 方法(GET、POST 等)
添加特定的 HTTP 頭
填充 HTTP Body
驅動 session.dataTaskWithRequest 方法,開始請求
具體實施
在 Network 下另外新建一個 NetworkManager 類,將 URL、params、files 等設為成員變量,讓他們在構造函數中初始化:
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 } }
之後,將上面分析的
1. 確定 URL
2. 確定 HTTP 方法(GET、POST 等)
3. 添加特定的 HTTP 頭
4. 填充 HTTP Body
前三步封裝到一個 function 中,最後一步封裝到一個 function 中,然後把驅動 session.dataTaskWithRequest 的代碼封裝到一個 function 中:
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() }
之後使用一個統一的方法來驅動上面三個 function,完成請求:
func fire() { buildRequest() buildBody() fireTask() }
同時,不要忘了那三個 parse params 的從 Alamofire 偷來的函數哦,也要放到這個類裡面。至此,降低耦合的工作基本完成,接下來我們開始封裝“網絡API”。
使用適配器模式封裝“網絡API”
理解適配器模式
適配器模式是設計模式中的一種,很容易理解:我的 APP 需要一個獲取某一個 URL 返回的字符串的功能,我現在選擇的是 Alamofire,但是正在發展的 Pitaya 看起來不錯,我以後想替換成 Pitaya,所以我封裝了一層我自己的網絡接口,用來屏蔽底層細節,到時候只需要修改這個類,不需要再深入項目中改那麼多接口調用了。
適配器模式聽起來高大上,其實這是我們在日常編碼中非常常用的設計模式。
Do it!
修改 Network 類的代碼為:
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 接口(帶與不帶 params):
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 接口(帶與不帶 params):
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() }
測試接口
修改 ViewController 中的調用代碼,測試多級 API:
@IBAction func mainButtonBeTapped(sender: AnyObject) { let url = "http://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": "POST 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 封裝成功!