NSURLHandle Class Reference

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

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

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 Programming Guide.)

Available in 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 Programming Guide.)

Available in 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 Programming Guide.)

Available in 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 Programming Guide.)

Available in OS X v10.0 and later.

Declared in NSURLHandle.h.

Availability
  • Available in OS X v10.0 and later.
Declared In
NSURLHandle.h


© 2009 Apple Inc. All Rights Reserved. (Last updated: 2009-02-04)

Did this document help you? Yes It's good, but... Not helpful...