对于AlamoFire几点思考

本文主要是介绍对于AlamoFire几点思考，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本文由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.的顶层

初体验

我们开始吧

  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型数据很友好。

  Alamofire.request(.GET, “http: //httpbin.org/get").responseJSON {(request, response, JSON, error) in 
      println(JSON) 
 } 
 

有一系列简单的JSON字符串作为指定的响应返回数据

我们继续

在Alamofire中, 链接在其框架的使用中很底层, 每当想到在OC中用方括号去定义类,让人或高兴或无奈。

Swift 像其他大多数高级语言一样, 通过简单的"."来调用函数， Alamofire 可以管理很多响应处理程序，而且一旦服务器返回响应它都会异步执行。

和往常一样, 看示例最可靠：

  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请求或查询指定的访问请求的能力就没那么令人期待了。

  Alamofire.request(.GET,  "http://httpbin.org/get" , parameters: [ "key" :  "value" ]) 
 

在Alamofire需要内嵌一个包含参数的一个字典, 如果你不指向特定的参数, 将传入nil。对于编码来说也是一样的, 在网络请求函数这是第四个参数.

枚举

如果有人已经使用过swift, 它们可能发现枚举在Swift 中是如此的好用。在 Objective-C中，即使有现代化的NS_ENUM，它仍然只是允许定义整数声明。

Swift 还有很多小技巧

Alamofire充分拥有这些技巧, 因此在一个HTTP通信中所有的编码参数逻辑都是用参数编码（ParameterEncoding）枚举实现, 所有的HTTP verbs都以 RFC 2616 §9 定义, 如下:

  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 和编码都占一个完全的网络请求发送到服务器

多读几遍这个, 首先, 我认为这点有些不合理---一个函数实现过多的功能

在实践中，它运作得很好：

  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 
      } 
 } 
 