自己動手寫一個 iOS 網絡請求庫——降低耦合
開源項目: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 封裝成功!