转载自:http://blog.csdn.net/duxinfeng2010/article/details/8620901
AFNetworking是一个轻量级的iOS网络通信类库,继ASI类库不在更新之后开发者们有一套不错选择;
AFNetworking类库源码下载和使用教程: https://github.com/AFNetworking/AFNetworking
如果想深入研究有官方文档介绍:http://afnetworking.github.com/AFNetworking/
在开源中国iOS客户端中关于AFNetworking类库的使用只用到了两个实例方法
(1)getPath:parameters:success:failure:
(2)postPath:parameters:success:failure:
他们用法基本相同,只是请求数据方式不同,一种是Get请求和Post请求。Get是向服务器发索取数据的一种请求,也就相当于查询信息功能,不会修改类容,Post是向服务器提交数据的一种请求,影响数据内容;两种方法定义:
- - (void)getPath:(NSString *)path
- parameters:(NSDictionary *)parameters
- success:(void (^)(AFHTTPRequestOperation *operation, id responseObject))success
- failure:(void (^)(AFHTTPRequestOperation *operation, NSError *error))failure
- {
- NSURLRequest *request = [self requestWithMethod:@"GET" path:path parameters:parameters];
- AFHTTPRequestOperation *operation = [self HTTPRequestOperationWithRequest:request success:success failure:failure];
- [self enqueueHTTPRequestOperation:operation];
- }
- - (void)postPath:(NSString *)path
- parameters:(NSDictionary *)parameters
- success:(void (^)(AFHTTPRequestOperation *operation, id responseObject))success
- failure:(void (^)(AFHTTPRequestOperation *operation, NSError *error))failure
- {
- NSURLRequest *request = [self requestWithMethod:@"POST" path:path parameters:parameters];
- AFHTTPRequestOperation *operation = [self HTTPRequestOperationWithRequest:request success:success failure:failure];
- [self enqueueHTTPRequestOperation:operation];
- }
getPath:parameters:success:failure:方法在程序中使用举例:
NewsView.m
- - (void)reload:(BOOL)noRefresh
- {
- //如果有网络连接
- if ([Config Instance].isNetworkRunning) {
- if (isLoading || isLoadOver) {
- return;
- }
- if (!noRefresh) {
- allCount = 0;
- }
- int pageIndex = allCount/20;
- NSString *url;
- switch (self.catalog) {
- case 1:
- url = [NSString stringWithFormat:@"%@?catalog=%d&pageIndex=%d&pageSize=%d", api_news_list, 1, pageIndex, 20];
- break;
- case 2:
- url = [NSString stringWithFormat:@"%@?type=latest&pageIndex=%d&pageSize=%d", api_blog_list, pageIndex, 20];
- break;
- case 3:
- url = [NSString stringWithFormat:@"%@?type=recommend&pageIndex=%d&pageSize=%d", api_blog_list, pageIndex, 20];
- break;
- }
- [[AFOSCClient sharedClient]getPath:url parameters:Nil
- success:^(AFHTTPRequestOperation *operation, id responseObject) {
- [Tool getOSCNotice2:operation.responseString];
- isLoading = NO;
- if (!noRefresh) {
- [self clear];
- }
- @try {
- NSMutableArray *newNews = self.catalog <= 1 ?
- [Tool readStrNewsArray:operation.responseString andOld: news]:
- [Tool readStrUserBlogsArray:operation.responseString andOld: news];
- int count = [Tool isListOver2:operation.responseString];
- allCount += count;
- if (count < 20)
- {
- isLoadOver = YES;
- }
- [news addObjectsFromArray:newNews];
- [self.tableNews reloadData];
- [self doneLoadingTableViewData];
- //如果是第一页 则缓存下来
- if (news.count <= 20) {
- [Tool saveCache:5 andID:self.catalog andString:operation.responseString];
- }
- }
- @catch (NSException *exception) {
- [NdUncaughtExceptionHandler TakeException:exception];
- }
- @finally {
- [self doneLoadingTableViewData];
- }
- } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
- NSLog(@"新闻列表获取出错");
- //如果是刷新
- [self doneLoadingTableViewData];
- if ([Config Instance].isNetworkRunning == NO) {
- return;
- }
- isLoading = NO;
- if ([Config Instance].isNetworkRunning) {
- [Tool ToastNotification:@"错误 网络无连接" andView:self.view andLoading:NO andIsBottom:NO];
- }
- }];
- isLoading = YES;
- [self.tableNews reloadData];
- }
- //如果没有网络连接
- else
- {
- NSString *value = [Tool getCache:5 andID:self.catalog];
- if (value) {
- NSMutableArray *newNews = [Tool readStrNewsArray:value andOld:news];
- [self.tableNews reloadData];
- isLoadOver = YES;
- [news addObjectsFromArray:newNews];
- [self.tableNews reloadData];
- [self doneLoadingTableViewData];
- }
- }
- }
分析一下这里面的代码:
首先是做一个网络连接判断,在开源中国iOS客户端学习——(六)网络连接检测一文中介绍了,作者并不是用这种方法来判断,而是使用getPath:parameters:success:failure:来判断网络的连接,方法使用AFHTTPRequestOperation和“PATCH”请求HTTP客户端操作队列,使用到了block块(iOS 4.0+特性),URL请求成功执行success块里操作,这里面block块没有返回值,接受两个参数,创建请求操作和响应数据请求,URL请求失败执行failure里面的方法,这个block块里仍没有返回值,接受两个参数创建请求操作和NSError对象,描述网络或解析错误状况;
在 if()中的方法[Config Instance].isNetworkRunning==YES的,如果程序加载或者已经加载完毕什么也不返回,如果程序没有加载数据,将数据列表数量显示为0,接下来是在switch()中,根据使用者选择设置不同API接口(下图),然后就是解析显示数据信息,显示在视图中;
在AFNetwork 文件夹中,作者自己添加了一个AFOSCClient类,该类继承AFHTTPClient,又设计了一个sharedClient的类方法,从返回的结果可以推测出它是通过API请求返回json类型的数据,具体什么作用还没看出来;
[Tool getOSCNotice2:operation.responseString];是封装在在Tool类中的解析获取的XML的文件
URL请求成功,还做了一个程序异常处理,防止请求数据过成功程序异常崩溃
关于@try @catch @finally异常处理的使用:
{
//执行的代码,其中可能有异常。一旦发现异常,则立即跳到catch执行。否则不会执行catch里面的内容
}
@catch
{
//除非try里面执行代码发生了异常,否则这里的代码不会执行
}
@finally
{
//不管什么情况都会执行,包括try catch 里面用了return ,可以理解为只要执行了try或者catch,就一定会执行 finally
}
如果URL请求的数据出错,则反应网络不连通,数据不能加载,则弹出GCDiscreetNotificationView提示视图 提示网络错误;
postPath:parameters:success:failure:方法在程序中使用举例:
FriendsView.m
- -(void)reload:(BOOL)noRefresh
- {
- if (isLoadOver) {
- [self doneLoadingTableViewData];
- return;
- }
- [[AFOSCClient sharedClient] postPath:api_friends_list
- parameters:[NSDictionary dictionaryWithObjectsAndKeys:segement.selectedSegmentIndex == 0 ? @"1" : @"0",@"relation",
- [NSString stringWithFormat:@"%d", friends.count/20],@"pageIndex",
- @"20",@"pageSize",
- [NSString stringWithFormat:@"%d", [Config Instance].getUID],@"uid",nil] success:^(AFHTTPRequestOperation *operation, id responseObject) {
- if (!noRefresh) {
- [self clear];
- }
- [self doneLoadingTableViewData];
- isLoading = NO;
- NSString *response = operation.responseString;
- [Tool getOSCNotice2:response];
- @try {
- TBXML *xml = [[TBXML alloc] initWithXMLString:response error:nil];
- TBXMLElement *root = xml.rootXMLElement;
- //显示
- TBXMLElement *_friends = [TBXML childElementNamed:@"friends" parentElement:root];
- if (!_friends) {
- isLoadOver = YES;
- [self.tableFriends reloadData];
- return;
- }
- TBXMLElement *first = [TBXML childElementNamed:@"friend" parentElement:_friends];
- if (first == nil) {
- [self.tableFriends reloadData];
- isLoadOver = YES;
- return;
- }
- NSMutableArray *newFriends = [[NSMutableArray alloc] initWithCapacity:20];
- TBXMLElement *name = [TBXML childElementNamed:@"name" parentElement:first];
- TBXMLElement *userid = [TBXML childElementNamed:@"userid" parentElement:first];
- TBXMLElement *portrait = [TBXML childElementNamed:@"portrait" parentElement:first];
- TBXMLElement *expertise = [TBXML childElementNamed:@"expertise" parentElement:first];
- TBXMLElement *gender = [TBXML childElementNamed:@"gender" parentElement:first];
- Friend *f = [[Friend alloc] initWithParameters:[TBXML textForElement:name] andUID:[[TBXML textForElement:userid] intValue] andPortrait:[TBXML textForElement:portrait] andExpertise:[TBXML textForElement:expertise] andMale:[[TBXML textForElement:gender] intValue] == 1];
- if (![Tool isRepeatFriend: friends andFriend:f]) {
- [newFriends addObject:f];
- }
- while (first) {
- first = [TBXML nextSiblingNamed:@"friend" searchFromElement:first];
- if (first) {
- name = [TBXML childElementNamed:@"name" parentElement:first];
- userid = [TBXML childElementNamed:@"userid" parentElement:first];
- portrait = [TBXML childElementNamed:@"portrait" parentElement:first];
- expertise = [TBXML childElementNamed:@"expertise" parentElement:first];
- gender = [TBXML childElementNamed:@"gender" parentElement:first];
- f = [[Friend alloc] initWithParameters:[TBXML textForElement:name] andUID:[[TBXML textForElement:userid] intValue] andPortrait:[TBXML textForElement:portrait] andExpertise:[TBXML textForElement:expertise] andMale:[[TBXML textForElement:gender] intValue] == 1];
- if (![Tool isRepeatFriend:friends andFriend:f]) {
- [newFriends addObject:f];
- }
- }
- else
- break;
- }
- if (newFriends.count < 20) {
- isLoadOver = YES;
- }
- [friends addObjectsFromArray:newFriends];
- [self.tableFriends reloadData];
- }
- @catch (NSException *exception) {
- [NdUncaughtExceptionHandler TakeException:exception];
- }
- @finally {
- [self doneLoadingTableViewData];
- }
- } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
- NSLog(@"好友列表获取出错");
- [self doneLoadingTableViewData];
- isLoading = NO;
- if ([Config Instance].isNetworkRunning) {
- [Tool ToastNotification:@"错误 网络无连接" andView:self.view andLoading:NO andIsBottom:NO];
- }
- }];
- isLoading = YES;
- [self.tableFriends reloadData];
- }
这个方法和getPath:parameters:success:failure:不同的在于请求方式是POST请求,可以向服务器里提交数据;