be.ceau.podcastparser.namespace.root.impl

Class RSS

java.lang.Object

be.ceau.podcastparser.namespace.root.impl.RSS

All Implemented Interfaces:

Namespace, RootNamespace

public class RSS
extends Object
implements RootNamespace, Namespace

Really Simple Syndication

RSS is dialect of XML. All RSS files must conform to the XML 1.0 specification, as published on the World Wide Web Consortium (W3C) website.

At the top level, a RSS document is a <rss> element, with a mandatory attribute called version, that specifies the version of RSS that the document conforms to. If it conforms to this specification, the version attribute must be 2.0.

Subordinate to the <rss> element is a single <channel> element, which contains information about the channel (metadata) and its contents.

See Also:

RSS specification

Method Summary

Modifier and Type	Method and Description
String	getName() A namespace has a single, specific, agreed upon name.
static RSS	instance()
void	parseFeed(PodcastParserContext ctx)
Item	parseItem(PodcastParserContext ctx)
void	process(PodcastParserContext ctx) Process any additional information from the XMLStreamReader, at its current position, onto the given Feed in the PodcastParserContext according to the namespace specification.
void	process(PodcastParserContext ctx, Item item) Process any additional information from the XMLStreamReader, at its current position, onto the given Item according to the namespace specification.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface be.ceau.podcastparser.namespace.Namespace

getAlternativeNames, isMatch, mustDelegateTo

Method Detail

instance

public static RSS instance()

getName

public String getName()

Description copied from interface: Namespace

A namespace has a single, specific, agreed upon name. However, quite a few namespaces are denoted by multiple names in real world podcast XML files.

Specified by:

getName in interface Namespace

Returns:

the canonical name for this Namespace, not null identified.

See Also:

Namespace.getAlternativeNames()

parseFeed

public void parseFeed(PodcastParserContext ctx)
               throws XMLStreamException

Specified by:

parseFeed in interface RootNamespace

Throws:

XMLStreamException

parseItem

public Item parseItem(PodcastParserContext ctx)
               throws XMLStreamException

Specified by:

parseItem in interface RootNamespace

Throws:

XMLStreamException

process

public void process(PodcastParserContext ctx)
             throws XMLStreamException

Description copied from interface: Namespace

Process any additional information from the XMLStreamReader, at its current position, onto the given Feed in the PodcastParserContext according to the namespace specification.

Specified by:

process in interface Namespace

Parameters:

ctx - PodcastParserContext instance in the process of being built

Throws:

XMLStreamException - if any

process

public void process(PodcastParserContext ctx,
                    Item item)
             throws XMLStreamException

Description copied from interface: Namespace

Process any additional information from the XMLStreamReader, at its current position, onto the given Item according to the namespace specification.

Specified by:

process in interface Namespace

Parameters:

ctx - PodcastParserContext instance in the process of being built

item - Item instance in the process of being built

Throws:

XMLStreamException - if any