be.ceau.podcastparser

Class PodcastParserContext

java.lang.Object

be.ceau.podcastparser.PodcastParserContext

public class PodcastParserContext
extends Object

Logic and state for the parse process of a single podcast XML feed

Constructor Summary

Constructors

Constructor and Description
PodcastParserContext(String rootNamespace, XMLStreamReader reader) Constructor
PodcastParserContext(String rootNamespace, XMLStreamReader reader, Collection<NamespaceCallbackHandler> callbacks) Constructor
PodcastParserContext(String rootNamespace, XMLStreamReader reader, Collection<NamespaceCallbackHandler> callbacks, Collection<ElementFilter> filters) Constructor

Method Summary

Modifier and Type	Method and Description
void	beforeProcess() Process callback before processing Feed
void	beforeProcess(Item item) Process callback before processing Item
String	getAttribute(String localName)
Integer	getAttributeAsInteger(String localName)
Long	getAttributeAsLong(String localName)
String	getElementText() Retrieves the element text if currently at a start element.
BigDecimal	getElementTextAsBigDecimal() Extract and attempt parsing current element text as BigDecimal, catching any exception
Integer	getElementTextAsInteger() Extract and attempt parsing current element text as Integer, catching any exception
Feed	getFeed()
XMLStreamReader	getReader()
boolean	isSkip() Evaluate the current element against the ElementFilter instances in this PodcastParserContext.
void	log() Log, non-repeatably, the current element, including its internal hierarchy
void	registerUnhandledElement(ParseLevel level) Process callback when encountering unknown element
void	registerUnknownNamespace(ParseLevel level) Process callback when encountering unknown namespace
String	serialize() Serialize, non-repeatably, the current element, including its internal hierarchy
void	skip() If called after having processed a XMLStreamConstants.START_ELEMENT event, will skip until the end of the newly opened element is reached.

Methods inherited from class java.lang.Object

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

Constructor Detail

PodcastParserContext

public PodcastParserContext(String rootNamespace,
                            XMLStreamReader reader)

Constructor

Parameters:

rootNamespace - String name of the root namespace, not null

reader - XMLStreamReader instance over the XML input, not null

PodcastParserContext

public PodcastParserContext(String rootNamespace,
                            XMLStreamReader reader,
                            Collection<NamespaceCallbackHandler> callbacks)

Constructor

Parameters:

rootNamespace - String name of the root namespace, not null

reader - XMLStreamReader instance over the XML input, not null

callbacks - Collection of NamespaceCallbackHandler instances, can be null

PodcastParserContext

public PodcastParserContext(String rootNamespace,
                            XMLStreamReader reader,
                            Collection<NamespaceCallbackHandler> callbacks,
                            Collection<ElementFilter> filters)

Constructor

Parameters:

rootNamespace - String name of the root namespace, not null

reader - XMLStreamReader instance over the XML input, not null

callbacks - Collection of NamespaceCallbackHandler instances, can be null

filters - Collection of ElementFilter instances, can be null

Method Detail

getReader

public XMLStreamReader getReader()

Returns:

XMLStreamReader, never null

getFeed

public Feed getFeed()

Returns:

Feed, never null

beforeProcess

public void beforeProcess()
                   throws XMLStreamException

Process callback before processing Feed

Throws:

XMLStreamException - if any

beforeProcess

public void beforeProcess(Item item)
                   throws XMLStreamException

Process callback before processing Item

Parameters:

item - Item instance, not null

Throws:

XMLStreamException - if any

registerUnknownNamespace

public void registerUnknownNamespace(ParseLevel level)
                              throws XMLStreamException

Process callback when encountering unknown namespace

Parameters:

level - ParseLevel of current parse process, not null

Throws:

XMLStreamException - if any

registerUnhandledElement

public void registerUnhandledElement(ParseLevel level)
                              throws XMLStreamException

Process callback when encountering unknown element

Parameters:

level - ParseLevel of current parse process, not null

Throws:

XMLStreamException - if any

getElementText

public String getElementText()
                      throws XMLStreamException

Retrieves the element text if currently at a start element.

Returns:

a String with element text content, or null

Throws:

XMLStreamException - if any

getElementTextAsInteger

public Integer getElementTextAsInteger()
                                throws XMLStreamException

Extract and attempt parsing current element text as Integer, catching any exception

Returns:

Integer or null

Throws:

XMLStreamException - if any

getElementTextAsBigDecimal

public BigDecimal getElementTextAsBigDecimal()
                                      throws XMLStreamException

Extract and attempt parsing current element text as BigDecimal, catching any exception

Returns:

BigDecimal or null

Throws:

XMLStreamException - if any

getAttribute

public String getAttribute(String localName)

Parameters:

localName - String attribute name

Returns:

String attribute value, or null

getAttributeAsInteger

public Integer getAttributeAsInteger(String localName)

Parameters:

localName - String attribute name

Returns:

attribute value parsed as Integer, or null

getAttributeAsLong

public Long getAttributeAsLong(String localName)

Parameters:

localName - String attribute name

Returns:

attribute value parsed as Long, or null

isSkip

public boolean isSkip()

Evaluate the current element against the ElementFilter instances in this PodcastParserContext.

Returns:

true if the current element should be skipped

skip

public void skip()
          throws XMLStreamException

If called after having processed a XMLStreamConstants.START_ELEMENT event, will skip until the end of the newly opened element is reached.

Throws:

XMLStreamException - if any

log

public void log()
         throws XMLStreamException

Log, non-repeatably, the current element, including its internal hierarchy

Throws:

XMLStreamException - if any

serialize

public String serialize()
                 throws XMLStreamException

Serialize, non-repeatably, the current element, including its internal hierarchy

Returns:

String, not null

Throws:

XMLStreamException - if any