Statistics
| Branch: | Revision:

root / asi-http-request-with-pithos / README.textile @ be116d22

History | View | Annotate | Download (2.6 kB)

1
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.
2

    
3
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.
4

    
5
It provides:
6
* A straightforward interface for submitting data to and fetching data from webservers
7
* Download data to memory or directly to a file on disk
8
* Submit files on local drives as part of POST data, compatible with the HTML file input mechanism
9
* Stream request bodies directly from disk to the server, to conserve memory
10
* Resume for partial downloads
11
* Easy access to request and response HTTP headers
12
* Progress delegates (NSProgressIndicators and UIProgressViews) to show information about download AND upload progress
13
* Auto-magic management of upload and download progress indicators for operation queues
14
* Basic, Digest + NTLM authentication support, credentials are automatically re-used for the duration of a session, and can be stored for later in the Keychain.
15
* Cookie support
16
* [NEW] Requests can continue to run when your app moves to the background (iOS 4+)
17
* GZIP support for response data AND request bodies
18
* The included ASIDownloadCache class lets requests transparently cache responses, and allow requests for cached data to succeed even when there is no network available
19
* [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.
20
* Easy to use support for Amazon S3 - no need to fiddle around signing requests yourself!
21
* Full support for Rackspace Cloud Files
22
* [NEW] Client certificates support
23
* 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.
24
* Bandwidth throttling support
25
* Support for persistent connections
26
* Supports synchronous & asynchronous requests
27
* Get notifications about changes in your request state via delegation or [NEW] blocks (Mac OS X 10.6, iOS 4 and above)
28
* Comes with a broad range of unit tests
29

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

    
32
Documentation is available "here":http://allseeing-i.com/ASIHTTPRequest.