上一篇文章介绍了优秀的第三方网络请求框架AFNETWorking2.0，本篇就通过一个实战例子来总结AFNetworking的使用。
本文参考http://www.raywenderlich.com/59255/afnetworking-2-0-tutorial#comments的例子。英文好的可以阅读看看，我觉得太啰嗦了。不利于抓住要点，本文就是它的提炼中文版。
一、准备工作
1.下载初始程序项目，地址：http://pan.baidu.com/s/1sj3SNeP。因为本文专注于使用AFNETWorking2.0请求网络数据，所以一些其他工作已经做好，您可以下载下来熟悉一下。
2.最终程序，地址：http://pan.baidu.com/s/1gdjo2hd。这是我在完成本教程后的最终程序效果。
3.查看本程序请求的服务器返回的数据格式：
JSON:http://www.raywenderlich.com/demos/weather_sample/weather.php?format=json
XML:http://www.raywenderlich.com/demos/weather_sample/weather.php?format=xml
PLIST:http://www.raywenderlich.com/demos/weather_sample/weather.php?format=plist (部分浏览器显示不正确)
二、实战
实战1.通过AFNetworkReachabilityManager 可以用来检测网络状态的变化
1.找到WTTableViewController.m文件，在viewDidLoad:方法下面添加一个新方法netWorkMonitor。
#pragma mark - 监控网络
- (void)netWorkMonitor
{
/*知识点1:
通过AFNetworkReachabilityManager 可以用来检测网络状态的变化 */
AFNetworkReachabilityManager *reachManager = [AFNetworkReachabilityManager sharedManager];
[reachManager startMonitoring];
[reachManager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
switch (status) {
case AFNetworkReachabilityStatusUnknown: {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"网络状态"
message:@"网络异常"
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
break;
}
case AFNetworkReachabilityStatusNotReachable: {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"网络状态"
message:@"网络未连接"
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
break;
}
case AFNetworkReachabilityStatusReachableViaWWAN: {
self.title = @"WWAN连接";
break;
}
case AFNetworkReachabilityStatusReachableViaWiFi: {
self.title = @"WIFI连接";
break;
}
default: {
break;
}
}
}];
}
netWorkMonitor方法
2.在viewDidLoad:方法的self.navigationController.toolbarHidden = NO;下面一行调用此方法：
//检测网络状态
[self netWorkMonitor];
3.然后在真机上运行，然后切换WiFi、WWAN或者飞行模式看看效果把。
实战2：通过AFHTTPRequestOperation来请求JSON,XML和PLIST格式的服务器响应数据
1.找到WTTableViewController.m文件，使WTTableViewController类继承NSXMLParserDelegate代理，用于XML解析。代码如下：
@interface WTTableViewController ()<NSXMLParserDelegate,CLLocationManagerDelegate>
2.替换中WTTableViewController.m文件中的的jsonTapped：，plistTapped：，xmlTapped：方法，将他们替换成如下代码：
#pragma mark - AFHTTPRequestOperation相关
/*知识点2：AFHTTPRequestOperation 继承自 AFURLConnectionOperation，使用HTTP以及HTTPS协议来处理网络请求。它封装成了一个可以令人接受的代码形式。当然AFHTTPRequestOperationManager 目前是最好的用来处理网络请求的方式，但AFHTTPRequestOperation 也有它自己的用武之地。*/
//json数据
- (IBAction)jsonTapped:(id)sender
{
// 创建请求的URL，然后创建NSURLRequest
NSString *string = [NSString stringWithFormat:@"%@weather.php?format=json", BaseURLString];
NSURL *url = [NSURL URLWithString:string];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 利用AFHTTPRequestOperation处理网络请求
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
//使用JSON序列化
operation.responseSerializer = [AFJSONResponseSerializer serializer];
//请求成功处理返回json数据，自动转为字典类型；请求失败弹出提示
[operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
// 3将返回数据序列化，返回的字典赋值给属性weather
self.weather = (NSDictionary *)responseObject;
self.title = @"获取到JSON";
[self.tableView reloadData];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
// 失败提示
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"获取天气信息失败"
message:[error localizedDescription]
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
}];
[operation start];
}
//plist数据
- (IBAction)plistTapped:(id)sender
{
NSString *string = [NSString stringWithFormat:@"%@weather.php?format=plist", BaseURLString];
NSURL *url = [NSURL URLWithString:string];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
// 解析plist就必须设置序列化对象为AFPropertyListResponseSerializer
operation.responseSerializer = [AFPropertyListResponseSerializer serializer];
[operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
self.weather = (NSDictionary *)responseObject;
self.title = @"获取到PLIST";
[self.tableView reloadData];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"获取天气信息失败"
message:[error localizedDescription]
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
}];
[operation start];
}
//xml数据
- (IBAction)xmlTapped:(id)sender
{
NSString *string = [NSString stringWithFormat:@"%@weather.php?format=xml", BaseURLString];
NSURL *url = [NSURL URLWithString:string];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
// Make sure to set the responseSerializer correctly
operation.responseSerializer = [AFXMLParserResponseSerializer serializer];
[operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
NSXMLParser *XMLParser = (NSXMLParser *)responseObject;
[XMLParser setShouldProcessNamespaces:YES];
//解析XML数据要复杂许多，参考代理实现
XMLParser.delegate = self;
[XMLParser parse];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"获取天气信息失败"
message:[error localizedDescription]
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
}];
[operation start];
}
#pragma mark - NSXMLParserDelegate
//开始解析
- (void)parserDidStartDocument:(NSXMLParser *)parser
{
self.xmlWeather = [NSMutableDictionary dictionary];
}
//找到新标签解析
- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary<NSString *,NSString *> *)attributeDict
{
self.elementName = qName;
if([qName isEqualToString:@"current_condition"] ||
[qName isEqualToString:@"weather"] ||
[qName isEqualToString:@"request"]) {
self.currentDictionary = [NSMutableDictionary dictionary];
}
self.outstring = [NSMutableString string];
}
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string
{
if (!self.elementName)
return;
[self.outstring appendFormat:@"%@", string];
}
- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName
{
if ([qName isEqualToString:@"current_condition"] ||
[qName isEqualToString:@"request"]) {
self.xmlWeather[qName] = @[self.currentDictionary];
self.currentDictionary = nil;
}
else if ([qName isEqualToString:@"weather"]) {
// Initialize the list of weather items if it doesn't exist
NSMutableArray *array = self.xmlWeather[@"weather"] ?: [NSMutableArray array];
// Add the current weather object
[array addObject:self.currentDictionary];
// Set the new array to the "weather" key on xmlWeather dictionary
self.xmlWeather[@"weather"] = array;
self.currentDictionary = nil;
}
else if ([qName isEqualToString:@"value"]) {
// Ignore value tags, they only appear in the two conditions below
}
else if ([qName isEqualToString:@"weatherDesc"] ||
[qName isEqualToString:@"weatherIconUrl"]) {
NSDictionary *dictionary = @{@"value": self.outstring};
NSArray *array = @[dictionary];
self.currentDictionary[qName] = array;
}
else if (qName) {
self.currentDictionary[qName] = self.outstring;
}
self.elementName = nil;
}
- (void)parserDidEndDocument:(NSXMLParser *)parser
{
self.weather = @{@"data": self.xmlWeather};
self.title = @"XML Retrieved";
[self.tableView reloadData];
}
AFHTTPRequestOperation
3.然后你在运行，点击JSON,XML或者PLIST按钮看看效果。我的APP效果如图：
实战3：使用AFHTTPSessionManager方法实现GET和POST请求
1.找到找到WTTableViewController.m文件中的clientTapped：方法，给它添加一个弹出菜单选择GET和Post请求，替换代码如下：
/*知识点3：AFHTTPSessionManager
iOS7之后，使用AFHTTPSessionManager
iOS6之后，使用AFHTTPRequestOperationManager
使用方便，只要我们设置一个服务器的URL地址，在设置请求参数字典
GET 和 POST请求 使用基本相同，这是AFNetworking牛逼的地方，都帮我们封装好了参数
*/
- (IBAction)clientTapped:(id)sender
{
//弹出菜单
UIActionSheet *actionSheet = [[UIActionSheet alloc] initWithTitle:@"AFHTTPSessionManager"
delegate:self
cancelButtonTitle:@"取消"
destructiveButtonTitle:nil
otherButtonTitles:@"HTTP GET", @"HTTP POST", nil];
[actionSheet showFromBarButtonItem:sender animated:YES];
clientTapped：
2.然后WTTableViewControlle类继承UIActionSheetDelegate。
@interface WTTableViewController ()<NSXMLParserDelegate,CLLocationManagerDelegate,UIActionSheetDelegate>
3.实现代理方法，在上面代码下面添加actionSheet:clickedButtonAtIndex:代理方法：
#pragma mark - UIActionSheetDelegate
- (void)actionSheet:(UIActionSheet *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex
{
if (buttonIndex == [actionSheet cancelButtonIndex]) {
// User pressed cancel -- abort
return;
}
// 设置请求URL和请求参数
NSURL *baseURL = [NSURL URLWithString:BaseURLString];
NSDictionary *parameters = @{@"format":@"json"};
// 初始化AFHTTPSessionManager对象，并设置JSON序列化
AFHTTPSessionManager *manager = [[AFHTTPSessionManager alloc] initWithBaseURL:baseURL];
manager.responseSerializer = [AFJSONResponseSerializer serializer];
// GET请求方式
) {
[manager GET:@"weather.php" parameters:parameters success:^(NSURLSessionDataTask *task, id responseObject) {
self.weather = responseObject;
self.title = @"HTTP GET";
[self.tableView reloadData];
} failure:^(NSURLSessionDataTask *task, NSError *error) {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"获取天气信息失败"
message:[error localizedDescription]
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
}];
}
// POST请求方式
) {
[manager POST:@"weather.php" parameters:parameters success:^(NSURLSessionDataTask *task, id responseObject) {
self.weather = responseObject;
self.title = @"HTTP POST";
[self.tableView reloadData];
} failure:^(NSURLSessionDataTask *task, NSError *error) {
UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"获取天气信息失败"
message:[error localizedDescription]
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles:nil];
[alertView show];
}];
}
}
UIActionSheetDelegate
4.运行看看效果，当我们点击请求方式，会弹出选择菜单，我们选择任意一种请求方式，都能得到我们的天气数据：
实战3：使用AFHTTPSessionManager获取实时数据
使用AFHTTPSessionManager获取服务器数据，建议封装网络层。 1.为每一个网络服务创建一个AFHTTPSessionManager的子类 2.在每个子类中，创建一个单例方法。3.在该类中请求网络数据。
1.新建WeatherHTTPClient类，使其继承AFHTTPSessionManager。类的实现代码如下：
WeatherHTTPClient.h文件
#import "AFHTTPSessionManager.h" @protocol WeatherHTTPClientDelegate; /** * 封装网络请求 */ @interface WeatherHTTPClient : AFHTTPSessionManager @property (nonatomic, weak) id<WeatherHTTPClientDelegate>delegate; /** * 单例方法 * * @return 返回当前对象 */ + (WeatherHTTPClient *)sharedWeatherHTTPClient; /** * 初始化对象 * * @param url 请求的URL * * @return 返回当前对象 */ - (instancetype)initWithBaseURL:(NSURL *)url; /** * 根据地理位置以及天数，来请求服务器多少天的该地理位置的天气数据 * * @param location 地理位置 * @param number 天数 */ - (void)updateWeatherAtLocation:(CLLocation *)location forNumberOfDays:(NSUInteger)number; @end /** * 协议，用于代理回调 */ @protocol WeatherHTTPClientDelegate <NSObject> @optional - (void)weatherHTTPClient:(WeatherHTTPClient *)client didUpdateWithWeather:(id)weahter; - (void)weatherHTTPClient:(WeatherHTTPClient *)client didFailWithError:(NSError *)error; @end
WeatherHTTPClient.h
WeatherHTTPClient.m文件
#import "WeatherHTTPClient.h"
/**
这里我们用到的实时数据来自World Weather Online的实时天气数据,您可以使用我这个API进行测试，不过建议您自己注册一个API，注册地址：https://developer.worldweatheronline.com/member/register
注册用户，然后验证邮箱，然后注册APP，你可以注册Free-Weather-API-V2和Premium-Weather-API
不过访问的地址Base URL不同：
Free API:
HTTP: http://api.worldweatheronline.com/free/v2/weather.ashx
HTTPS: https://api.worldweatheronline.com/free/v2/weather.ashx
Premium API:
HTTP: http://api.worldweatheronline.com/premium/v1/weather.ashx
HTTPS: https://api.worldweatheronline.com/premium/v1/weather.ashx
查看API文档
http://www.worldweatheronline.com/api/docs/local-city-town-weather-api.aspx
*/
static NSString * const WorldWeatherOnlineAPIKey = @"cb0e4506e3590fdd85bbd9b2a9fc8";
static NSString * const WorldWeatherOnlineURLString = @"http://api.worldweatheronline.com/free/v2/";
@implementation WeatherHTTPClient
//单例
+ (WeatherHTTPClient *)sharedWeatherHTTPClient
{
static WeatherHTTPClient *_sharedWeatherHTTPClient = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_sharedWeatherHTTPClient = [[self alloc] initWithBaseURL:[NSURL URLWithString:WorldWeatherOnlineURLString]];
});
return _sharedWeatherHTTPClient;
}
//根据URL初始化，并默认为JSON序列化
- (instancetype)initWithBaseURL:(NSURL *)url
{
self = [super initWithBaseURL:url];
if (self) {
self.responseSerializer = [AFJSONResponseSerializer serializer];
self.requestSerializer = [AFJSONRequestSerializer serializer];
}
return self;
}
- (void)updateWeatherAtLocation:(CLLocation *)location forNumberOfDays:(NSUInteger)number
{
NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
parameters[@"num_of_days"] = @(number);
parameters[@"q"] = [NSString stringWithFormat:@"%f,%f",location.coordinate.latitude,location.coordinate.longitude];
parameters[@"format"] = @"json";
parameters[@"key"] = WorldWeatherOnlineAPIKey;
[self GET:@"weather.ashx" parameters:parameters success:^(NSURLSessionDataTask *task, id responseObject) {
if ([self.delegate respondsToSelector:@selector(weatherHTTPClient:didUpdateWithWeather:)]) {
[self.delegate weatherHTTPClient:self didUpdateWithWeather:responseObject];
}
} failure:^(NSURLSessionDataTask *task, NSError *error) {
if ([self.delegate respondsToSelector:@selector(weatherHTTPClient:didFailWithError:)]) {
[self.delegate weatherHTTPClient:self didFailWithError:error];
}
}];
}
@end
WeatherHTTPClient.m
2.在WTTableViewController.m文件中找到locationManager:didUpdateLocations:方法，替换成如下代码：
#pragma mark - CLLocationManagerDelegate
- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations
{
// 获取最新的位置信息
CLLocation *newLocation = [locations lastObject];
// 如果新位置在5分钟之前就不更新
)
return;
//获取到新位置就停止更新
[self.locationManager stopUpdatingLocation];
/*知识5：使用AFHTTPSessionManager的建议：封装网络层请求
1.为每一个网络服务创建一个AFHTTPSessionManager的子类
2.在每个子类中，创建一个单例方法
*/
WeatherHTTPClient *client = [WeatherHTTPClient sharedWeatherHTTPClient];
client.delegate = self;
[client updateWeatherAtLocation:newLocation forNumberOfDays:];
}
CLLocationManagerDelegate
3.然后我们运行（最好在真机运行，模拟器可能获取不到经纬度信息），点击“本地天气”按钮，这是我的效果，北京又是个大雾霾天。希望您那的天气很美好。
实战4.利用AFNetworkActivityIndicatorManager显示加载提示
我们现在已经可以利用AFNetworling2.0的类轻易获取到数据，可是，在加载数据的时候，如果网络慢的情况下，用户并不知道发生了什么，这样子的用户体验不太好不是吗，所以我们需要提示用户正在请求数据，AFNetworking已经为我们考虑了这些，而且使用很方便。
1.打开WTAppDelegate.m文件，找到application:didFinishLaunchingWithOptions:方法，在返回前添加如下代码：
/*知识点4：AFNetworkActivityIndicatorManager让我们很容易的指导网络是否在请求，如果在向网络请求数据就会在状态来出现一个旋转的提示，如果请求结束或者无请求，提示消失，使用方便简单*/
[AFNetworkActivityIndicatorManager sharedManager].enabled = YES;
2.OK,这么多就够了。我运行看看吧，注意下状态栏，在我们选择JSON,XML或PLIST等按钮时，会出现一个加载提示，当数据获取后，加载提示又会消失。
实战5.使用AFImageResponseSerializer序列化图片数据
从服务器返回的数据会有各种类型，有JOSN,XML,PLIST等，有时候也会直接获取一张图片，这时候苹果原生技术职能用NSData的方式获取数据，然后再转换数据，而AFNetwroking确可以直接序列化图片数据，一个小技巧而已。
1.找到WeatherAnimationViewController.m文件，找到updateBackgroundImage：方法，替换为如下代码：
- (IBAction)updateBackgroundImage:(id)sender
{
NSURL *url = [NSURL URLWithString:@"http://www.raywenderlich.com/wp-content/uploads/2014/01/sunny-background.png"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
//设置为图片序列化方式，如果我们确定获取到的数据为图片，就可以这么做
operation.responseSerializer = [AFImageResponseSerializer serializer];
[operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
self.backgroundImageView.image = responseObject;
[self saveImage:responseObject withFilename:@"background.png"];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"Error: %@", error);
}];
[operation start];
}
updateBackgroundImage：
2.找到deleteBackgroundImage：方法，替换为如下代码：
- (IBAction)deleteBackgroundImage:(id)sender
{
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *path = [[paths objectAtIndex:] stringByAppendingPathComponent:@"WeatherHTTPClientImages/"];
NSError *error = nil;
[[NSFileManager defaultManager] removeItemAtPath:path error:&error];
NSString *desc = [self.weatherDictionary weatherDescription];
[self start:desc];
}
3.这个方法会删除我们刚刚更新的背景图片。我们可以再次运行看看，测试下更新背景图和删除按钮把。
自此我们的实战就算完成了。辛苦各位亲了，不过再麻烦大家耐心一点，我们花一点点的时间，来总结一下如何利用AFNetworking来请求外部网络数据：
1.我们可以使用AFNetworkReachabilityManager来监控网络状态的变化，如WiFi，WWAN，或者关闭网络等状态。
2.我们可以使用AFHTTPOperation配合AFJSONResponseSerializer、AFPropertyListResponseSerializer、AFXMLParserResponseSerializer、AFImageResponseSerializer等序列化方式，请求网络数据。
3.我们可以使用AFNetworkActivityIndicatorManager，在网络请求时，给用户友好的请求提示显示。
4.我们AFHTTPSessionManager为网络请求设置参数，根据需要更改请求参数，从而实时的请求数据。
谢谢各位亲。