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"

参考

(未完)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,907评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,546评论 1 289
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,705评论 0 238
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,624评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,940评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,371评论 1 210
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,672评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,396评论 0 195
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,069评论 1 238
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,350评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,876评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,243评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,847评论 3 231
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,004评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,755评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,378评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,266评论 2 259

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,595评论 4 59
  • 【香知蜜读593】2017/07/30星期日 荐书蜜友:刘芹 文:佚名 纵观世界各种大学的排行榜,可以清晰的发现所...
    自律时光阅读 677评论 0 0
  • GitHub地址 一个自定义的ActionSheetView,支持显示标题,默认选中,使用block回调。 使用说...
    findM阅读 1,618评论 4 51
  • 南方的雨不像北方那样,会给路人留一份准备的时间,南方的雨是你看到黑云压来欲打伞,最后却在还未撑开之际被淋的像...
    我叫王粒粒阅读 504评论 0 0
  • 安装 Ubuntu下安装常规软件都比较简单,直接使用apt-get即可。安装步骤如下: 输入mysql命令 系统会...
    天花板阅读 15,635评论 0 17