Alamofire 源码学习（一）- Alamofire 一瞥

关于 Alamofire

如果你曾经用 Objective-C 开发过 iOS 应用程序，那么你一定不会对 AFNetworking 这个第三方库感到陌生。AFNetworking 作为常用的网络请求库，以其简洁和优雅的特性，广受 iOS 应用开发者赞誉。自从 Swift 编程语言在一夜之间占领全世界之后，AFNetworking 的作者 Mattt Thompson 又马不停蹄地发起了一个基于 Swift 的网络请求库，这便是 Alamofire。Alamofire 并非是 AFNetworking 的 Swift 翻版，而是一个全新的项目。这个库秉承了作者一贯的高质量，截至今天，其在 Github 上面已经收获了接近 18000 个 star。Alamofire 的代码干净、清晰，而且总量还不到 1000 行，非常适合作为示例进行学习。通过对该库的学习，我们将：1. 了解 Swift 的常用编程范式以及编程技巧；2. 了解 Apple 的 URL Loading System。

本文介绍了一些简单的用法示例，借此管窥 Alamofire 的特性。

一个 GET 请求

Alamofire 的接口使用起来非常简单，比如，你可以这样发送一个 GET 请求：

Alamofire.request(.GET, "http://httpbin.org/get")
         .response { (request, response, data, error) in
             print(data)
          }

解析返回值

默认情况下，你会在 response 闭包中得到一个 NSData 对象。如果你希望得到字符串对象，可以使用 responseString:

Alamofire.request(.GET, "http://httpbin.org/get")
         .responseString { (request, response, string, error) in
             print(string)
         }

同样，你也可以得到 JSON 对象：

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

进度监听

你可以提供一个 progress 闭包，用以监听请求的进度：

Alamofire.upload(.POST, "https://httpbin.org/post", file: fileURL)
         .progress { bytesWritten, totalBytesWritten, totalBytesExpectedToWrite in
             print(totalBytesWritten)
 
             // This closure is NOT called on the main queue for performance
             // reasons. To update your ui, dispatch to the main queue.
             dispatch_async(dispatch_get_main_queue()) {
                 print("Total bytes written on main queue: \(totalBytesWritten)")
             }
          }
          .responseJSON { response in
              print(response)
          }

链式调用

得益于 Swift 提供的语法支持，Alamofire 提供的链式调用机制令网络请求十分简洁与直观：

Alamofire.request(.GET, "http://httpbin.org/get")
         .authenticate(HTTPBasic: user, password: password)
         .progress { (bytesRead, totalBytesRead, totalBytesExpectedToRead) in
             print(totalBytesRead)
         }
         .validate()
         .responseJSON { (request, response, JSON, error) in
             print(JSON)
         }
         .responseString { (request, response, string, error) in
             print(string)
         }

将请求转为等效的 cURL 命令

有时候你可能需要使用 curl 命令对网络请求进行调试。Alamofire 帮你把请求转换为等效的 curl 命令：

let request = Alamofire.request(.GET, "https://httpbin.org/get", parameters: ["foo": "bar"])
debugPrint(request)

这将得到如下输出：

$ curl -i \
       -H "User-Agent: Alamofire" \
       -H "Accept-Encoding: Accept-Encoding: gzip;q=1.0,compress;q=0.5" \
       -H "Accept-Language: en;q=1.0,fr;q=0.9,de;q=0.8,zh-Hans;q=0.7,zh-Hant;q=0.6,ja;q=0.5" \
       "https://httpbin.org/get?foo=bar"

参考

• Alamofire (Mattt Thompson, nshipster.com)
• Alamofire README (github.com)

（未完）