Usage of nsIFeedResult Interface

 Gets a Feed Handler object registered using addFeedResult.

 @param   uri
          The URI of the feed a handler is being requested for

nsIFeedResult getFeedResult(in nsIURI uri)

 Called after each entry/item. If the document is a standalone
 item or entry, this HandleFeedAtFirstEntry will not have been
 called. Also, this entry's parent field will be null.
 
 @param entry
        An object implementing nsIFeedEntry that represents the latest
        entry encountered.
 @param result
        An object implementing nsIFeedResult representing the feed 
        and its metadata. 

void handleEntry(in nsIFeedEntry entry, in nsIFeedResult result)

 Called when the first entry/item is encountered. In Atom, all
 feed data is required to preceed the entries. In RSS, the data
 usually does. If the type is one of the entry/item-only types,
 this event will not be called.

 @param result
        An object implementing nsIFeedResult representing the feed 
        and its metadata. At this point, the result will likely have
        most of its feed-level metadata.

void handleFeedAtFirstEntry(in nsIFeedResult result)

 StartFeed will be called as soon as a reasonable start to
 a feed is detected. 
  
 @param result
        An object implementing nsIFeedResult representing the feed 
        and its metadata. At this point, the result has version 
        information.

void handleStartFeed(in nsIFeedResult result)

 
 Always called, even after an error. There could be new feed-level
 data available at this point, if it followed or was interspersed
 with the items. Fire-and-Forget implementations only need this.
 
 @param result
        An object implementing nsIFeedResult representing the feed 
        and its metadata. 

void handleResult(in nsIFeedResult result)

 Registers a Feed Result object with a globally accessible service
 so that it can be accessed by a singleton method outside the usual
 flow of control in document loading.

 @param   feedResult
          An object implementing nsIFeedResult representing the feed.

void addFeedResult(in nsIFeedResult feedResult)