开源中国iOS客户端学习——(五)网络通讯ASI类库(1)

现在的应用大部分基予网络，在开源中国iOS客户端源码中关于网络通讯方面用了三个类库，ASI和AFNetworking，还有一个苹果官方给出的Reachability用于检测当前网络情况，本文介绍当前用的比较多的ASI类库；

ASIHTTPRequest简称ASI,它是对CFNetwork API进行封装，使在与web服务器通讯时的繁琐步骤变得容易一些。它是使用Objective-C 编写，可以很好的用在Mac OS X和iPhone应用程序中；它适用于执行基本的HTTP请求和交互基于 REST的服务(GET / POST / PUT /DELETE)互交。

ASIHTTPRequest下载 https://github.com/pokeb/asi-http-request/tree

关于ASI类库介绍在  http://allseeing-i.com/ASIHTTPRequest/

添加ASI到你工程中步骤 http://allseeing-i.com/ASIHTTPRequest/Setup-instructions

ASI特色

l经过简单的接口，便可完成向服务端提交数据和从服务端获取数据的工做 

l下载的数据，可存储到内存中或直接存储到磁盘中 

l能上传本地文件到服务端 

l能够方便的访问和操做请求和返回的Http头信息 

l能够获取到上传或下载的进度信息，为应用程序提供更好的体验 

l支持上传或下载队列，而且可获取队列的进度信息 

l支持基本、摘要和NTLM身份认证，在同一会话中受权凭证会自动维持，而且能够存储在Keychain（Mac和iOS操做    系统的密码管理系统）中 

l 支持Cookie 

l当应用（iOS4+）在后台运行时，请求能够继续运行 

l 支持GZIP压缩数据 

l内置的ASIDownloadCache类，能够缓存请求返回的数据，这样即便没有网络也能够返回已经缓存的数据结果 

l ASIWebPageRequest –能够下载完整的网页，包括包含的网页、样式表、脚本等资源文件，并显示在UIWebView  /WebView中。任意大小的页面均可以无限期缓存，这样即便没有网络也能够离线浏览 

l支持客户端证书 

l支持经过代理发起Http请求 

l支持带宽限制。在iOS平台，能够根据当前网络状况来自动决定是否限制带宽，例如当使  用WWAN(GPRS/Edge/3G)网络时限制，而当使用WIFI时不作任何限制 

l支持断点续传 

l支持同步和异步请

ASI类库里包括22个文件，4个主要的类ASIHTTPRequest 、ASIFormDataRequest、ASINetworkQueue、ASIDownloadCache，5个支持的类ASIInputStream、ASIDataDecompressor、ASIDataCompressor、ASIAuthenticationDialog、Reachability，4个协议配置文件ASIHTTPRequestDelegate、ASIProgressDelegate、ASICacheDelegate、ASIHTTPRequestConfig.h，这些文件做用在开发文档中都有详细介绍.

在http://allseeing-i.com/ASIHTTPRequest/How-to-use有关于初次接触ASI的简单使用，颇有必要看一看，

了解简单的同步请求、异步请求，block块请求，队列请求等其余用法。

用ASI写的一个简单请求数据的Demo:

测试使用的URL是国家气象局API，返回一个json数据

#define URL @"http://www.weather.com.cn/data/sk/101010100.html"

    

请求获得数据:

1. //同步请求  
2. - (IBAction)synchronization_bt:(id)sender {  
3.       
4.     NSURL *url = [NSURL URLWithString:URL];  
5.     ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];  
6. //    启动同步方式访问  
7.     [request startSynchronous];  
8.       
9.     NSError *error = [request error];  
10. //    请求成功  
11.     if (!error) {  
12.         NSString *response = [request responseString];  
13.         NSLog(@"请求数据:%@",response);   
14.     }  
15.     }  
16.       
17. }  

1. //异步请求  
2. - (IBAction)asynchronous_bt:(id)sender {  
3.     NSURL *url = [NSURL URLWithString:URL];  
4.     ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];  
5.     [request setDelegate:self];  
6. //    启动异步方式访问  
7.     [request startAsynchronous];  
8. }  
9.   
10.   
11. //异步请求Delegate Methods  
12. -(void)requestFinished:(ASIHTTPRequest *)request  
13. {  
14.     NSString *responseString = [request responseString];  
15.     NSLog(@"请求的String数据:%@",responseString);  
16. //   以 二进制文件形式存储  
17.     NSData *responseData = [request responseData];  
18.     NSLog(@"请求的Data数据:%@",responseData);  
19.       
20. }  
21. -(void)requestFailed:(ASIHTTPRequest *)request  
22. {  
23.     NSError *error = [request error];  
24.     NSLog(@"Error:%@",error.userInfo);  
25.   
26. }  

1. //block块请求  
2. - (IBAction)blocks_tn:(id)sender {  
3.     NSURL *url = [NSURL URLWithString:URL];  
4.     __block ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];  
5.     [request setCompletionBlock:^{  
6.         NSString *responseString = [request responseString];  
7.         NSLog(@"请求的String数据:%@",responseString);  
8.           
9.     }];  
10.     [request setFailedBlock:^{  
11.         NSError *error = [request error];  
12.          NSLog(@"Error:%@",error.userInfo);  
13.     }];  
14.     [request startAsynchronous];  
15. }  

1. //队列请求  
2. - (IBAction)queue_bt:(id)sender {  
3.       
4.     if (![self queue]) {  
5.         [self setQueue:[[[NSOperationQueue alloc]init]autorelease]];  
6.     }  
7.     NSURL *url = [NSURL URLWithString:URL];  
8.     ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];  
9.     [request setDelegate:self];  
10.     [request setDidFinishSelector:@selector(requestDone:)];  
11.     [request setDidFailSelector:@selector(requestWentWrong:)];  
12.     [[self queue] addOperation:request];  
13. }  
14.   
15. -(void)requestDone:(ASIHTTPRequest *)request  
16. {  
17.     NSString *response = [request responseString];  
18.     NSLog(@"请求的数据:%@",response);  
19. }  
20.   
21. -(void)requestWentWrong:(ASIHTTPRequest *)request  
22. {  
23.     NSError *error = [request error];  
24.     NSLog(@"Error:%@",error.userInfo);  
25. }  

将类库加入到工程中不要忘了添加支持的framework框架和库：

SystemConfiguration.framework, MobileCoreServices.framework, CoreGraphics.framework 和 libz.dylib.

源代码:http://download.csdn.net/detail/duxinfeng2010/4947729

ASIHTTPRequest中文文档：

 http://www.dreamingwish.com/dream-2011/apples-third-party-development-libraries-asihttprequest.html

正在学习过程当中，错误之处请指正，欢迎交流，共同窗习；