ASIHTTPRequest系列(一)：同步和异步请求

ASIHTTPRequest项目地址： http://github.com/pokeb/asi-http-request/tree ，关于ASIHTTPRequest到底是什么，你可以在项目首页看到。

它提供如下功能：

提交数据到web服务器或者从web服务器获得数据；

下载数据到内存或磁盘；

采用html input相同的机制上传文件；

断点续传；

简单存取HTTP头；

上传／下载进度显示；

支持Cookie；

后台运行（iOS4.0以上支持）；

对于请求和响应的GZIP支持；

支持客户端证书；

支持同步／异步请求

⋯⋯

关于它的介绍网上已经有很多了，该项目有很详细的指南文档： How to use ASIHTTPRequest ，也有网友翻译成中文了。本文没有完全照搬官方文档的内容，而是着重介绍了几个常见的应用，并涵盖了一些自己的理解和实际应用经验，包括：

安装、简单异步/同步请求、队列请求、上传、下载及 Cookies

注意，虽然这些技术在本文中是分开讲述的，但在实际工作中，往往是多种技术结合应用的。

此外，Http 请求往往伴随着 XML 技术的应用，实际上 ASIHTTPRequest 是可以和 SAX 异步解析结合应用的，这部分内容请参考作者另一博文《 ASIHTTPRequest和libxml结合，实现边请求边解析》。

项目下载地址： http://github.com/pokeb/asi-http-request/tarball/master

下载后将文件解压缩到任意目录。

打开该目录，其目录中包含了：

一个iPhone Xcode项目（源文件）

一个Mac Xcode项目（源文件）

一个iPhone下使用的Sample Code（源文件）

一个Mac下使用的Sample Code（源文件）

一个Readme.texttile，关于该项目的介绍

其实所有的内容都在其中了，如果你是初学者，不知到怎么下手，可以看 http://allseeing-i.com/ASIHTTPRequest/How-to-use

这里有一份详细的入门指南。

现在，我们要做的就是，在自己的项目中使用它。

一、在项目中使用ASIHTTPRequest

1、拷贝源文件到项目中

ASIHTTPRequest 是一个开源项目，要使用他，直接拷贝项目源文件到你的项目中，包括下列文件（即Classes下所有文件和External/Reachability下所有文件）：

• ASIHTTPRequestConfig.h
• ASIHTTPRequestDelegate.h
• ASIProgressDelegate.h
• ASICacheDelegate.h
• ASIHTTPRequest.h
• ASIHTTPRequest.m
• ASIDataCompressor.h
• ASIDataCompressor.m
• ASIDataDecompressor.h
• ASIDataDecompressor.m
• ASIFormDataRequest.h
• ASIInputStream.h
• ASIInputStream.m
• ASIFormDataRequest.m
• ASINetworkQueue.h
• ASINetworkQueue.m
• ASIDownloadCache.h
• ASIDownloadCache.m

对于 iPhone，还要拷贝下列文件：

• ASIAuthenticationDialog.h
• ASIAuthenticationDialog.m
• Reachability.h (External/Reachability 目录 )
• Reachability.m (External/Reachability 目录 )

2、添加依赖库

ASIHTTPRequest 依赖于以下5个框架或库：

CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics 和 libz1.2.3。

依次将上述库和框架添加到 target 的 Linked Libraries 中。

二、简单的同步请求示例

新建 iOS 项目，加入必需的源文件和 Linked Libraries。

往 MainWindow.xib 中添加一个 UIView和一个 UIButton，在 delegate 中添加相应的出口并在IB中进行连接。

编写按钮的Touch up inside代码，并连接到UIButton：

-( IBAction )goURL{

NSURL *url = [ NSURL URLWithString : @"http://localhost/interface/GetDept" ];

// 构造 ASIHTTPRequest 对象

ASIHTTPRequest *request = [ ASIHTTPRequest requestWithURL :url];

// 开始同步请求

[request startSynchronous ];

NSError *error = [request error ];

assert (!error);

// 如果请求成功，返回 Response

NSString *response = [request responseString ];

NSLog ( @"%@" ,response);

}

别忘了在适当的地方导入ASIHTTPRequest： #import "ASIHTTPRequest.h"

分别保存IB和Xcode中所做的更改， ⌘+B 编译。

三、简单的异步请求示例

将上述代码修改为：

-( IBAction )goURL{

NSURL *url = [ NSURL URLWithString : @"http://localhost/interface/GetDept" ];

ASIHTTPRequest *request = [ ASIHTTPRequest requestWithURL :url];

// 设定委托，委托自己实现异步请求方法

[request setDelegate : self ];

// 开始异步请求

[request startAsynchronous ];

}

并实现一系列委托方法：

// 请求结束，获取 Response 数据

- ( void )requestFinished:( ASIHTTPRequest *)request

{

NSString *responseString = [request responseString ]; // 对于 2 进制数据，使用： NSData *responseData = [request responseData];

NSLog ( @"%@" ,responseString);

button . enabled = YES ;

}

// 请求失败，获取 error

- ( void )requestFailed:( ASIHTTPRequest *)request

{

NSError *error = [request error ];

NSLog ( @"%@" ,error. userInfo );

button . enabled = YES ;

}

从OS X 10.6及iOS 4.0起，支持块语法，你也可以使用块语法调用ASIHTTPRequest：

-( IBAction )goURL{

NSURL *url = [ NSURL URLWithString : @"http://localhost/interface/GetDept" ];

__block ASIHTTPRequest *request = [ ASIHTTPRequest requestWithURL :url];

// ASIHTTPRequest 支持 iOS 4.0 的块语法，你可以把委托方法定义到块中

[request setCompletionBlock :^{

// 请求响应结束，返回 responseString

NSString *responseString = [request responseString ]; // 对于 2 进制数据，使用 NSData 返回 NSData *responseData = [request responseData];

NSLog ( @"%@" ,responseString);

}];

[request setFailedBlock :^{

// 请求响应失败，返回错误信息

NSError *error = [request error ];

NSLog ( @"error:%@" ,[error userInfo ]);

}];

[request startAsynchronous ];

}

如果你不熟悉O-C的块语法，请参考作者另一篇博文 《块编程指南》 ，或者Apple Reference Library。