NSURLHandle Class Reference

Inherits from	NSObject
Conforms to	NSObject (NSObject)
Framework	/System/Library/Frameworks/Foundation.framework
Availability	Available in Mac OS X v10.0 and later.
Declared in	NSURLHandle.h

NSURLHandle is deprecated in Mac OS X v10.4 and later. Applications that are intended for deployment on Mac OS X v10.3 or later should use NSURLConnection or NSURLDownload instead; see URL Loading System.

Overview

NSURLHandle declares the programmatic interface for an object that accesses and manages resource data indicated by an NSURL object. A single NSURLHandle can service multiple equivalent NSURL objects, but only if these URLs map to the same resource.

Cocoa provides private concrete subclasses to handle HTTP and file URL schemes. If you want to implement support for additional URL schemes, you would do so by creating a subclass of NSURLHandle. You can use NSURL and NSURLHandle to download from FTP sites without subclassing.

Tasks

Constructing NSURLHandles

Managing Subclasses

Managing Clients

Setting and Getting Resource Properties

Loading Resource Data

Writing Resource Data

Constants

NSURLHandleStatus

These following constants are defined by NSURLHandle and are returned by status.

typedef enum {
   NSURLHandleNotLoaded = 0,
   NSURLHandleLoadSucceeded,
   NSURLHandleLoadInProgress,
   NSURLHandleLoadFailed
} NSURLHandleStatus;

Constants

NSURLHandleNotLoaded

The resource data has not been loaded. (Deprecated. Use NSURLConnection or NSURLDownload instead; see URL Loading System.)

Available in Mac OS X v10.0 and later.

Declared in NSURLHandle.h.

NSURLHandleLoadSucceeded

The resource data was successfully loaded. (Deprecated. Use NSURLConnection or NSURLDownload instead; see URL Loading System.)

Available in Mac OS X v10.0 and later.

Declared in NSURLHandle.h.

NSURLHandleLoadInProgress

The resource data is in the process of loading. (Deprecated. Use NSURLConnection or NSURLDownload instead; see URL Loading System.)

Available in Mac OS X v10.0 and later.

Declared in NSURLHandle.h.

NSURLHandleLoadFailed

The resource data failed to load. (Deprecated. Use NSURLConnection or NSURLDownload instead; see URL Loading System.)

Available in Mac OS X v10.0 and later.

Declared in NSURLHandle.h.

Availability

Available in Mac OS X v10.0 and later.

Declared In

NSURLHandle.h

Next Page >

Hide TOC

Did this document help you?
Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.