StAX Mapper 1.0.0.Final

org.jboss.staxmapper
Interface XMLExtendedStreamReader

All Superinterfaces:
XMLStreamConstants, XMLStreamReader

public interface XMLExtendedStreamReader
extends XMLStreamReader

An XML stream reader that can read nested <xs:any> content using a registered set of root elements.

Author:
David M. Lloyd

Field Summary
 
Fields inherited from interface javax.xml.stream.XMLStreamConstants
ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT
 
Method Summary
 void discardRemainder()
          Discard the remaining content of an element.
<T> T
getAttributeValue(int index, Class<T> kind)
          Get the attribute value using intelligent type conversion.
 String getId()
          Get the XML ID attribute, if any.
 int getIntAttributeValue(int index)
          Get the value of an attribute as an integer.
 int[] getIntListAttributeValue(int index)
          Get the value of an attribute as an integer list.
 List<String> getListAttributeValue(int index)
          Get the value of an attribute as a space-delimited string list.
<T> List<? extends T>
getListAttributeValue(int index, Class<T> kind)
          Get the attribute value as a list using intelligent type conversion.
 long getLongAttributeValue(int index)
          Get the value of an attribute as a long.
 long[] getLongListAttributeValue(int index)
          Get the value of an attribute as a long integer list.
 XMLMapper getXMLMapper()
          Gets the XMLMapper used to handle extended attributes and xs:any-type nested elements.
 void handleAny(Object value)
          Handle an <xs:any>-type nested element, passing in the given value, returning after the end of the element.
 void handleAttribute(Object value, int index)
          Handle an extended attribute, passing in the given value.
 void setTrimElementText(boolean trim)
          Whether or not XMLStreamReader.getElementText() should trim content.
 
Methods inherited from interface javax.xml.stream.XMLStreamReader
close, getAttributeCount, getAttributeLocalName, getAttributeName, getAttributeNamespace, getAttributePrefix, getAttributeType, getAttributeValue, getAttributeValue, getCharacterEncodingScheme, getElementText, getEncoding, getEventType, getLocalName, getLocation, getName, getNamespaceContext, getNamespaceCount, getNamespacePrefix, getNamespaceURI, getNamespaceURI, getNamespaceURI, getPIData, getPITarget, getPrefix, getProperty, getText, getTextCharacters, getTextCharacters, getTextLength, getTextStart, getVersion, hasName, hasNext, hasText, isAttributeSpecified, isCharacters, isEndElement, isStandalone, isStartElement, isWhiteSpace, next, nextTag, require, standaloneSet
 

Method Detail

handleAny

void handleAny(Object value)
               throws XMLStreamException
Handle an <xs:any>-type nested element, passing in the given value, returning after the end of the element. Must be positioned on a START_ELEMENT or an exception will occur. On return the cursor will be positioned on the corresponding END_ELEMENT.

Parameters:
value - the value to pass in
Throws:
XMLStreamException - if an error occurs (e.g. the given value does not match the type of the handler for the element, or the element is unknown)

handleAttribute

void handleAttribute(Object value,
                     int index)
                     throws XMLStreamException
Handle an extended attribute, passing in the given value. Must be positioned on a START_ELEMENT or an exception will occur. On return the cursor will be pointing at the same START_ELEMENT.

Parameters:
value - the value to pass in
index - the index of the attribute to process
Throws:
XMLStreamException - if an error occurs

discardRemainder

void discardRemainder()
                      throws XMLStreamException
Discard the remaining content of an element. Runs until a END_ELEMENT is encountered. If a START_ELEMENT is encountered, then recursively consume and ignore its content as well.

Throws:
XMLStreamException - if an error occurs.

getIntAttributeValue

int getIntAttributeValue(int index)
                         throws XMLStreamException
Get the value of an attribute as an integer.

Parameters:
index - the index of the attribute
Returns:
the integer value
Throws:
XMLStreamException - if an error occurs

getIntListAttributeValue

int[] getIntListAttributeValue(int index)
                               throws XMLStreamException
Get the value of an attribute as an integer list.

Parameters:
index - the index of the attribute
Returns:
the integer values
Throws:
XMLStreamException - if an error occurs

getListAttributeValue

List<String> getListAttributeValue(int index)
                                   throws XMLStreamException
Get the value of an attribute as a space-delimited string list.

Parameters:
index - the index of the attribute
Returns:
the values
Throws:
XMLStreamException - if an error occurs

getLongAttributeValue

long getLongAttributeValue(int index)
                           throws XMLStreamException
Get the value of an attribute as a long.

Parameters:
index - the index of the attribute
Returns:
the long value
Throws:
XMLStreamException - if an error occurs

getLongListAttributeValue

long[] getLongListAttributeValue(int index)
                                 throws XMLStreamException
Get the value of an attribute as a long integer list.

Parameters:
index - the index of the attribute
Returns:
the long values
Throws:
XMLStreamException - if an error occurs

getAttributeValue

<T> T getAttributeValue(int index,
                        Class<T> kind)
                    throws XMLStreamException
Get the attribute value using intelligent type conversion. Numeric types will be parsed; enum types will be mapped.

Type Parameters:
T - the type of the expected object
Parameters:
index - the index of the attribute
kind - the class of the expected object
Returns:
the object equivalent
Throws:
XMLStreamException - if an error occurs

getListAttributeValue

<T> List<? extends T> getListAttributeValue(int index,
                                            Class<T> kind)
                                        throws XMLStreamException
Get the attribute value as a list using intelligent type conversion. Numeric types will be parsed; enum types will be mapped.

Parameters:
index - the index of the attribute
kind - the class of the expected object
Returns:
the list of object equivalents
Throws:
XMLStreamException - if an error occurs

getId

String getId()
             throws XMLStreamException
Get the XML ID attribute, if any.

Returns:
the attribute value
Throws:
XMLStreamException - if an error occurs

getXMLMapper

XMLMapper getXMLMapper()
Gets the XMLMapper used to handle extended attributes and xs:any-type nested elements.

Returns:
the XMLMapper. Will not return null

setTrimElementText

void setTrimElementText(boolean trim)
Whether or not XMLStreamReader.getElementText() should trim content. The default is true.

Parameters:
trim - trim if true, don't if false

StAX Mapper 1.0.0.Final

Copyright © 2011 JBoss, a division of Red Hat, Inc.. All Rights Reserved.