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, java.lang.Iterable<java.lang.String>

Direct Known Subclasses:

WCS100SupportedFormats, WCS100SupportedInterpolations

public class StringListXMLEventParser
extends AbstractXMLEventParser
implements java.lang.Iterable<java.lang.String>

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.xml.namespace.QName	elementName
protected java.util.List<java.lang.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(java.lang.String namespaceUri)
StringListXMLEventParser(java.lang.String namespaceURI, javax.xml.namespace.QName elementName) Create a parser.

Method Summary

Modifier and Type	Method and Description
protected void	addString(java.lang.String string)
protected void	doParseEventContent(XMLEventParserContext ctx, javax.xml.stream.events.XMLEvent event, java.lang.Object... args) Parse an event's sub-elements.
java.util.List<java.lang.String>	getStrings()
java.util.Iterator<java.lang.String>	iterator()
XMLEventParser	newInstance() Creates a new empty parser instance of the same type.
java.lang.Object	parse(XMLEventParserContext ctx, javax.xml.stream.events.XMLEvent listEvent, java.lang.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 javax.xml.namespace.QName elementName

strings

protected java.util.List<java.lang.String> strings

Constructor Detail

StringListXMLEventParser

public StringListXMLEventParser()

StringListXMLEventParser

public StringListXMLEventParser(java.lang.String namespaceUri)

StringListXMLEventParser

public StringListXMLEventParser(java.lang.String namespaceURI,
                                javax.xml.namespace.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(java.lang.String string)

doParseEventContent

protected void doParseEventContent(XMLEventParserContext ctx,
                                   javax.xml.stream.events.XMLEvent event,
                                   java.lang.Object... args)
                            throws javax.xml.stream.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:

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

getStrings

public java.util.List<java.lang.String> getStrings()

iterator

public java.util.Iterator<java.lang.String> iterator()

Specified by:

iterator in interface java.lang.Iterable<java.lang.String>

newInstance

public XMLEventParser newInstance()
                           throws java.lang.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:

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

parse

public java.lang.Object parse(XMLEventParserContext ctx,
                              javax.xml.stream.events.XMLEvent listEvent,
                              java.lang.Object... args)
                       throws javax.xml.stream.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:

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