#C HTTP CLIENT DOWNLOAD#

For compatibility with earlier versions of OS X and iOS, you can also use the NSURLConnection class with a custom delegate.įor the most part, the NSURLSession and NSURLConnection classes work similarly at a high level. If your app needs more control over your request, such as controlling whether redirects are followed, performing custom authentication, or obtaining the data piecewise as it is received, you can use the NSURLSession class with a custom delegate. Retrieving the Contents of a URL with Delegates If the URL loading system is unable to retrieve the contents of the URL, an NSError object is passed as the third parameter. If the transfer succeeds, the contents of the request are passed to the callback handler block as an NSData object and an NSURLResponse object for the request. Your app must provide the following information:Īs appropriate, either an NSURL object or a filled-out NSURLRequest object that provides the URL, body data, and any other information that might be required for your particular request.Ī completion handler block that runs whenever the transfer finishes or fails.įor NSURLConnection, an NSOperation queue on which your block should run. To do this, call one of the following methods: dataTaskWithRequest:completionHandler: ( NSURLSession), dataTaskWithURL:completionHandler: ( NSURLSession), or sendAsynchronousRequest:queue:completionHandler: ( NSURLConnection). You can also use the NSURLConnection class for compatibility with earlier versions of OS X and iOS. If you just need to retrieve the contents of a URL and do something with the results at the end, in OS X v10.9 and later or iOS 7 and later, you should use the NSURLSession class. Retrieving the Contents of a URL without Delegates The following tasks describe common operations with the NSURLSession class, the NSURLConnection class, and related classes.

These APIs are described in Using Sockets and Socket Streams. Note: If you have specific needs, you can also write your own HTTP client implementation using socket or socket-stream APIs. The sections below describe these APIs in more detail. Otherwise, you should generally use the NSURLSession or NSURLConnection APIs. You need to be compatible with a particular non-compliant server.įor more information, see Making Requests Using Core Foundation. You have a strict requirement not to use Objective-C. You should use CFHTTPStream if any of the following are true: For details, see Downloading the Contents of a URL to Disk.

#C HTTP CLIENT DOWNLOAD#

If you need to download a file to disk in OS X, the easiest way is to use the NSURLDownload class. If you are writing a Newsstand app, you should use the NKAssetDownload API to download content in the background. When choosing an API, you should first consider why you are making an HTTP request: With these APIs, you can download files to disk, make simple HTTP and HTTPS requests, or precisely tune your request to the specific requirements of your server infrastructure. OS X and iOS provide a number of general-purpose APIs for making HTTP and HTTPS requests. Next Previous Making HTTP and HTTPS Requests

C http client