PSEnclosure object contains a link to an external resource such as a sound or image file associated with an entry. An enclosure is similar to an attachment in an email, but rather than include the file itself in the entry, only a link is provided. Each enclosure object is linked to a entry object.
An enclosure object provides properties for retrieving information about the enclosure, such as its URL, length, and MIME type, as well as methods to download the file linked to in the enclosure. Invoke the
download: method to begin downloading the enclosure's file. To check on the status of the download, register for the
PSEnclosureDownloadStateDidChangeNotification notification. It is not recommended that you subclass
A URL to the enclosure's location. (read-only)
@property (readonly, retain) NSURL * URL;
The return value corresponds to the
'href'attribute of the <link rel="enclosure"> element in Atom and to the
'url'attribute of the <enclosure> element in RSS.
The MIME type of the enclosure. (read-only)
@property (readonly, retain) NSString * MIMEType;
The MIME type corresponds to the
'type'attribute of the <link rel="enclosure"> element in Atom and to the
'type'attribute of the <enclosure> element in RSS.
The length of the file in the enclosure. (read-only)
@property (readonly) long long length;
The length, in bytes, of the file in the enclosure.
The return value is initially parsed from the length attribute of a <link rel="enclosure"> element in Atom and the length attribute of <enclosure> in RSS. If this attribute does not exist in the feed, the return value is
0. The value may change after downloading begins and the true length is received from the server.
The entry with which the enclosure is linked. (read-only)
@property (readonly) PSEntry * entry;
The entry associated with the enclosure.
The inverse of the
enclosuresproperty of the
PSEntryclass. An enclosure follows a one-to-one relationship and can only be linked to a single entry.
This method attempts to communicate with the PubSubAgent process and causes the agent to launch if it is not already running. If PubSubAgent cannot be contacted, an exception will be thrown with the name
PSException. To avoid problems, you should always be prepared to catch an exception thrown by this method.
The path to the downloaded enclosure. (read-only)
@property (readonly) NSString * downloadedPath;
The method returns
nilunless the download has completed.