iOS-raywenderlich翻译-AFNetworking速成教程

我不是女神ヾ 2022-03-20 03:54 219阅读 0赞

#  #

# 注：本文由BeyondVincent(破船)翻译首发   转载请注明出处：**[http://blog.csdn.net/beyondvincent][http_blog.csdn.net_beyondvincent]** #

# 腾讯微博:[beyondvincent][] #

# 新浪微博:[beyondvincent][beyondvincent 1]      #

#     #

注：本文译自 [http://www.raywenderlich.com/30445/afnetworking-crash-course][http_www.raywenderlich.com_30445_afnetworking-crash-course]

18 MARCH 2013

[  
![Learn how to use AFNetworking: an easy to use network API for iOS!][Learn how to use AFNetworking_ an easy to use network API for iOS]][Learn how to use AFNetworking_ an easy to use network API for iOS]

学习如何使用AFNetworking: iOS中使用起来非常方便的网络API！

*本文是由 iOS Tutorial 小组成员 [Scott Sherwood][]撰写，他是一个动态加载（[Dynamically Loaded][]）（基于位置）软件公司（专业的混合定位）的共同创办人。*

网络 — 你的程序离开了它就不能生存下去！苹果Foundation framework中的NSURLConnection又非常难以理解, 不过这里有一个可以使用的替代品：[AFNetworking][].

AFNetworking 非常受开发者欢迎 – 它赢得了我们读者的选择：2012年最佳的iOS Library奖（[2012 Best iOS Library Award][].） 所以现在我就写这篇文章来向你介绍如何在程序中有效的使用它。

AFNetworking 包括了所有你需要与在线资源交互的内容，从web services到文件下载。当你的程序在下载一个大文件期间，AFNetworking还能确保你的UI是可以响应的。

本文将介绍AFNetworking框架主要的组成部分。一路上，你将使用[World Weather Online][]提供的咨询(Feeds)来创建一个天气(Weather)程序。刚开始使用的天气数据是静态的，不过在学完本文内容之后，程序将连接到实时的天气咨询。

今日预计：一个很酷的开发者学习所有关于AFNetworking知识，并在他的程序中使用AFNetworking。我们开始忙活吧！

## 入门 ##

首先来这里（[here][]）下载本文的启动项目。这个工程提供了一个基本的UI — AFNetworking相关代码还没有添加。

打开**MainStoryboard.storyboard**文件，将看到3个view controller：

[![AfNetworking Setup Overview][]][AfNetworking Setup Overview 1]

从左到右，分别是：

*  顶级(top-level)的导航控制器;
 *  用来显示天气的一个table view controller，每天一行;
 *  一个自定义的view controller (WeatherAnimationViewController) 当用户点击某个table view cell时，这个view controller将显示某一天的天气咨询。

生成并运行项目，你将看到相关的UI出现，但是什么都没有实现！因为程序需要从网络中获取到所需要的数据，而相关代码还没有添加。这也是本文中你将要实现的！

首先，你需要将AFNetworking 框架包含到工程中。如果你还没有AFNetworking的话，在这里下载最新的版本：[GitHub][].

当你解压出下载的文件后，你将看到其中有一个AFNetworking子文件夹，里面全是.h 和 .m 文件, 如下高亮显示的:

[![AFNetworking Folder Setup][]][AFNetworking Folder Setup 1]

将**AFNetworking**拖拽到Xcode工程中.

[![Include AFNetworking][]][Include AFNetworking 1]

当出现了添加文件的选项时，确保勾选上**Copy items into destination group’s folder (if needed)** 和 **Create groups for any added folders**.

要完成相关配置，请在工程的**Supporting Files**群组中打开预编译头文件**Weather-Prefix.pch**. 然后在别的import后面添加如下一行代码：

将AFNetworking添加到预编译头文件，意味着这个框架会被自动的添加到工程的所有源代码文件中。

很容易，不是吗？现在你已经准备好“天气”程序代码了！

## 操作JSON ##

AFNetworking通过网络来加载和处理结构化的数据是非常智能的，普通的HTTP请求也一样。尤其是它支持JSON, XML 和 Property Lists (plists).

你可以下载一些JSON数据，然后用自己的解析器来解析，但这何必呢？通过AFNetworking就可以完成这些操作！Y

[![AFNetworkingHero][]][AFNetworkingHero 1]

首先，你需要测试脚本（数据）所需的一个基本URL。将下面的这个静态NSString声明到**WTTableViewController.m**顶部，也就是所有\#import下面：

这个URL是一个非常简单的“web service”，在本文中我特意为你创建的。如果你想知道它看起来是什么样，可以来这里下载代码：[download the source][].

这个web service以3种不同的格式（JSON, XML 和 PLIST）返回天气数据。你可以使用下面的这些URL来看看返回的数据：

*  [http://www.raywenderlich.com/downloads/weather\_sample/weather.php?format=json][http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_json]
 *  [http://www.raywenderlich.com/downloads/weather\_sample/weather.php?format=xml][http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_xml]
 *  [http://www.raywenderlich.com/downloads/weather\_sample/weather.php?format=plist][http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_plist] (might not show up right in your browser)

第一个数据格式使用的是[JSON][]. JSON 是一种常见的JavaScript派生类对象格式。看起来如下:

**注意:** 如果你想要结更多关于JSON内容，请参考：[Working with JSON in iOS 5 Tutorial][].

当用户点击程序中的JSON按钮时，你希望对从服务中获得的JSON数据进行加载并处理。在**WTTableViewController.m**中，找到**jsonTapped:** 方法 (现在应该是空的) ，并用下面的代码替换：

这是你的第一个AFNetworking代码！因此，这看起来是全新的，我将对这个方法中代码进行介绍。

1.  根据基本的URL构造出完整的一个URL。然后通过这个完整的URL获得一个NSURL对象，然后根据这个url获得一个NSURLRequest.
2.  AFJSONRequestOperation 是一个功能完整的类（all-in-one）— 整合了从网络中获取数据并对JSON进行解析。
3.  当请求成功，则运行成功块（success block）。在本示例中，把解析出来的天气数据从JSON变量转换为一个字典（dictionary），并将其存储在属性 **weather** 中.
4.  如果运行出问题了，则运行失败块（failure block），比如网络不可用。如果failure block被调用了，将会通过提示框显示出错误信息。

如上所示，AFNetworking的使用非常简单。如果要用苹果提供的APIs（如NSURLConnection）来实现同样的功能（下载和解析JSON数据），则需要许多代码才能做到。

现在天气数据已经存在于**self.weather**中，你需要将其显示出来。找到**tableView:numberOfRowsInSection:** 方法，并用下面的代码替换：

table view有两个section：第一个用来显示当前天气，第二个用来显示未来的天气。

等一分钟，你可能正在思考。这里的 **\[self.weather upcomingWeather\]**是什么? 如果self.weather是一个普通的NSDictionary, 它是怎么知道 “upcomingWeather” 是什么呢?

为了更容易的解析数据，在starter工程中，有一对NSDictionary categories：

*  NSDictionary+weather.m
 *  NSDictionary+weather\_package.m

这些categories添加了一些方便的方法，通过这些方法可以很方便的对字典中的数据元素进行访问。这样你就可以专注于网络部分，而不是NSDictionary中数据的访问。对吧？

回到 **WTTableViewController.m**, 找到 **tableView:cellForRowAtIndexPath:** 方法，并用下面的实现替换：

跟tableView:numberOfRowsInSection: 方法一样，在这里使用了便利的NSDictionary categories来获得数据。当前天的天气是一个字典，而未来几日的天气则存储在一个数组中。

生成并运行工程，然后点击JSON按钮. 这将会动态的获得一个AFJSONOperation对象, 并看到如下画面内容：

[![AFJsonOperation Retrieved][]][AFJsonOperation Retrieved 1]

JSON 操作成功!

## 操作Property Lists(plists) ##

Property lists (或简称为 plists) 是以确定的格式（苹果定义的）构成的XML文件。苹果一般将plists用在用户设置中。看起来如下：

上面的意思是：

*  一个字典中有一个名为“data”的key，这个key对应着另外一个字典。
 *  这个字典有一个名为 “current\_condition” 的key，这个key对应着一个array.
 *  这个数组包含着一个字典，字典中有多个key和values。比如cloudcover=16和humidity=59.

现在是时候加载plist版本的天气数据了！找到**plistTapped:** 方法，并用下面的实现替换：

注意到，上面的代码几乎与JSON版的一致，只不过将操作（operation）的类型从AFJSONOperation 修改为 AFPropertyListOperation. 这非常的整齐：你才程序只需要修改一丁点代码就可以接收JSON或plist格式的数据了！

生成并运行工程，然后点击PLIST按钮。将看到如下内容：

[![AFPropertyListRetrieved][]][AFPropertyListRetrieved 1]

如果你需要重置所有的内容，以重新开始操作，导航栏顶部的Clear按钮可以清除掉title和table view中的数据。

操作XML

AFNetworking处理JSON和plist的解析使用的是类似的方法，并不需要花费太多功夫，而处理XML则要稍微复杂一点。下面，就根据XML咨询构造一个天气字典（NSDictionary）。

iOS提供了一个帮助类：NSXMLParse (如果你想了解更多内容，请看这里的链接：[SAX parser][]).

还是在文件**WTTableViewController.m**, 找到 **xmlTapped:** 方法，并用下面的实现替换：

到现在为止，这看起来跟之前处理JSON和plist很类似。最大的改动就是在成功块（success block）中, 在这里不会传递给你一个预处理好的NSDictionary对象. 而是AFXMLRequestOperation实例化的NSXMLParse对象，这个对象将用来处理繁重的XML解析任务。

NSXMLParse对象有一组delegate方法是你需要实现的 — 用来获得XML数据。注意，在上面的代码中我将XMLParser的delegate设置为self, 因此WTTableViewController将用来处理XML的解析任务。

首先，更新一下**WTTableViewController.h** 并修改一下类声明，如下所示：

上面代码的意思是这个类将实现（遵循）NSXMLParserDelegate协议. 下一步将下面的delegate方法声明添加到@implementation后面:

为了支持咨询的解析，还需要一些属性来存储相关的数据。将下面的代码添加到@implementatio后面:

接着打开**WTTableViewController.m**，现在你需要一个一个的实现上面所说的几个delegate方法。将下面这个方法粘贴到实现文件中：

当NSXMLParser发现了新的元素开始标签时，会调用上面这个方法。在这个方法中，在构造一个新字典用来存储赋值给currentDictionary属性之前，首先保存住上一个元素名称。还要将**outstring**重置一下，这个字符串用来构造XML标签中的数据。

然后将下面这个方法粘贴到上一个方法的后面：

如名字一样，当NSXMLParser在一个XML标签中发现了字符数据，会调用这个方法。该方法将字符数据追加到outstring属性中，当XML标签结束的时候，这个outstring会被处理。

继续，将下面这个方法粘贴到上一个方法的后面：

<table style="padding:0px; border:none; outline:0px; font-style:inherit; font-size:13px; font-family:inherit; vertical-align:baseline; border-collapse:collapse; border-spacing:0px; background-color:rgb(255,255,255); width:1051px; margin:0px!important"> 
 <tbody style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline"> 
 <tr style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline"> 
 <td style="margin:0px; padding:2px 4px; border:0px; outline:0px; font-style:inherit; font-size:13px; font-family:inherit; vertical-align:top"> <pre><code>- (void)parser:(<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSXMLParser_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSXMLParser</a> *)parser didEndElement:(<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> *)elementName namespaceURI:(<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> *)namespaceURI qualifiedName:(<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> *)qName {
 
&nbsp;
 // 1
 if([qName isEqualToString:@"current_condition"] ||
 [qName isEqualToString:@"request"]){
 
 [self.xmlWeather setObject:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSArray_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSArray</a> arrayWithObject:self.currentDictionary] forKey:qName];
 self.currentDictionary = nil;
 }
 // 2
 else if([qName isEqualToString:@"weather"]){
 
&nbsp;
 // Initalise the list of weather items if it dosnt exist
 <a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSMutableArray_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSMutableArray</a> *array = [self.xmlWeather objectForKey:@"weather"];
 if(!array)
 array = [<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSMutableArray_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSMutableArray</a> array];
&nbsp;
 [array addObject:self.currentDictionary];
 [self.xmlWeather setObject:array forKey:@"weather"];
&nbsp;
 self.currentDictionary = nil;
 }
 // 3
 else if([qName isEqualToString:@"value"]){
 
 //Ignore value tags they only appear in the two conditions below
 }
 // 4
 else if([qName isEqualToString:@"weatherDesc"] ||
 [qName isEqualToString:@"weatherIconUrl"]){
 
 [self.currentDictionary setObject:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSArray_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSArray</a> arrayWithObject:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSDictionary_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSDictionary</a> dictionaryWithObject:self.outstring forKey:@"value"]] forKey:qName];
 }
 // 5
 else {
 
 [self.currentDictionary setObject:self.outstring forKey:qName];
 }
&nbsp;
	self.elementName = nil;
}</code></pre> </td> 
 </tr> 
 </tbody> 
</table>

当检测到元素的结束标签时，会调用上面这个方法。在这个方法中，会查找一些标签：

1.  **urrent\_condition** 元素表示获得了一个今天的天气。会把今天的天气直接添加到xmlWeather字典中。
2.  **weather** 元素表示获得了随后一天的天气。今天的天气只有一个，而后续的天气有多个，所以在此，将后续天气添加到一个数组中。
3.  **value** 标签出现在别的标签中，所以这里可以忽略掉这个标签。
4.  **weatherDesc** 和 **weatherIconUrl** 元素的值在存储之前，需要需要被放入一个数组中 — 这里的结构是为了与JSON和plist版本天气咨询格式相匹配。
5.  所有其它元素都是按照原样（as-is）进行存储的。

下面是最有一个delegate方法！将下面这个方法粘贴到上一个方法的后面：

当NSXMLParser解析到document的尾部时，会调用这个方法。在此，xmlWeather字典已经构造完毕，table view可以重新加载了。

在上面代码中将xmlWeather添加到一个字典中，看起来是冗余的, 不过这样可以确保与JSON和plist版本的格式完全匹配。这样所有的3种数据格式（JSON, plist和XML）都能够用相同的代码来显示！

[![awww-yeah-female-aww-yeah][]][awww-yeah-female-aww-yeah 1]

现在所有的delegate方法和属性都搞定了，找到**xmlTapped:** 方法，并取消注释成功块（success block）中的一行代码：

生成和运行工程，然后点击XML按钮，将看到如下内容：

[![AFXMLOperation Retrieved][]][AFXMLOperation Retrieved 1]

未完待续 破船 2013-03-19 :\]

## 一个小的天气程序 ##

嗯, 上面的这个程序看起来体验不太友好，有点像整周都是阴雨天。如何让table view中的天气信息体验更好点呢？

再仔细看看之前的JSON格式数据：[JSON format from before][http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_json]，你会看到每个天气项里面都有一个图片URLs。 将这些天气图片显示到每个table view cell中，这样程序看起来会更有意思。

AFNetworking给UIImageView添加了一个category，让图片能够异步加载，也就是说当图片在后台下载的时候，程序的UI界面仍然能够响应。为了使用这个功能，首先需要将这个category import到**WTTableViewController.m**文件的顶部：

找到**tableView:cellForRowAtIndexPath:** 方法，并将下面的代码粘贴到最后的**return cell;** 代码上上面（这里应该有一个注释标记）

首先创建一个弱引用(weak)的cell，这样就可以在block中使用这个cell。如果你直接访问cell变量，Xcode会提示一个关于retain循环和内存泄露的警告。

UIImageView+AFNetworking category定义了一个**setImageWithURLRequest…** 方法. 这个方法的参数包括：一个指向图片URL的请求，一个占位符图片，一个success block和一个failure block。

当cell首次被创建的时候，cell中的UIImageView将显示一个占位符图片，直到真正的图片被下载完成。在这里你需要确保占位符的图片与实际图片尺寸大小相同。

如果尺寸不相同的话，你可以在success block中调用cell的setNeedsLayout方法. 上面代码中对两行代码进行了注释，这是因为这里的占位符图片尺寸正好合适，留着注释，可能在别的程序中需要用到。

现在生成并运行工程，然后点击之前添加的3个操作中的任意一个，将看到如下内容：

[![UIImageView+AFNetworking Weather Example][UIImageView_AFNetworking Weather Example]][UIImageView_AFNetworking Weather Example_UIImageView_AFNetworking Weather Example]

很好! 异步加载图片从来没有这么简单过。

## 一个RESTful类 ##

到现在你已经使用类似AFJSONRequestOperation这样的类创建了一次性的HTTP请求。另外，较低级的AFHTTPClient类是用来访问单个的web service终端。 对这个AFHTTPClient一般是给它设置一个基本的URL，然后用AFHTTPClient进行多个请求（而不是像之前的那样，每次请求的时候，都创建一个AFHTTPClient）。

AFHTTPClient同样为编码参数、处理multipart表单请求body的构造、管理请求操作和批次入队列操作提供了很强的灵活性，它还处理了整套RESTful (GET, POST, PUT, 和 DELETE), 下面我们就来试试最常用的两个：GET 和 POST.

**注意:** 对REST, GET和POST不清楚？看看这里比较有趣的介绍 – 我如何给妻子解释REST([How I Explained REST to My Wife][].)

在**WTTableViewController.h** 顶部将类声明按照如下修改：

在 **WTTableViewController.m**中，找到**httpClientTapped:** 方法，并用下面的实现替换：

上面的方法会弹出一个action sheet，用以选择GET和POST请求。粘贴如下代码以实现action sheet中按钮对应的操作：

<table style="padding:0px; border:none; outline:0px; font-style:inherit; font-size:13px; font-family:inherit; vertical-align:baseline; border-collapse:collapse; border-spacing:0px; background-color:rgb(255,255,255); width:799px; margin:0px!important"> 
 <tbody style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline"> 
 <tr style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline"> 
 <td style="margin:0px; padding:2px 4px; border:0px; outline:0px; font-style:inherit; font-size:13px; font-family:inherit; vertical-align:top"> <pre><code>- (void)actionSheet:(UIActionSheet *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex{
 
 // 1
 <a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSURL_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSURL</a> *baseURL = [<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSURL_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSURL</a> URLWithString:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> stringWithFormat:BaseURLString]];
 <a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSDictionary_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSDictionary</a> *parameters = [<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSDictionary_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSDictionary</a> dictionaryWithObject:@"json" forKey:@"format"];
&nbsp;
 // 2
 AFHTTPClient *client = [[AFHTTPClient alloc] initWithBaseURL:baseURL];
 [client registerHTTPOperationClass:[AFJSONRequestOperation class]];
 [client setDefaultHeader:@"Accept" value:@"application/json"];
&nbsp;
 // 3
 if (buttonIndex==0) {
 
 [client postPath:@"weather.php"
 parameters:parameters
 success:^(AFHTTPRequestOperation *operation, id responseObject) {
 
 self.weather = responseObject;
 self.title = @"HTTP POST";
 [self.tableView reloadData];
 }
 failure:^(AFHTTPRequestOperation *operation, <a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSError_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSError</a> *error) {
 
 UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"Error Retrieving Weather"
 message:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> stringWithFormat:@"%@",error]
 delegate:nil
 cancelButtonTitle:@"OK" otherButtonTitles:nil];
 [av show];
&nbsp;
 }
 ];
 }
 // 4
 else if (buttonIndex==1) {
 
 [client getPath:@"weather.php"
 parameters:parameters
 success:^(AFHTTPRequestOperation *operation, id responseObject) {
 
 self.weather = responseObject;
 self.title = @"HTTP GET";
 [self.tableView reloadData];
 }
 failure:^(AFHTTPRequestOperation *operation, <a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSError_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSError</a> *error) {
 
 UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"Error Retrieving Weather"
 message:[<a href="http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/" style="margin:0px; padding:0px; border:0px; outline:0px; font-style:inherit; font-family:inherit; vertical-align:baseline; color:rgb(0,104,55); text-decoration:initial" rel="nofollow">NSString</a> stringWithFormat:@"%@",error]
 delegate:nil
 cancelButtonTitle:@"OK" otherButtonTitles:nil];
 [av show];
&nbsp;
 }
 ];
 }
}</code></pre> </td> 
 </tr> 
 </tbody> 
</table>

上面的代码作用如下:

1.  构建一个baseURL，以及一个参数字典，并将这两个变量传给AFHTTPClient.
2.  将AFJSONRequestOperation注册为HTTP的操作, 这样就可以跟之前的示例一样，可以获得解析好的JSON数据。
3.  做了一个GET请求，这个请求有一对block：success和failure。
4.  POST请求跟GET一样。

在这里，将请求一个JSON回应，当然也可以使用之前讨论过的另外两种格式来代替JSON。

生成并运行工程，点击HTTPClient按钮，然后选择GET 或 POST按钮来初始化一个相关的请求。之后会看到如下内容：

[![AFHTTPClient GET POST][]][AFHTTPClient GET POST 1]

至此，你已经知道AFHTTPClient最基本的使用方法。不过，这里还有更好的一种使用方法，它可以让代码更加干净整齐，下面我们就来学习一下吧。

## 连接到Live Service ##

到现在为止，你已经在table view controller中直接调用了AFRequestOperations 和 AFHTTPClient. 实际上，大多数时候不是这样的，你的网络请求会跟某个web service或API相关。

AFHTTPClient已经具备与web API通讯的所有内容。AFHTTPClient在代码中已经把网络通讯部分做了解耦处理，让网络通讯的代码在整个工程中都可以重用。

下面是两个关于AFHTTPClient最佳实践的指导：

1.  为每个web service创建一个子类。例如，如果你在写一个社交网络聚合器，那么可能就会有Twitter的一个子类，Facebook的一个子类，Instragram的一个子类等等。
2.  在AFHTTPClient子类中，创建一个类方法，用来返回一个共享的单例，这将会节约资源并省去必要的对象创建。

当前，你的工程中还没有一个AFHTTPClient的子类，下面就来创建一个吧。我们来处理一下，让代码清洁起来。

首先，在工程中创建一个新的文件：iOS\\Cocoa Touch\\Objective-C Class. 命名为**WeatherHTTPClient** 并让其继承自**AFHTTPClient**.

你希望这个类做3件事情：

A：执行HTTP请求

B：当有新的可用天气数据时，调用delegate

C：使用用户当前地理位置来获得准确的天气。

用下面的代码替换**WeatherHTTPClient.h**:

在实现文件中，你将了解头文件中定义的更多相关内容。打开**WeatherHTTPClient.m** 并将下面的代码添加到@implementation下面:

sharedWeatherHTTPClient 方法使用Grand Central Dispatch（GCD）来确保这个共享的单例对象只被初始化分配一次。这里用一个base URL来初始化对象，并将其设置为期望web service响应为JSON。

将下面的方法粘贴到上一个方法的下面：

这个方法调用World Weather Online接口，以获得具体位置的天气信息。

**非常重要！本实例中的API key仅仅是为本文创建的。如果你创建了一个程序，请在[World Weather Online][]创建一个账号，并获得你自己的API key！**

一旦对象获得了天气数据，它需要一些方法来通知对此感兴趣的对象：数据回来了。这里要感谢WeatherHttpClientDelegate 协议和它的delegate方法，在上面代码中的success 和 failure blocks可以通知一个controller：指定位置的天气已经更新了。这样，controller就可以对天气做更新显示。

现在，我们需要把这些代码片段整合到一起！WeatherHTTPClient希望接收一个位置信息，并且WeatherHTTPClient定义了一个delegate协议，现在对WTTableViewControlle类做一下更新，以使用WeatherHTTPClient.

打开**WTTableViewController.h** 添加一个import，并用下面的代码替换@interface声明:

另外添加一个新的Core Location manager 属性:

在 **WTTableViewController.m**中，将下面的代码添加到**viewDidLoad:**的底部：

上面这两行代码初始化了Core Location manager，这样当view加载的时候，用来确定用户的当前位置。Core Location然后会通过delegate回调以传回位置信息。将下面的方法添加到实现文件中：

现在，当用户的位置有了变化时，你就可以使用WeatherHTTPClient单例来请求当前位置的天气信息。

记住，WeatherHTTPClient有两个delegate方法需要实现。将下面两个方法添加到实现文件中：

上面的两个方法，当WeatherHTTPClient请求成功, 你就可以更新天气数据并重新加载table view。如果网络错误，则显示一个错误信息。

找到**apiTapped:** 方法，并用下面的方法替换：

生成并运行程序，点击AP按钮以初始化一个WeatherHTTPClient 请求, 然后会看到如下画面:

[![WeatherHTTPClient Updated][]][WeatherHTTPClient Updated 1]

希望在这里你未来的天气跟我的一样：晴天！

## 我还没有死！ ##

你可能注意到了，这里调用的外部web service需要花费一些时间才能返回数据。当在进行网络操作时，给用户提供一个信息反馈是非常重要的，这样用户才知道程序是在运行中或已奔溃了。

[![Needfeedback][]][Needfeedback 1]

很幸运的是，AFNetworking有一个简便的方法来提供信息反馈：**AFNetworkActivityIndicatorManager**.

在 **WTAppDelegate.m**中，找到**application:didFinishLaunchingWithOptions:** 方法，并用下面的方法替换：

让sharedManager可以自动的显示出网络活动指示器（ network activity indicator）— 无论射门时候，只要有一个新的网络请求在后台运行着。 这样你就不需要每次请求的时候，都要单独进行管理。

生成并运行工程，无论什么时候，只要有网络请求，都可以在状态栏中看到一个小的网络风火轮：

[![Network Spinner][]][Network Spinner 1]

现在，即使你的程序在等待一个很慢的web service，用户都知道程序还在运行着。

## 下载图片 ##

如果你在table view cell上点击，程序会切换到天气的详细画面，并且以动画的方式显示出相应的天气情况。

这非常不错，但目前动画只有一个背景图片。除了通过网络来更新背景图片，还有更好的方法吗！

下面是本文关于介绍AFNetworking的最后内容了：**AFImageRequestOperation.** 跟AFJSONRequestOperation一样, AFImageRequestOperation封装了HTTP请求：获取图片。

在**WeatherAnimationViewController.m** 中有两个方法需要实现. 找到**updateBackgroundImage:** 方法，并用下面的代码替换:

这个方法初始化并下载一个新的背景图片。在结束时，它将返回请求到的完整图片。

在WeatherAnimationViewController.m中, 你将看到两个辅助方法：imageWithFilename: 和 saveImage:withFilename:, 通过这两个辅助方法，可以对下载下来的图片进行存储和加载。updateBackgroundImage: 将通过辅助方法把下载的图片存储到磁盘中。

接下来找到**deleteBackgroundImage:** 方法，并用下面的代码替换:

这个方法将删除已经下载的图片，这样在测试程序的时候，你可以再次下载图片。

最后一次：生成并运行工程，下载天气数据，并点击某个cell，以打开详细天气画面。在详细天气画面中，点击Update Background 按钮. 如果你点击的是晴天cell，将会看到如下画面：

[![AFNetworking Weather Tutorial][]][AFNetworking Weather Tutorial 1]

## 何去何从？ ##

你可以在这里下载到完整的工程：[here][here 1].

你所想到的所有方法，都可以通过使用AFNetworking来与外界通讯：

*  AFJSONOperation, AFPropertyListOperation 和 AFXMLOperation用来解析结构化数据。
 *  UIImageView+AFNetworking用来快捷的填充image view。
 *  AFHTTPClient用来进行更底层的请求。
 *  用自定义的AFHTTPClient子类来访问一个web service。
 *  AFNetworkActivityIndicatorManager用来给用户做出网络访问的提示。
 *  AFImageRequestOperation用来加载图片。

AFNetworking的威力可以帮助你进行网络开发！

如果你有任何相关问题，请访问我们的网站以获得帮助。我也很乐意看到你的回复！

![ScottSherwood.png][]*本文是由 iOS Tutorial 小组成员 [Scott Sherwood][]撰写，他是一个动态加载（[Dynamically Loaded][]）（基于位置）软件公司（专业的混合定位）的共同创办人。*

[Tweet][]

[iPhone][]Category:

Tags: [iOS][], [ios6][], [iPhone][iPhone 1], [networked][], [sample code][], [tutorial][]

###  ###

### 发表评论（Leave a Comment） ###

很想听听你的想法(I'd love to hear your thoughts)!

[添加评论(Add a comment)!][Add a comment]  [添加评论(Add a comment)!][Add a comment] [ ][Add a comment]

本文翻译完毕！2013-03-20 破船 :\]

[http_blog.csdn.net_beyondvincent]: http://blog.csdn.net/beyondvincent
[beyondvincent]: http://write.blog.csdn.net/postedit/t.qq.com/beyondvincent
[beyondvincent 1]: http://weibo.com/beyondvincent
[http_www.raywenderlich.com_30445_afnetworking-crash-course]: http://www.raywenderlich.com/30445/afnetworking-crash-course
[Learn how to use AFNetworking_ an easy to use network API for iOS]: http://cdn2.raywenderlich.com/wp-content/uploads/2013/02/afnetworking1.png
[Scott Sherwood]: http://www.raywenderlich.com/about#scottsherwood
[Dynamically Loaded]: http://www.dynamicallyloaded.com/
[AFNetworking]: http://afnetworking.com/
[2012 Best iOS Library Award]: http://www.raywenderlich.com/21987/top-10-most-useful-ios-libraries-to-know-and-love
[World Weather Online]: http://www.worldweatheronline.com/free-weather-feed.aspx
[here]: http://cdn3.raywenderlich.com/downloads/WeatherStarter.zip
[AfNetworking Setup Overview]: http://cdn4.raywenderlich.com/wp-content/uploads/2013/01/Screen-Shot-2013-01-26-at-12.54.03-700x474.png
[AfNetworking Setup Overview 1]: http://www.raywenderlich.com/?attachment_id=30460
[GitHub]: https://github.com/AFNetworking/AFNetworking
[AFNetworking Folder Setup]: http://cdn4.raywenderlich.com/wp-content/uploads/2013/01/AFNetworking-Folder-238x500.png
[AFNetworking Folder Setup 1]: http://www.raywenderlich.com/?attachment_id=30474
[Include AFNetworking]: http://cdn2.raywenderlich.com/wp-content/uploads/2013/01/Include-AFNetworking-700x474.png
[Include AFNetworking 1]: http://www.raywenderlich.com/?attachment_id=30486
[AFNetworkingHero]: http://cdn2.raywenderlich.com/wp-content/uploads/2013/02/AFNetworkingHero.jpg
[AFNetworkingHero 1]: http://www.raywenderlich.com/?attachment_id=33763
[download the source]: http://cdn3.raywenderlich.com/downloads/weather_sample.zip
[http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_json]: http://www.raywenderlich.com/downloads/weather_sample/weather.php?format=json
[http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_xml]: http://www.raywenderlich.com/downloads/weather_sample/weather.php?format=xml
[http_www.raywenderlich.com_downloads_weather_sample_weather.php_format_plist]: http://www.raywenderlich.com/downloads/weather_sample/weather.php?format=plist
[JSON]: https://en.wikipedia.org/wiki/JSON
[Working with JSON in iOS 5 Tutorial]: http://www.raywenderlich.com/5492/working-with-json-in-ios-5
[AFJsonOperation Retrieved]: http://cdn4.raywenderlich.com/wp-content/uploads/2013/01/AFJsonOperation-Retrieved1-181x320.png
[AFJsonOperation Retrieved 1]: http://www.raywenderlich.com/?attachment_id=30526
[AFPropertyListRetrieved]: http://cdn5.raywenderlich.com/wp-content/uploads/2013/01/AFPropertyListRetrieved-180x320.png
[AFPropertyListRetrieved 1]: http://www.raywenderlich.com/?attachment_id=30523
[SAX parser]: https://en.wikipedia.org/wiki/Simple_API_for_XML
[awww-yeah-female-aww-yeah]: http://cdn3.raywenderlich.com/wp-content/uploads/2013/02/awww-yeah-female-aww-yeah-480x299.png
[awww-yeah-female-aww-yeah 1]: http://www.raywenderlich.com/?attachment_id=33755
[AFXMLOperation Retrieved]: http://cdn4.raywenderlich.com/wp-content/uploads/2013/01/AFXMLOperation-Retrieved-180x320.png
[AFXMLOperation Retrieved 1]: http://www.raywenderlich.com/?attachment_id=30530
[UIImageView_AFNetworking Weather Example]: http://cdn1.raywenderlich.com/wp-content/uploads/2013/01/UIImageView+AFNetworking-Weather-Example-180x320.png
[UIImageView_AFNetworking Weather Example_UIImageView_AFNetworking Weather Example]: /images/20220320/dbb430f632b94572ae32bc37e977a5de.png
[How I Explained REST to My Wife]: http://tomayko.com/writings/rest-to-my-wife
[AFHTTPClient GET POST]: http://cdn3.raywenderlich.com/wp-content/uploads/2013/01/AFHTTPClient-480x259.png
[AFHTTPClient GET POST 1]: http://www.raywenderlich.com/?attachment_id=30539
[WeatherHTTPClient Updated]: http://cdn5.raywenderlich.com/wp-content/uploads/2013/01/WeatherHTTPClient-Updated-173x320.png
[WeatherHTTPClient Updated 1]: http://www.raywenderlich.com/?attachment_id=30547
[Needfeedback]: http://cdn1.raywenderlich.com/wp-content/uploads/2013/02/Needfeedback1-480x177.png
[Needfeedback 1]: http://www.raywenderlich.com/?attachment_id=33758
[Network Spinner]: http://cdn2.raywenderlich.com/wp-content/uploads/2013/01/Network-Spinner.png
[Network Spinner 1]: http://www.raywenderlich.com/?attachment_id=30549
[AFNetworking Weather Tutorial]: http://cdn5.raywenderlich.com/wp-content/uploads/2013/01/AFNetworking-Weather-Tutorial-700x367.png
[AFNetworking Weather Tutorial 1]: http://www.raywenderlich.com/?attachment_id=30552
[here 1]: http://cdn2.raywenderlich.com/downloads/Weather_Final.zip
[ScottSherwood.png]: http://cdn1.raywenderlich.com/downloads/ScottSherwood.png
[Tweet]: http://twitter.com/share?url=http%3A%2F%2Fbit.ly%2F158X7iN&via=rwenderlich&text=AFNetworking%20Crash%20Course&related=rwenderlich&lang=en&count=horizontal&counturl=http%3A%2F%2Fwww.raywenderlich.com%2F30445%2Fafnetworking-crash-course
[iPhone]: http://www.raywenderlich.com/category/iphone
[iOS]: http://www.raywenderlich.com/tag/ios
[ios6]: http://www.raywenderlich.com/tag/ios6
[iPhone 1]: http://www.raywenderlich.com/tag/iphone
[networked]: http://www.raywenderlich.com/tag/networked
[sample code]: http://www.raywenderlich.com/tag/sample-code
[tutorial]: http://www.raywenderlich.com/tag/tutorial
[Add a comment]: http://www.raywenderlich.com/forums//posting.php?mode=reply&f=20&t=6843