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。

转载:http://blog.csdn.net/kmyhy/article/details/6524893

你可能感兴趣的:(ASIHTTPRequest系列(一):同步和异步请求)