本文由CocoaChina--BYB_1132(論壇ID)翻譯 原文:Thoughts On AlamoFire--Swift’s AFNetworking Implementation HTTP協議就是現代開發的同義詞,對於有經驗的iOS開發者來說, 熟悉並儘可能使用這些流行的協議是日常工作的基礎
本文由CocoaChina--BYB_1132(論壇ID)翻譯
原文:Thoughts On AlamoFire--Swift’s AFNetworking Implementation
HTTP協議就是現代開發的同義詞,對於有經驗的iOS開發者來說, 熟悉並儘可能使用這些流行的協議是日常工作的基礎。
不出意料,iOS 應用在這一點上沒有什麼不同,成千上萬的app和工程師都依靠廣受歡迎的AFNetworking 庫實現與伺服器的交互,JSON解析, 以及提供占位符圖片等多個功能。
簡言之,做到這些並不容易。這篇文章中我們了要解的是Alamofire庫。
基礎
Alamofire的核心主要是試圖簡化iOS中HTTP網路連接, 它通過使用NSURLSession以及Foundation URL Loading System來創建一個Swift本地的網路訪問介面,從而實現令人難以置信效率的任務。
Swift放棄了代理模式取而代之的使用了回調。對於我而言,我喜歡這個選擇。然而基礎承諾機制模式(promise-based patterns)也能起到一定作用, 它們也隱藏了一些壞代碼味道,對於一些人有點太神奇了。
進一步看,它是非同步實現的。你也許聽說過,但是在主線程上執行網路調用並不是一個好主意,不過Alamofire採用了許多創造性的最優方法。
例如,通過NSURLCache處理緩存來阻止不必要的訪問請求。另外,如果HTTP狀態碼在可接受的範圍內(200-300),就可以利用其豐富的鏈路模式通過少量代碼去做大量有意義的工作。
歷史總在重覆
Alamofire 也承續了AFNetworing使用者所熟悉的模式,一些處理方法也不同於它的前身,主要因為Alamofire是為了Swift而創建的。
例如, AFNetworking 調用子類AFHTTPSessionManager來使用每個API。也有例外,比如用NSURLSession替換NSURLConection。
Alamofire 通過遵守URLRequestConvertible協議創建一個路由Router來調用了類似的方法, 在底層,Alamofire 使用單例模式來創建在 NSURLSessionConfiguration.的頂層
初體驗
我們開始吧
1
2
3
|
Alamofire.request(.GET, “http: //www.telize.com/jsonip?callback=getip").response {(request, response, data, error) in println(request + response + error) } |
像AFNetworking 和其他的HTTP網路庫一樣,Alamofire提供了簡單、易用的方法來快速隨性的使用網路請求。這種特定的網路GET請求會返回一個請求對象,這個對象可以依附實現所有的HTTP過程的方法。
在Alamofire中,預設的行為規範是從伺服器響應積累到的NSData(數據),我通過一個閉包來鏈接一個響應處理程式來解析響應,或者但願對任何錯誤的響應不會發生在請求過程中。
-
響應
響應通過HTTP用不同的形式顯現,最受青睞的毫無疑問是JSON, JSON是XML的衍生品,相對XML更年輕更健壯。Alamofire對JSON型數據很友好。
1
2
3
|
Alamofire.request(.GET, “http: //httpbin.org/get").responseJSON {(request, response, JSON, error) in println(JSON) } |
有一系列簡單的JSON字元串作為指定的響應返回數據
我們繼續
在Alamofire中, 鏈接在其框架的使用中很底層, 每當想到在OC中用方括弧去定義類,讓人或高興或無奈。
Swift 像其他大多數高級語言一樣, 通過簡單的"."來調用函數, Alamofire 可以管理很多響應處理程式,而且一旦伺服器返迴響應它都會非同步執行。
和往常一樣, 看示例最可靠:
1
2
3
4
5
6
7
8
9
|
Alamofire.request(.GET, “http: //httpbin.org/get") .authenticate(HTTPBasic: user, password: password) .progress { (bytesRead, totalBytesRead, totalBytesExpectedToRead) in println(totalBytesRead) }.responseJSON { (request, response, JSON, error) in println(JSON) }.responseString { (request, response, string, error) in println(string) } |
參數
當然, 如果HTTP網路請求缺少了POST請求或查詢指定的訪問請求的能力就沒那麼令人期待了。
1
|
|
在Alamofire需要內嵌一個包含參數的一個字典, 如果你不指向特定的參數, 將傳入nil。對於編碼來說也是一樣的, 在網路請求函數這是第四個參數.
枚舉
如果有人已經使用過swift, 它們可能發現枚舉在Swift 中是如此的好用。在 Objective-C中,即使有現代化的NS_ENUM,它仍然只是允許定義整數聲明。
Swift 還有很多小技巧
Alamofire充分擁有這些技巧, 因此在一個HTTP通信中所有的編碼參數邏輯都是用參數編碼(ParameterEncoding)枚舉實現, 所有的HTTP verbs都以 RFC 2616 §9 定義, 如下:
1
2
3
4
5
6
7
8
9
10
11
12
|
public enum Method: String { case OPTIONS = “OPTIONS” case GET = “GET” case HEAD = “HEAD” case POST = “POST” case PUT = “PUT” case PATCH = “PATCH” case DELETE = “DELETE” case TRACE = “TRACE” case CONNECT = “CONNECT” } |
同時,如果你好奇Swift枚舉強大的功能, 免費下載 swift starter guide。請原諒我做的這個小廣告。
路由
創建一個網路訪問路由是實現的關鍵, 在這裡將定義一些共同的用於同一個 API 的端點, 通過一個遵循URLRequestConvertible的枚舉來創建一個路由。
當一個枚舉遵循URLRequestConvertible時, 它需要包含一個叫做URLRequest的變數, 這個變數必須是NSURLRequest類型.
對於HTTP網路庫的通常做法發生在這裡, 使用者極大可能定義一個靜態字元串來代表一個基礎的URL以及API key/consumer secret.
記住,在現實世界中最好不要將這些內容放到源代碼周圍。我個人選擇plist文件。
在任何情況下……
工作流如下:
-
定義一個基本的URL
-
通過在枚舉中的case語句定義埠(例如 Users, Comments等等)
-
URLRequest初始化並通過一個跟蹤閉包設置。在閉包中, 增加參數並構造端點。
-
URL、URLRequest 和編碼都占一個完全的網路請求發送到伺服器
多讀幾遍這個, 首先, 我認為這點有些不合理---一個函數實現過多的功能
在實踐中,它運作得很好:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
enum APIRouter: URLRequestConvertible { static let BASE_URL = //base url static let API_KEY = //api key, consumer secret for OAuth, etc case User(Int) case ProfilePicture(Int, Size) case Likes(Int, Int) var URLRequest: NSURLRequest { let (path: String, parameters: [String: AnyObject]) = { switch self { case .User (let page): let params = [] //Provide params return (“/user”, params) case .ProfilePicture(let id, let size): var params = [] return (“/profilepictures/\(id)”, params) case .Likes(let id, let commentsPage): var params = [] return (“/likes/\(id)/user”, params) } }() let URL = NSURL(string: APIRouter.BASE_URL) let URLRequest = NSURLRequest(URL:URL!.URLByAppendingPathComponent(path)) let encoding = Alamofire.ParameterEncoding.URL return encoding.encode(URLRequest, parameters: parameters).0 } } |
一個強有力的例子, 但是我選擇把代碼展示的更形象些。
豐富的功能
Alamofire有許多讓程式猿信服去使用它的理由。在iOS開發中,使用NURLSession是HTTP網路的未來趨勢, 相比NSURLConnection來說,它的功能更加豐富:
-
後臺上傳和下載
-
暫停以及重新開始網路操作的能力
-
可配置的容器(Container)
-
子類和私有存儲
-
改進的認證處理
-
對每個基礎連接進行身份驗證
-
多種代理模式--NSURLConnection擁有非同步代碼塊的基本方法, 但是不能用它們的代理,NSURLSession具有一種混合型的方法。
我認為大家都同意這是正確的選擇, 如果有人對AFNetworking 能做而Alamofire不能做的感興趣的話,那麼有以下幾點:
-
UIKit 擴展
-
TLS驗證
-
NSOperation/NSURLConnection/AFURLConnectionOperation調用
-
可達性(Reachability)
-
多重HTTP網路請求構架
根據使用情況決定, 需要使用這些特點的要麼是破壞游戲規則的人,要麼是不在乎的人。
總結
在這一點上,部分工程師爭論認為NSURLSession讓AFNetworking變成了一個華麗的封裝。這可能在某種程度上是正確的,但即使如此--這是一件壞事嗎?
它在簡化和抽象方面做的很好,雖然它不包含AFNetworking可以做的所有功能,但是這是 Swift 中 HTTP 網路的一個良好開端。
問啊-一鍵呼叫程式員答題神器,牛人一對一服務,開發者編程必備官方網站:www.wenaaa.com
QQ群290551701 聚集很多互聯網精英,技術總監,架構師,項目經理!開源技術研究,歡迎業內人士,大牛及新手有志於從事IT行業人員進入!