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。