ASIHTTPRequest对CFNetwork API进行了封装&＃xff0c;并且使用起来非常简单&＃xff0c;用Objective-C编写&＃xff0c;可以很好的应用在Mac OS X系统和iOS平台的应用程序中。ASIHTTPRequest适用于基本的HTTP请求&＃xff0c;和基于REST的服务之间的交互。

ASIHTTPRequest功能很强大&＃xff0c;主要特色如下&＃xff1a;

• l 通过简单的接口&＃xff0c;即可完成向服务端提交数据和从服务端获取数据的工作
• l 下载的数据&＃xff0c;可存储到内存中或直接存储到磁盘中
• l 能上传本地文件到服务端
• l 可以方便的访问和操作请求和返回的Http头信息
• l 可以获取到上传或下载的进度信息&＃xff0c;为应用程序提供更好的体验
• l 支持上传或下载队列&＃xff0c;并且可获取队列的进度信息
• l 支持基本、摘要和NTLM身份认证&＃xff0c;在同一会话中授权凭证会自动维持&＃xff0c;并且可以存储在Keychain&＃xff08;Mac和iOS操作系统的密码管理系统&＃xff09;中
• l 支持COOKIE
• l 当应用&＃xff08;iOS 4&＃43;&＃xff09;在后台运行时&＃xff0c;请求可以继续运行
• l 支持GZIP压缩数据
• l 内置的ASIDownloadCache类&＃xff0c;可以缓存请求返回的数据&＃xff0c;这样即使没有网络也可以返回已经缓存的数据结果
• l ASIWebPageRequest –可以下载完整的网页&＃xff0c;包括包含的网页、样式表、脚本等资源文件&＃xff0c;并显示在UIWebView /WebView中。任意大小的页面都可以无限期缓存&＃xff0c;这样即使没有网络也可以离线浏览
• l 支持客户端证书
• l 支持通过代理发起Http请求
• l 支持带宽限制。在iOS平台&＃xff0c;可以根据当前网络情况来自动决定是否限制带宽&＃xff0c;例如当使用WWAN(GPRS/Edge/3G)网络时限制&＃xff0c;而当使用WIFI时不做任何限制
• l 支持断点续传
• l 支持同步和异步请求

发起一个同步请求

同步意为着线程阻塞&＃xff0c;在主线程中使用此方法会使应用Hang住而不响应任何用户事件。所以&＃xff0c;在应用程序设计时&＃xff0c;大多被用在专门的子线程增加用户体验&＃xff0c;或用异步请求代替&＃xff08;下面会讲到&＃xff09;。

a, 用requestWithURL快捷方法获取ASIHTTPRequest的一个实例
b, startSynchronous 方法启动同步访问&＃xff0c;
c, 由于是同步请求&＃xff0c;没有基于事件的回调方法&＃xff0c;所以从request的error属性获取错误信息。
d, responseString&＃xff0c;为请求的返回NSString信息。

创建一个异步请求

异步请求的好处是不阻塞当前线程&＃xff0c;但相对于同步请求略为复杂&＃xff0c;至少要添加两个回调方法来获取异步事件。
下面异步请求代码完成上面同样的一件事情&＃xff1a;

a&＃xff0c;与上面不同的地方是指定了一个 "delegate"&＃xff0c;并用startAsynchronous来启动网络请求。
b&＃xff0c;在这里实现了两个delegate的方法&＃xff0c;当数据请求成功时会调用requestFinished&＃xff0c;请求失败时&＃xff08;如网络问题或服务器内部错误&＃xff09;会调用requestFailed。

队列请求

提供了一个对异步请求更加精准丰富的控制。
如&＃xff0c;可以设置在队列中&＃xff0c;同步请求的连接数。往队列里添加的请求实例数大于maxConcurrentOperationCount时&＃xff0c;请求实例将被置为等待&＃xff0c;直到前面至少有一个请求完成并出列才被放到队列里执行。
也适用于当我们有多个请求需求按顺序执行的时候&＃xff08;可能是业务上的需要&＃xff0c;也可能是软件上的调优&＃xff09;&＃xff0c;仅仅需要把maxConcurrentOperationCount设为“1”。

创建NSOperationQueue&＃xff0c;这个Cocoa架构的执行任务&＃xff08;NSOperation&＃xff09;的任务队列。我们通过ASIHTTPRequest.h的源码可以看到&＃xff0c;此类本身就是一个NSOperation的子类。也就是说它可以直接被放到"任务队列"中&＃xff0c;并被执行。上面的代码队了队列的创建与添加操作外&＃xff0c;其它代码与上一例一样。

请求队列上下文

a&＃xff0c;可以设置一个上下文&＃xff08;userInfo&＃xff09;到request对象中&＃xff0c;当请求响应完后可以通过访问request对象的userInfo获取里面的信息
b&＃xff0c;为每一个请求实例设置不同的setDidFinishSelector / setDidFailSelector的回调方法
c&＃xff0c;子类化ASIHTTPRequest&＃xff0c;重写requestFinished: 与 failWithProblem:方法

ASINetworkQueues,  它的delegate提供更为丰富的功能

提供的更多的回调方法如下&＃xff1a;
a&＃xff0c;requestDidStartSelector&＃xff0c;请求发起时会调此方法&＃xff0c;你可以在此方法中跟据业务选择性的设置request对象的deleaget。
b&＃xff0c;requestDidReceiveResponseHeadersSelector&＃xff0c;当接受完响应的Header后设计此方法&＃xff0c;这个对下载大数据的时候相当有用&＃xff0c;你可以在方法里做更多业务上的处理。
c&＃xff0c;requestDidFinishSelector&＃xff0c;请求并响应成功完成时调用此方法
d&＃xff0c;requestDidFailSelector&＃xff0c;请求失败
e&＃xff0c;queueDidFinishSelector&＃xff0c;整个队列里的所有请求都结束时调用此方法。

它是NSOperationQueues的扩展&＃xff0c;小而强大。但也与它的父类略有区别。如&＃xff0c;仅添加到队列中其实并不能执行请求&＃xff0c;只有调用[ queue g o]才会执行&＃xff1b;一个正在运行中的队列&＃xff0c;并不需要重复调用[ queue go ]。 默认情况下&＃xff0c;队列中的一个请求如果失败&＃xff0c;它会取消所有未完成的请求。可以设置[ queue setShouldCancelAllRequestsOnFailure:NO ]来修 正。

取消异步请求

首先&＃xff0c;同步请求是不能取消的。
其次&＃xff0c;不管是队列请求&＃xff0c;还是简单的异步请求&＃xff0c;全部调用[ request cancel ]来取消请求。

取消的请求默认都会按请求失败处理&＃xff0c;并调用请求失败delegate。 如果不想调用delegate方法&＃xff0c;则设置&＃xff1a;[ request clearDelegatesAndCancel];

队列请求中需要注意的是&＃xff0c;如果你取消了一个请求&＃xff0c;队列会自动取消其它所有请求。
如果只想取消一个请求&＃xff0c;可以设置队列&＃xff1a;[ queue setShouldCancelAllRequestsOnFailure:NO ];
如果想明确取消所有请求&＃xff1a;[ queue cancelAllOperations ];

安全的内存回收建议

request并没有retain你的delegate&＃xff0c;所以在没有请求完的时候释放了此delegate&＃xff0c;需要在dealloc方法里先取消所有请求&＃xff0c;再释放请求实例&＃xff0c;如&＃xff1a;

向服务器端上传数据

ASIFormDataRequest &＃xff0c;模拟 Form表单提交&＃xff0c;其提交格式与 Header会自动识别。
没有文件&＃xff1a;application/x-www-form-urlencoded
有文件&＃xff1a;multipart/form-data

如果要发送自定义数据&＃xff1a;

下载文件

通过设置request的setDownloadDestinationPath&＃xff0c;可以设置下载文件用的下载目标目录。
首先&＃xff0c;下载过程文件会保存在temporaryFileDownloadPath目录下。如果下载完成会做以下事情&＃xff1a;
1&＃xff0c;如果数据是压缩的&＃xff0c;进行解压&＃xff0c;并把文件放在downloadDestinationPath目录中&＃xff0c;临时文件被删除
2&＃xff0c;如果下载失败&＃xff0c;临时文件被直接移到downloadDestinationPath目录&＃xff0c;并替换同名文件。

如果你想获取下载中的所有数据&＃xff0c;可以实现delegate中的request:didReceiveData:方法。但如果你实现了这个方法&＃xff0c;request在下载完后&＃xff0c;request并不把文件放在downloadDestinationPath中&＃xff0c;需要手工处理。

获取响应信息

信息&＃xff1a;status , header, responseEncoding

获取请求进度

有两个回调方法可以获取请求进度&＃xff0c;
1&＃xff0c;downloadProgressDelegate&＃xff0c;可以获取下载进度
2&＃xff0c;uploadProgressDelegate&＃xff0c;可以获取上传进度

COOKIE的支持

如果COOKIE存在的话&＃xff0c;会把这些信息放在NSHTTPCOOKIEStorage容器中共享&＃xff0c;并供下次使用。
你可以用[ ASIHTTPRequest setSessionCOOKIEs:nil ] ; 清空所有COOKIEs。
当然&＃xff0c;你也可以取消默认的COOKIE策略&＃xff0c;而使自定义的COOKIE&＃xff1a;

大文件断点续传

0.94以后支持大文件的断点下载&＃xff0c;只需要设置&＃xff1a;
[ request setAllowResumeForFileDownloads:YES ];
[ request setDownloadDestinationPath:downloadPath ];
就可以了。

ASIHTTPRequest会自动保存访问过的&＃xff35;&＃xff32;&＃xff2c;信息&＃xff0c;并备之后用。在以下几个场景非常有用&＃xff1a;
1&＃xff0c;当没有网络连接的时候。
2&＃xff0c;已下载的数据再次请求时&＃xff0c;仅当它与本地版本不样时才进行下载。

ASIDownloadCache 设置下载缓存

它对Get请求的响应数据进行缓存&＃xff08;被缓存的数据必需是成功的200请求&＃xff09;&＃xff1a;

当设置缓存策略后&＃xff0c;所有的请求都被自动的缓存起来。
另外&＃xff0c;如果仅仅希望某次请求使用缓存操作&＃xff0c;也可以这样使用&＃xff1a;

多种的缓存并存

仅仅需要创建不同的ASIDownloadCache&＃xff0c;并设置缓存所使用的路径&＃xff0c;并设置到需要使用的request实例中&＃xff1a;

缓存策略

缓存策略是我们控制缓存行为的主要方式&＃xff0c;如&＃xff1a;什么时候进行缓存&＃xff0c;缓存数据的利用方式。
以下是策略可选列表&＃xff08;可组合使用&＃xff09;&＃xff1a;

如果设置了“defaultCachePolicy”则所有的请求都会使用此缓存。

缓存存储方式

你可以设置缓存的数据需要保存多长时间&＃xff0c;ASIHTTPRequest提供了两种策略&＃xff1a;
a&＃xff0c;ASICacheForSessionDurationCacheStoragePolicy&＃xff0c;默认策略&＃xff0c;基于session的缓存数据存储。当下次运行或[ASIHTTPRequest clearSession]时&＃xff0c;缓存将失效。
b&＃xff0c;ASICachePermanentlyCacheStoragePolicy&＃xff0c;把缓存数据永久保存在本地&＃xff0c;
如&＃xff1a;

另外&＃xff0c;也可以使用clearCachedResponsesForStoragePolicy来清空指定策略下的缓存数据。

缓存其它特性

设置是否按服务器在Header里指定的是否可被缓存或过期策略进行缓存&＃xff1a;

设置request缓存的有效时间:

可以判断数据是否从缓存读取&＃xff1a;

设置缓存所使用的路径&＃xff1a;

实现自定义的缓存

只要简单的实现ASICacheDelegate接口就可以被用来使用。

使用代理请求

默认的情况下&＃xff0c;ASIHTTPRequest会使用被设置的默认代理。但你也可以手动修改http代理&＃xff1a;

ASIHTTPRequest, 请求的其它特性

iOS4中&＃xff0c;当应用后台运行时仍然请求数据&＃xff1a;

是否有网络请求&＃xff1a;

是否显示网络请求信息在status bar上&＃xff1a;

设置请求超时时&＃xff0c;设置重试的次数&＃xff1a;

KeepAlive的支持&＃xff1a;