ASIHTTPRequest

What is ASIHTTPRequest?

ASIHTTPRequest是什么？

ASIHTTPRequest is an easy to use wrapper around the CFNetwork API that makes some of the more tedious aspects of communicating with web servers easier. It is written in Objective-C and works in both Mac OS X and iPhone applications.

ASIHTTPRequest封装了CFNetwork API，让与服务器通讯方面的工作更容易。

It is suitable performing basic HTTP requests and interacting with REST-based services (GET / POST / PUT / DELETE). The included ASIFormDataRequest subclass makes it easy to submit POST data and files using multipart/form-data.

它适合执行基本的HTTP请求以及与基于REST（GET / POST / PUT / DELETE）的服务互动。包含的 ASIFormDataRequest 子类可以用multipart/form-data更方便地提交POST数据和文件.

Features

A straightforward interface for submitting data to and fetching data from webservers

Download data to memory or directly to a file on disk

The ability to submit files on local drives as part of POST data, compatible with the HTML file input mechanism

Easy access to request and response HTTP headers

Progress delegates (NSProgressIndicators and UIProgressViews) to show information about download AND upload progress

Auto-magic management of upload and download progress indicators for operation queues

Basic, Digest and NTLM authentication
support, credentials are automatically for the duration of a session, and can be stored for later in the Keychain.

Cookie support

NEW! Requests can continue to run when your app moves to the background (iOS 4+)

GZIP support for response data AND request
bodies

The included ASIDownloadCache class lets requests transparently cache responses, and allow requests for
cached data to succeed even when there is no network available!

NEW! ASIWebPageRequest -
download complete webpages, including external resources like images and stylesheets. Pages of any size can be indefinitely cached, and displayed in a UIWebview / WebView even when you have no network connection.

Easy to use support for Amazon S3 - no need to fiddle around signing requests yourself!

Full support for Rackspace Cloud Files, contributed by Mike Mayo of Rackspace.

NEW! Client
certificates support

Supports manual and auto-detected proxies, authenticating proxies, and PAC file auto-configuration. The built-in login
dialog lets your iPhone application work transparently with authenticating proxies without any additional effort.

Bandwidth throttling support

Support for persistent connections

Supports synchronous & asynchronous requests

Get notifications about changes in your request state via delegation or NEW! blocks (Mac OS X 10.6, iOS
4 and above)

Comes with a broad range of unit tests

特性

通过一个直截了当的接口可以方便地提交数据到服务器，以及从服务器抓取数据。
下载数据到内存或者直接到外存上的一个文件中。
可以作为POST data的一部分通过本地驱动提交数据，与Html 文件输入系统兼容。
更方便地访问HTTP header 的request
and response。
通过进程代理显示下载和上传的进度信息。
自动管理操作队列的上传和下载的指示器。
Basic, Digest and NTLM认证支持，证书自动持续到整个会话，并且可以之后存储到KeyChain中。

支持Cookie
(新功能)当你的App在后台时，请求可以继续运行。（iOS4.0之后的系统）
对响应数据和请求主体支持GZip.
包含的ASIDownloadCache让请求觉察到缓存响应，当没有可用网络时，允许请求缓存数据来继承。

(新功能)ASIWebPageRequest-下载完整的网络页面，包括图片、样式表之类的额外资源。任意大小的页面都可以被无限期的缓存，不管有没有网络，你都可以在UIWebview
/ WebView中展示。
Easy to use support for Amazon S3 -
no need to fiddle around signing requests yourself!
Full support for Rackspace Cloud Files,
contributed by Mike Mayo of Rackspace.
（新功能）客户端认证支持。

ASIHTTPRequest comes with a example applications for Mac and iPhone that demonstrate some of the features.

ASIHTTPRequest is partly based on code from Apple’s ImageClient code samples, so if it doesn’t meet your needs, take
a look at their CFNetwork examples for more.

ASIHTTPRequest is compatible with Mac OS 10.5 or later, and iOS 3.0 or later.