Returns the most recently registered NSURLHandle subclass that responds to +canInitWithURL: with YES. If there is no such subclass, returns nil.

Return a handle for the specified URL from the cache if possible. If the cache does not contain a matching handle, returns nil.

Implemented by subclasses to say which URLs they can handle. This method is used to determine which subclasses can be used to handle a particular URL.

Used to register a subclass as being available to handle URLs.

Add a client object, making sure that it doesn't occur more than once.
The client object will receive messages notifying it of events on the handle.

Returns the resource data that is currently available for the handle. This may be a partially loaded resource or may be empty if no data has been loaded yet or the last load failed.

This method should be called when a background load fails.
The method passes the failure notification to the clients of the handle - so subclasses should call super's implementation at the end of their implementation of this method.

This method is called by when a background load begins. Subclasses should call super's implementation at the end of their implementation of this method.

This method should be called to cancel a load currently in progress. The method calls -endLoadInBackground Subclasses should call super's implementation at the end of their implementation of this method.

Method called by subclasses during process of loading a resource. The base class maintains a copy of the data being read in and accumulates separate parts of the data.

This method is called to stop any background loading process. -cancelLoadInBackground uses this method to cancel loading. Subclasses should call super's implementation at the end of their implementation of this method.

Returns the failure reason for the last failure to load the resource data.

Flushes any cached resource data.

Initialises a handle with the specified URL.
The flag determines whether the handle will cache resource data and respond to requests from equivalent URLs for the cached data.

Starts (or queues) loading of the handle's resource data in the background (asynchronously).
The default implementation uses loadInForeground - if this method is not overridden, loadInForeground MUST be.

Loads the handle's resource data in the foreground (synchronously).
The default implementation starts a background load and waits for it to complete - if this method is not overridden, loadInBackground MUST be.

Returns the property for the specified key, or nil if the key does not exist.

Returns the property for the specified key, but only if the handle does not need to do any work to retrieve it.

Removes an object from them list of clients notified of resource loading events by the URL handle.

Returns the resource data belonging to the handle. Calls -loadInForeground if necessary.

The GNUstep implementation treats an ftp: request for a directory as a request to list the names of the directory contents.

Returns the current status of the handle.

Writes resource data to the handle. Returns YES on success, NO on failure.

The GNUstep implementation for file: writes the data directly to the local filesystem, and the return status reflects the result of that write operation.

The GNUstep implementation for http: and https: sets the specified data as information to be POSTed to the URL next time it is loaded - so the method always returns YES.

The GNUstep implementation for ftp: sets the specified data as information to be written to the URL next time it is loaded - so the method always returns YES.

Sets a property for handle. Returns YES on success, NO on failure.

The GNUstep implementation sets the property as a header to be sent the next time the URL is loaded, and recognizes some special property keys which control the behavior of the next load.

Sent by the NSURLHandle object when some data becomes available from the handle. Note that this does not mean that all data has become available, only that a chunk of data has arrived.

Sent by the NSURLHandle object on resource load failure. Supplies a human readable failure reason.

Sent by the NSURLHandle object when it begins loading resource data.

Sent by the NSURLHandle object when resource loading is cancelled by programmatic request (rather than by failure).

Sent by the NSURLHandle object when it completes loading resource data.