gov.nasa.worldwind.util.xml

Class StringListXMLEventParser

java.lang.Object

gov.nasa.worldwind.util.xml.AbstractXMLEventParser

gov.nasa.worldwind.util.xml.StringListXMLEventParser

All Implemented Interfaces:

XMLEventParser, Iterable<String>

Direct Known Subclasses:

WCS100SupportedFormats, WCS100SupportedInterpolations

public class StringListXMLEventParser
extends AbstractXMLEventParser
implements Iterable<String>

Field Summary

Fields

Modifier and Type	Field and Description
protected QName	elementName
protected List<String>	strings

Fields inherited from class gov.nasa.worldwind.util.xml.AbstractXMLEventParser

CHARACTERS_CONTENT, fields, namespaceURI, parent

Constructor Summary

Constructors

Constructor and Description
StringListXMLEventParser()
StringListXMLEventParser(String namespaceUri)
StringListXMLEventParser(String namespaceURI, QName elementName) Create a parser.

Method Summary

Modifier and Type	Method and Description
protected void	addString(String string)
protected void	doParseEventContent(XMLEventParserContext ctx, XMLEvent event, Object... args) Parse an event's sub-elements.
List<String>	getStrings()
Iterator<String>	iterator()
XMLEventParser	newInstance() Creates a new empty parser instance of the same type.
Object	parse(XMLEventParserContext ctx, XMLEvent listEvent, Object... args) Parse the event and initialize the parser's values to those found in the event.

Methods inherited from class gov.nasa.worldwind.util.xml.AbstractXMLEventParser

allocate, doAddCharacters, doAddEventAttribute, doAddEventContent, doParseEventAttributes, freeResources, getAConstructor, getCharacters, getField, getField, getFields, getNamespaceURI, getParent, getRoot, hasField, hasField, hasFields, mergeFields, overrideFields, parseCharacterContent, removeField, setField, setField, setFields, setNamespaceURI, setParent

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

elementName

protected QName elementName

strings

protected List<String> strings

Constructor Detail

StringListXMLEventParser

public StringListXMLEventParser()

StringListXMLEventParser

public StringListXMLEventParser(String namespaceUri)

StringListXMLEventParser

public StringListXMLEventParser(String namespaceURI,
                                QName elementName)

Create a parser. All sub-elements of a specified name are parsed as strings and retained.

Parameters:

namespaceURI - the namespace URI to attach to this parser. May be null.

elementName - the name of the sub-elements that contain the strings.

Method Detail

addString

protected void addString(String string)

doParseEventContent

protected void doParseEventContent(XMLEventParserContext ctx,
                                   XMLEvent event,
                                   Object... args)
                            throws XMLStreamException

Description copied from class: AbstractXMLEventParser

Parse an event's sub-elements.

Overrides:

doParseEventContent in class AbstractXMLEventParser

Parameters:

ctx - a current parser context.

event - the event to parse.

args - an optional list of arguments that may by used by subclasses.

Throws:

XMLStreamException - if an exception occurs during event-stream reading.

getStrings

public List<String> getStrings()

iterator

public Iterator<String> iterator()

Specified by:

iterator in interface Iterable<String>

newInstance

public XMLEventParser newInstance()
                           throws Exception

Description copied from interface: XMLEventParser

Creates a new empty parser instance of the same type. This is used by XMLEventParserContext when creating parsers associated with specific event types. The returned parser has the same namespace as the instance creating it, but has empty fields for all other values.

Specified by:

newInstance in interface XMLEventParser

Overrides:

newInstance in class AbstractXMLEventParser

Returns:

a new parser instance. The namespace URI is the same as the creating parser, but all other fields are empty.

Throws:

Exception - if an error or exception occurs while attempting to create the parser.

parse

public Object parse(XMLEventParserContext ctx,
                    XMLEvent listEvent,
                    Object... args)
             throws XMLStreamException

Description copied from class: AbstractXMLEventParser

Parse the event and initialize the parser's values to those found in the event.

Specified by:

parse in interface XMLEventParser

Overrides:

parse in class AbstractXMLEventParser

Parameters:

ctx - a current parser context.

listEvent - the event to parse.

args - an optional list of arguments that may by used by subclasses.

Returns:

if parsing is successful, returns this, otherwise returns null.

Throws:

XMLStreamException - if an exception occurs during event-stream reading.