org.clapper.curn.parser
Interface RSSParser

All Known Implementing Classes:

RSSParserAdapter, RSSParserAdapter

public interface RSSParser

This interface defines a simplified view of an RSS parser, providing only the methods necessary for curn to work. curn uses the RSSParserFactory class to get a specific implementation of an RSSParser. This strategy isolates the bulk of the code from the underlying RSS parser, making it easier to substitute different parsers as more of them become available.

Version:

$Revision: 6305 $

See Also:

RSSParserFactory, RSSChannel, RSSItem

Method Summary

RSSChannel

parseRSSFeed(java.net.URL url, java.io.InputStream stream, java.lang.String encoding) Parse an RSS feed.

Method Detail

parseRSSFeed

RSSChannel parseRSSFeed(java.net.URL url,
                        java.io.InputStream stream,
                        java.lang.String encoding)
                        throws java.io.IOException,
                               RSSParserException

Parse an RSS feed.

Parameters:

url - the URL for the feed

stream - the InputStream for the feed

encoding - the encoding of the data in the field, if known, or null

Returns:

an RSSChannel object representing the RSS data from the site.

Throws:

java.io.IOException - unable to read from URL

RSSParserException - unable to parse RSS XML