Class StreamReader2Delegate

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected XMLStreamReader2 _delegate2  
      • 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

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void closeCompletely()
      Method similar to XMLStreamReader.close(), except that this method also does close the underlying input source if it has not yet been closed.
      void getAttributeAs​(int index, TypedValueDecoder tvd)
      Generic access method that can be used for efficient decoding of additional types not support natively by the typed stream reader.
      int getAttributeAsArray​(int index, TypedArrayDecoder tad)
      Method that allows reading contents of an attribute as an array of whitespace-separate tokens, decoded using specified decoder.
      byte[] getAttributeAsBinary​(int index)
      Read an attribute value as a byte array.
      byte[] getAttributeAsBinary​(int index, Base64Variant v)  
      boolean getAttributeAsBoolean​(int index)
      Read an attribute value as a boolean.
      java.math.BigDecimal getAttributeAsDecimal​(int index)  
      double getAttributeAsDouble​(int index)  
      double[] getAttributeAsDoubleArray​(int index)  
      float getAttributeAsFloat​(int index)  
      float[] getAttributeAsFloatArray​(int index)  
      int getAttributeAsInt​(int index)
      Read an attribute value as a boolean.
      int[] getAttributeAsIntArray​(int index)
      Read an attribute content as an int array.
      java.math.BigInteger getAttributeAsInteger​(int index)  
      long getAttributeAsLong​(int index)
      Read an attribute value as a boolean.
      long[] getAttributeAsLongArray​(int index)  
      javax.xml.namespace.QName getAttributeAsQName​(int index)  
      int getAttributeIndex​(java.lang.String namespaceURI, java.lang.String localName)
      Returns the index of the attribute whose local name is localName and URI is namespaceURI or -1 if no such attribute exists.
      AttributeInfo getAttributeInfo()
      Method that can be called to get additional information about attributes related to the current start element, as well as related DTD-based information if available.
      int getDepth()
      Method that returns the number of open elements in the stack; 0 when the reader is in prolog/epilog, 1 inside root element (including when pointing at the root element itself) and so on.
      DTDInfo getDTDInfo()
      Method that can be called to get information about DOCTYPE declaration that the reader is currently pointing to, if the reader has parsed it.
      void getElementAs​(TypedValueDecoder tvd)
      Generic decoding method that can be used for efficient decoding of additional types not support natively by the typed stream reader.
      byte[] getElementAsBinary()
      Convenience method that can be used similar to read binary content instead of TypedXMLStreamReader.readElementAsBinary(byte[], int, int, org.codehaus.stax2.typed.Base64Variant), in cases where neither performance nor memory usage is a big concern.
      byte[] getElementAsBinary​(Base64Variant v)
      Convenience method that can be used similar to read binary content instead of TypedXMLStreamReader.readElementAsBinary(byte[], int, int, org.codehaus.stax2.typed.Base64Variant), in cases where neither performance nor memory usage is a big concern.
      boolean getElementAsBoolean()
      Read an element content as a boolean.
      java.math.BigDecimal getElementAsDecimal()  
      double getElementAsDouble()
      Read an element content as a 64-bit floating point value.
      float getElementAsFloat()
      Read an element content as a 32-bit floating point value.
      int getElementAsInt()
      Read an element content as a 32-bit integer.
      java.math.BigInteger getElementAsInteger()  
      long getElementAsLong()
      Read an element content as a 64-bit integer.
      javax.xml.namespace.QName getElementAsQName()  
      java.lang.Object getFeature​(java.lang.String name)
      Method that can be used to get per-reader values; both generic ones (names for which are defined as constants in this class), and implementation dependant ones.
      LocationInfo getLocationInfo()  
      javax.xml.namespace.NamespaceContext getNonTransientNamespaceContext()
      This method returns a namespace context object that contains information identical to that returned by XMLStreamReader.getNamespaceContext(), but one that is not transient.
      java.lang.String getPrefixedName()
      This method returns "prefix-qualified" name of the current element.
      int getText​(java.io.Writer w, boolean preserveContents)
      Method similar to XMLStreamReader.getText(), except that it just uses provided Writer to write all textual content, and that it works for wider range of event types.
      boolean isEmptyElement()
      Method that can be used to check whether current START_ELEMENT event was created for an empty element (xml short-hand notation where one tag implies start and end, ending with "/>"), or not.
      boolean isPropertySupported​(java.lang.String name)
      Method similar to XMLInputFactory.isPropertySupported(java.lang.String), used to determine whether a property is supported by the Reader instance.
      int readElementAsArray​(TypedArrayDecoder tad)
      Read an element content as an array of tokens.
      int readElementAsBinary​(byte[] resultBuffer, int offset, int maxLength)  
      int readElementAsBinary​(byte[] resultBuffer, int offset, int maxLength, Base64Variant v)
      Read element content as decoded byte sequence; possibly only reading a fragment of all element content.
      int readElementAsDoubleArray​(double[] value, int from, int length)  
      int readElementAsFloatArray​(float[] value, int from, int length)  
      int readElementAsIntArray​(int[] value, int from, int length)
      Read an element content as an int array.
      int readElementAsLongArray​(long[] value, int from, int length)  
      void setFeature​(java.lang.String name, java.lang.Object value)
      Method that can be used to set per-reader features such as configuration settings; both generic ones (names for which are defined as constants in this class), and implementation dependant ones.
      void setParent​(javax.xml.stream.XMLStreamReader pr)  
      boolean setProperty​(java.lang.String name, java.lang.Object value)
      Method that can be used to set per-reader properties; a subset of properties one can set via matching XMLInputFactory2 instance.
      ValidationProblemHandler setValidationProblemHandler​(ValidationProblemHandler h)
      Method that application can call to define a custom handler for validation problems encountered during validation process.
      void skipElement()
      Method that will skip all the contents of the element that the stream currently points to.
      XMLValidator stopValidatingAgainst​(XMLValidationSchema schema)
      Method that can be called by application to stop validating output against a schema, for which Validatable.validateAgainst(org.codehaus.stax2.validation.XMLValidationSchema) was called earlier.
      XMLValidator stopValidatingAgainst​(XMLValidator validator)
      Method that can be called by application to stop validating output using specified validator.
      XMLValidator validateAgainst​(XMLValidationSchema schema)
      Method that will construct a XMLValidator instance from the given schema (unless a validator for that schema has already been added), initialize it if necessary, and make validatable object (reader, writer) call appropriate validation methods from this point on until the end of the document (that is, it's not scoped with sub-trees), or until validator is removed by an explicit call to Validatable.stopValidatingAgainst(org.codehaus.stax2.validation.XMLValidationSchema).
      • Methods inherited from class javax.xml.stream.util.StreamReaderDelegate

        close, getAttributeCount, getAttributeLocalName, getAttributeName, getAttributeNamespace, getAttributePrefix, getAttributeType, getAttributeValue, getAttributeValue, getCharacterEncodingScheme, getElementText, getEncoding, getEventType, getLocalName, getLocation, getName, getNamespaceContext, getNamespaceCount, getNamespacePrefix, getNamespaceURI, getNamespaceURI, getNamespaceURI, getParent, getPIData, getPITarget, getPrefix, getProperty, getText, getTextCharacters, getTextCharacters, getTextLength, getTextStart, getVersion, hasName, hasNext, hasText, isAttributeSpecified, isCharacters, isEndElement, isStandalone, isStartElement, isWhiteSpace, next, nextTag, require, standaloneSet
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • 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
    • Constructor Detail

    • Method Detail

      • setParent

        public void setParent​(javax.xml.stream.XMLStreamReader pr)
        Overrides:
        setParent in class javax.xml.stream.util.StreamReaderDelegate
      • closeCompletely

        public void closeCompletely()
                             throws javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method similar to XMLStreamReader.close(), except that this method also does close the underlying input source if it has not yet been closed. It is generally preferable to call this method if the parsing ends in an exception; and for some input sources (when passing a File or URL for factory method) it has to be called as the application does not have access to the actually input source (InputStream opened from a URL and so on).
        Specified by:
        closeCompletely in interface XMLStreamReader2
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeInfo

        public AttributeInfo getAttributeInfo()
                                       throws javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method that can be called to get additional information about attributes related to the current start element, as well as related DTD-based information if available. Note that the reader has to currently point to START_ELEMENT; if not, a IllegalStateException will be thrown.
        Specified by:
        getAttributeInfo in interface XMLStreamReader2
        Throws:
        javax.xml.stream.XMLStreamException
      • getDTDInfo

        public DTDInfo getDTDInfo()
                           throws javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method that can be called to get information about DOCTYPE declaration that the reader is currently pointing to, if the reader has parsed it. Implementations can also choose to return null to indicate they do not provide extra information; but they should not throw any exceptions beyond normal parsing exceptions.
        Specified by:
        getDTDInfo in interface XMLStreamReader2
        Returns:
        Information object for accessing further DOCTYPE information, iff the reader currently points to DTD event, AND is operating in mode that parses such information (DTD-aware at least, and usually also validating)
        Throws:
        javax.xml.stream.XMLStreamException
      • getDepth

        public int getDepth()
        Description copied from interface: XMLStreamReader2
        Method that returns the number of open elements in the stack; 0 when the reader is in prolog/epilog, 1 inside root element (including when pointing at the root element itself) and so on. Depth is same for matching start/end elements, as well as for the all children of an element.
        Specified by:
        getDepth in interface XMLStreamReader2
        Returns:
        Number of open elements currently in the reader's stack, including current START_ELEMENT or END_ELEMENT (if pointing to one).
      • getFeature

        public java.lang.Object getFeature​(java.lang.String name)
        Description copied from interface: XMLStreamReader2
        Method that can be used to get per-reader values; both generic ones (names for which are defined as constants in this class), and implementation dependant ones.

        Note: although some feature names are shared with XMLStreamReader2.setFeature(java.lang.String, java.lang.Object), not all are: some features are read-only, some write-only

        Specified by:
        getFeature in interface XMLStreamReader2
        Parameters:
        name - Name of the feature of which value to get
        Returns:
        Value of the feature (possibly null), if supported; null otherwise
      • getNonTransientNamespaceContext

        public javax.xml.namespace.NamespaceContext getNonTransientNamespaceContext()
        Description copied from interface: XMLStreamReader2
        This method returns a namespace context object that contains information identical to that returned by XMLStreamReader.getNamespaceContext(), but one that is not transient. That is, one that will remain valid and unchanged after its creation. This allows the namespace context to be used independent of its source documents life cycle. One possible use case is to use this namespace context for 'initializing' writers (especially ones that use repairing mode) with optimal/preferred name space bindings.
        Specified by:
        getNonTransientNamespaceContext in interface XMLStreamReader2
        Returns:
        Non-transient namespace context as explained above.
      • getPrefixedName

        public java.lang.String getPrefixedName()
        Description copied from interface: XMLStreamReader2
        This method returns "prefix-qualified" name of the current element. In general, this means character-by-character exact name of the element in XML content, and may be useful in informational purposes, as well as when interacting with packages and APIs that use such names (such as what SAX may use as qnames).

        Note: implementations are encouraged to provide an implementation that would be more efficient than calling getLocalName and getPrefix separately, but are not required to do so. Nonetheless it is usually at least as efficient (if not more) to call this method as to do it fully in calling code.

        Specified by:
        getPrefixedName in interface XMLStreamReader2
        Returns:
        Prefix-qualified name of the current element; essentially 'prefix:localName' if the element has a prefix, or 'localName' if it does not have one (belongs to the default namespace)
      • getText

        public int getText​(java.io.Writer w,
                           boolean preserveContents)
                    throws java.io.IOException,
                           javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method similar to XMLStreamReader.getText(), except that it just uses provided Writer to write all textual content, and that it works for wider range of event types. For further optimization, it may also be allowed to do true pass-through, thus possibly avoiding one temporary copy of the data. Finally, note that this method is also guaranteed NOT to return fragments, even when coalescing is not enabled and a parser is otherwised allowed to return partial segments: this requirement is due to there being little benefit in returning such short chunks when streaming. Coalescing property is still honored normally.

        Method can only be called on states CDATA, CHARACTERS, COMMENT, DTD, ENTITY_REFERENCE, SPACE and PROCESSING_INSTRUCTION; if called when reader is in another state, IllegalStateException will be thrown. Content written for elements is same as with XMLStreamReader.getText().

        Specified by:
        getText in interface XMLStreamReader2
        Parameters:
        w - Writer to use for writing textual contents
        preserveContents - If true, reader has to preserve contents so that further calls to getText will return proper conntets. If false, reader is allowed to skip creation of such copies: this can improve performance, but it also means that further calls to getText is not guaranteed to return meaningful data.
        Returns:
        Number of characters written to the reader
        Throws:
        java.io.IOException
        javax.xml.stream.XMLStreamException
      • isEmptyElement

        public boolean isEmptyElement()
                               throws javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method that can be used to check whether current START_ELEMENT event was created for an empty element (xml short-hand notation where one tag implies start and end, ending with "/>"), or not.

        Note: method may need to read more data to know if the element is an empty one, and as such may throw an i/o or parsing exception (as XMLStreamException); however, it won't throw exceptions for non-START_ELEMENT event types.

        Specified by:
        isEmptyElement in interface XMLStreamReader2
        Returns:
        True, if current event is START_ELEMENT and is based on a parsed empty element; otherwise false
        Throws:
        javax.xml.stream.XMLStreamException
      • isPropertySupported

        public boolean isPropertySupported​(java.lang.String name)
        Description copied from interface: XMLStreamReader2
        Method similar to XMLInputFactory.isPropertySupported(java.lang.String), used to determine whether a property is supported by the Reader instance. This means that this method may return false for some properties that the input factory does support: specifically, it should only return true if the value is mutable on per-instance basis. False means that either the property is not recognized, or is not mutable via reader instance.
        Specified by:
        isPropertySupported in interface XMLStreamReader2
      • setFeature

        public void setFeature​(java.lang.String name,
                               java.lang.Object value)
        Description copied from interface: XMLStreamReader2
        Method that can be used to set per-reader features such as configuration settings; both generic ones (names for which are defined as constants in this class), and implementation dependant ones.

        Note: although some feature names are shared with XMLStreamReader2.getFeature(java.lang.String), not all are: some features are read-only, some write-only

        Specified by:
        setFeature in interface XMLStreamReader2
        Parameters:
        name - Name of the feature to set
        value - Value to set feature to.
      • setProperty

        public boolean setProperty​(java.lang.String name,
                                   java.lang.Object value)
        Description copied from interface: XMLStreamReader2
        Method that can be used to set per-reader properties; a subset of properties one can set via matching XMLInputFactory2 instance. Exactly which methods are mutable is implementation specific.
        Specified by:
        setProperty in interface XMLStreamReader2
        Parameters:
        name - Name of the property to set
        value - Value to set property to.
        Returns:
        True, if the specified property was succesfully set to specified value; false if its value was not changed
      • skipElement

        public void skipElement()
                         throws javax.xml.stream.XMLStreamException
        Description copied from interface: XMLStreamReader2
        Method that will skip all the contents of the element that the stream currently points to. Current event when calling the method has to be START_ELEMENT (or otherwise IllegalStateException is thrown); after the call the stream will point to the matching END_ELEMENT event, having skipped zero or more intervening events for the contents.
        Specified by:
        skipElement in interface XMLStreamReader2
        Throws:
        javax.xml.stream.XMLStreamException
      • setValidationProblemHandler

        public ValidationProblemHandler setValidationProblemHandler​(ValidationProblemHandler h)
        Description copied from interface: Validatable
        Method that application can call to define a custom handler for validation problems encountered during validation process.
        Specified by:
        setValidationProblemHandler in interface Validatable
        Parameters:
        h - Handler to install, if non null; if null, indicates that the default (implementation-specific) handling should be used
        Returns:
        Previously set validation problem handler, if any; null if none was set
      • stopValidatingAgainst

        public XMLValidator stopValidatingAgainst​(XMLValidator validator)
                                           throws javax.xml.stream.XMLStreamException
        Description copied from interface: Validatable
        Method that can be called by application to stop validating output using specified validator. The validator passed should be an earlier return value for a call to Validatable.validateAgainst(org.codehaus.stax2.validation.XMLValidationSchema).

        Note: the specified validator is compared for identity with validators in use, not for equality.

        Specified by:
        stopValidatingAgainst in interface Validatable
        Returns:
        Validator instance found (ie. argument validator) if it was being used for validating current document; null if not.
        Throws:
        javax.xml.stream.XMLStreamException
      • validateAgainst

        public XMLValidator validateAgainst​(XMLValidationSchema schema)
                                     throws javax.xml.stream.XMLStreamException
        Description copied from interface: Validatable
        Method that will construct a XMLValidator instance from the given schema (unless a validator for that schema has already been added), initialize it if necessary, and make validatable object (reader, writer) call appropriate validation methods from this point on until the end of the document (that is, it's not scoped with sub-trees), or until validator is removed by an explicit call to Validatable.stopValidatingAgainst(org.codehaus.stax2.validation.XMLValidationSchema).

        Note that while this method can be called at any point in output processing, validator instances are not required to be able to handle addition at other points than right before outputting the root element.

        Specified by:
        validateAgainst in interface Validatable
        Returns:
        Validator instance constructed, if validator was added, or null if a validator for the schema has already been constructed.
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeIndex

        public int getAttributeIndex​(java.lang.String namespaceURI,
                                     java.lang.String localName)
        Description copied from interface: TypedXMLStreamReader
        Returns the index of the attribute whose local name is localName and URI is namespaceURI or -1 if no such attribute exists.
        Specified by:
        getAttributeIndex in interface TypedXMLStreamReader
        Parameters:
        namespaceURI - The attribute's namespace URI. Values of null and "" are considered the same, i.e. "no namespace" (or "empty" namespace)
        localName - The attribute's local name.
        Returns:
        The attribute's index or -1 if no such attribute exists.
      • getAttributeAsBoolean

        public boolean getAttributeAsBoolean​(int index)
                                      throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an attribute value as a boolean. The lexical representation of a boolean is defined by the XML Schema boolean data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema boolean data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema boolean data type.

        Specified by:
        getAttributeAsBoolean in interface TypedXMLStreamReader
        Parameters:
        index - The attribute's index as returned by TypedXMLStreamReader.getAttributeIndex(String, String)
        Throws:
        javax.xml.stream.XMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • getAttributeAsDecimal

        public java.math.BigDecimal getAttributeAsDecimal​(int index)
                                                   throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsDecimal in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsDouble

        public double getAttributeAsDouble​(int index)
                                    throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsDouble in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsFloat

        public float getAttributeAsFloat​(int index)
                                  throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsFloat in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsInt

        public int getAttributeAsInt​(int index)
                              throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an attribute value as a boolean. The lexical representation of a boolean is defined by the XML Schema integer data type. Whitespace MUST be collapsed according to the whiteSpace facet for the type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema integer data type.

        Specified by:
        getAttributeAsInt in interface TypedXMLStreamReader
        Parameters:
        index - The attribute's index as returned by TypedXMLStreamReader.getAttributeIndex(String, String)
        Throws:
        javax.xml.stream.XMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • getAttributeAsInteger

        public java.math.BigInteger getAttributeAsInteger​(int index)
                                                   throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsInteger in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsLong

        public long getAttributeAsLong​(int index)
                                throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an attribute value as a boolean. The lexical representation of a boolean is defined by the XML Schema long data type. Whitespace MUST be collapsed according to the whiteSpace facet for the type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema long data type.

        Specified by:
        getAttributeAsLong in interface TypedXMLStreamReader
        Parameters:
        index - The attribute's index as returned by TypedXMLStreamReader.getAttributeIndex(String, String)
        Throws:
        javax.xml.stream.XMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • getAttributeAsQName

        public javax.xml.namespace.QName getAttributeAsQName​(int index)
                                                      throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsQName in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsIntArray

        public int[] getAttributeAsIntArray​(int index)
                                     throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an attribute content as an int array. The lexical representation of a int array is defined by the following XML schema type:

            <xs:simpleType name="intArray">
               <xs:list itemType="xs:int"/>
            </xs:simpleType>
        whose lexical space is a list of space-separated ints. Whitespace MUST be collapsed according to the whiteSpace facet for the intArray type shown above. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the intArray data type.
        Specified by:
        getAttributeAsIntArray in interface TypedXMLStreamReader
        Parameters:
        index - The attribute's index as returned by TypedXMLStreamReader.getAttributeIndex(String, String).
        Returns:
        An array of ints with the content.
        Throws:
        javax.xml.stream.XMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • getAttributeAsLongArray

        public long[] getAttributeAsLongArray​(int index)
                                       throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsLongArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsFloatArray

        public float[] getAttributeAsFloatArray​(int index)
                                         throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsFloatArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsDoubleArray

        public double[] getAttributeAsDoubleArray​(int index)
                                           throws javax.xml.stream.XMLStreamException
        Specified by:
        getAttributeAsDoubleArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getElementAs

        public void getElementAs​(TypedValueDecoder tvd)
                          throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Generic decoding method that can be used for efficient decoding of additional types not support natively by the typed stream reader. When method is called, stream reader will collect all textual content of the current element (effectively doing something similar to a call to XMLStreamReader.getElementText(), and then call one of decode methods defined in TypedValueDecoder. The only difference is that passed value will be trimmed: that is, any leading or trailing white space will be removed prior to calling decode method. After the call, passed decoder object will have decoded and stored value (if succesful) or thrown an exception (if not).

        The main benefit of using this method (over just getting all content by calling XMLStreamReader.getElementText() is efficiency: the stream reader can efficiently gather all textual content necessary and pass it to the decoder, often avoiding construction of intemediate Strings.

        These are the pre- and post-conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.

        Note that caller has to know more specific type of decoder, since the base interface does not specify methods for accessing actual decoded value.

        Specified by:
        getElementAs in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getElementAsBoolean

        public boolean getElementAsBoolean()
                                    throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an element content as a boolean. The lexical representation of a boolean is defined by the XML Schema boolean data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema boolean data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema boolean data type. (note: allowed lexical values are canonicals "true" and "false", as well as non-canonical "0" and "1")

        These are the pre- and post-conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.
        Specified by:
        getElementAsBoolean in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException - If unable to access content
        TypedXMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • getElementAsDecimal

        public java.math.BigDecimal getElementAsDecimal()
                                                 throws javax.xml.stream.XMLStreamException
        Specified by:
        getElementAsDecimal in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getElementAsDouble

        public double getElementAsDouble()
                                  throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an element content as a 64-bit floating point value. The lexical representation is defined by the XML Schema double data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema double data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema integer data type.
        Note that valid representations include basic Java textual representations, as well as 3 special tokens: "INF", "-INF" and "NaN"

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.
        Specified by:
        getElementAsDouble in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException - If unable to access content
        TypedXMLStreamException - If unable to convert the resulting character sequence into a Java double
      • getElementAsFloat

        public float getElementAsFloat()
                                throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an element content as a 32-bit floating point value. The lexical representation is defined by the XML Schema float data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema float data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema integer data type.
        Note that valid representations include basic Java textual representations, as well as 3 special tokens: "INF", "-INF" and "NaN"

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.
        Specified by:
        getElementAsFloat in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException - If unable to access content
        TypedXMLStreamException - If unable to convert the resulting character sequence into a Java float
      • getElementAsInt

        public int getElementAsInt()
                            throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an element content as a 32-bit integer. The lexical representation of a integer is defined by the XML Schema integer data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema integer data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema integer data type.

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.
        Specified by:
        getElementAsInt in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException - If unable to access content
        TypedXMLStreamException - If unable to convert the resulting character sequence into a Java (32-bit) integer.
      • getElementAsInteger

        public java.math.BigInteger getElementAsInteger()
                                                 throws javax.xml.stream.XMLStreamException
        Specified by:
        getElementAsInteger in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getElementAsLong

        public long getElementAsLong()
                              throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader

        Read an element content as a 64-bit integer. The lexical representation of a integer is defined by the XML Schema integer data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema integer data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema integer data type.

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is START_ELEMENT.
        • Postcondition: the current event is the corresponding END_ELEMENT.
        Specified by:
        getElementAsLong in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException - If unable to access content
        TypedXMLStreamException - If unable to convert the resulting character sequence into a Java (64-bit) integer.
      • getElementAsQName

        public javax.xml.namespace.QName getElementAsQName()
                                                    throws javax.xml.stream.XMLStreamException
        Specified by:
        getElementAsQName in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAs

        public void getAttributeAs​(int index,
                                   TypedValueDecoder tvd)
                            throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Generic access method that can be used for efficient decoding of additional types not support natively by the typed stream reader. The main benefit of using this method is that the stream reader can efficient gather all textual content necessary and pass it to the decoder, often avoiding construction of intemediate Strings.

        As with TypedXMLStreamReader.getElementAs(org.codehaus.stax2.typed.TypedValueDecoder), value passed to a decode method will be trimmed of any leading or trailing white space.

        Specified by:
        getAttributeAs in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsArray

        public int getAttributeAsArray​(int index,
                                       TypedArrayDecoder tad)
                                throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Method that allows reading contents of an attribute as an array of whitespace-separate tokens, decoded using specified decoder.
        Specified by:
        getAttributeAsArray in interface TypedXMLStreamReader
        Returns:
        Number of tokens decoded, 0 if none found
        Throws:
        javax.xml.stream.XMLStreamException
      • getAttributeAsBinary

        public byte[] getAttributeAsBinary​(int index)
                                    throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Read an attribute value as a byte array. The lexical representation of a byte array is defined by the XML Schema base64Binary data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema base64Binary data type. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the XML Schema base64Binary data type.
        Specified by:
        getAttributeAsBinary in interface TypedXMLStreamReader
        Parameters:
        index - The attribute's index as returned by TypedXMLStreamReader.getAttributeIndex(String, String).
        Returns:
        An array of bytes with the content.
        Throws:
        javax.xml.stream.XMLStreamException - If unable to convert the resulting character sequence into an XML Schema boolean value.
      • readElementAsDoubleArray

        public int readElementAsDoubleArray​(double[] value,
                                            int from,
                                            int length)
                                     throws javax.xml.stream.XMLStreamException
        Specified by:
        readElementAsDoubleArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsFloatArray

        public int readElementAsFloatArray​(float[] value,
                                           int from,
                                           int length)
                                    throws javax.xml.stream.XMLStreamException
        Specified by:
        readElementAsFloatArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsIntArray

        public int readElementAsIntArray​(int[] value,
                                         int from,
                                         int length)
                                  throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Read an element content as an int array. The lexical representation of a int array is defined by the following XML schema type:
            <xs:simpleType name="intArray">
               <xs:list itemType="xs:int"/>
            </xs:simpleType>
        whose lexical space is a list of space-separated ints. Whitespace MUST be collapsed according to the whiteSpace facet for the intArray type shown above. An exception is thrown if, after whitespace is collapsed, the resulting sequence of characters is not in the lexical space defined by the intArray data type.

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is either START_ELEMENT, or a textual event (CHARACTERS, CDATA), or END_ELEMENT (END_ELEMENT is allowed for convenience; if so, no read operation is tried, and -1 is returned immediately
        • Postcondition: the current event is the corresponding END_ELEMENT or CHARACTERS if only a portion of the array has been copied thus far.
        This method can be called multiple times until the cursor is positioned at the corresponding END_ELEMENT event. Stated differently, after the method is called for the first time, the cursor will move and remain in the CHARACTERS position while there are more bytes available for reading.
        Specified by:
        readElementAsIntArray in interface TypedXMLStreamReader
        Parameters:
        value - The array in which to copy the ints.
        from - The index in the array from which copying starts.
        length - The maximun number of ints to copy. Minimum value is 1; others an IllegalArgumentException is thrown
        Returns:
        The number of ints actually copied which must be less or equal than length, but at least one if any ints found. If not, -1 is returned to signal end of ints to parse.
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsLongArray

        public int readElementAsLongArray​(long[] value,
                                          int from,
                                          int length)
                                   throws javax.xml.stream.XMLStreamException
        Specified by:
        readElementAsLongArray in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsArray

        public int readElementAsArray​(TypedArrayDecoder tad)
                               throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Read an element content as an array of tokens. This is done by reader tokenizing textual content by white space, and sending each token to specified decoder for decoding. This is repeated as long as element content has more tokens and decoder can accept more values.

        These are the pre- and post-conditions of calling this method:

        • Precondition: the current event is either START_ELEMENT, or a textual event (CHARACTERS, CDATA), or END_ELEMENT (END_ELEMENT is allowed for convenience; if so, no read operation is tried, and -1 is returned immediately
        • Postcondition: the current event is the corresponding END_ELEMENT or CHARACTERS if only a portion of the array has been copied thus far.
        This method can be called multiple times until the cursor is positioned at the corresponding END_ELEMENT event. Stated differently, after the method is called for the first time, the cursor will move and remain in the CHARACTERS position while there are more bytes available for reading.

        Note: passed decoder must accept at least one value, reader will not verify capacity before calling it with the first token.

        Specified by:
        readElementAsArray in interface TypedXMLStreamReader
        Returns:
        Number of elements decoded, or -1 to indicate that there was no more element content tokens to decode.
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsBinary

        public int readElementAsBinary​(byte[] resultBuffer,
                                       int offset,
                                       int maxLength)
                                throws javax.xml.stream.XMLStreamException
        Specified by:
        readElementAsBinary in interface TypedXMLStreamReader
        Throws:
        javax.xml.stream.XMLStreamException
      • readElementAsBinary

        public int readElementAsBinary​(byte[] resultBuffer,
                                       int offset,
                                       int maxLength,
                                       Base64Variant v)
                                throws javax.xml.stream.XMLStreamException
        Description copied from interface: TypedXMLStreamReader
        Read element content as decoded byte sequence; possibly only reading a fragment of all element content. The lexical representation of a byte array is defined by the XML Schema base64Binary data type. Whitespace MUST be collapsed according to the whiteSpace facet for the XML Schema base64Binary data type. An exception is thrown if content is not in the lexical space defined by the XML Schema base64Binary data type.

        Each call will read at least one decoded byte (and no more than the specified maximum length), if there is any content remaining. If none is available and END_ELEMENT is encountered, -1 is returned.

        These are the pre and post conditions of calling this method:

        • Precondition: the current event is either START_ELEMENT, or a textual event (CHARACTERS, CDATA), or END_ELEMENT (END_ELEMENT is allowed for convenience; if so, no read operation is tried, and -1 is returned immediately
        • Postcondition: the current event is the corresponding END_ELEMENT, if all remaining binary content was read, or CHARACTERS if only a portion of the array was read

        Additionally, caller MUST start decoding at START_ELEMENT; if the first decode calls is at CHARACTERS or CDATA event, results are not defined: result may be an exception, or invalid data being returned. Implementations are encouraged to throw an exception if possible, to make it easier to figure out the problem.

        This method can be called multiple times until the cursor is positioned at the corresponding END_ELEMENT event. Stated differently, after the method is called for the first time, the cursor will move and remain in the CHARACTERS position while there are potentially more bytes available for reading.

        Specified by:
        readElementAsBinary in interface TypedXMLStreamReader
        Parameters:
        resultBuffer - Array in which to copy decoded bytes.
        offset - Starting offset of the first decoded byte within result buffer
        maxLength - Maximum number of bytes to decode with this call
        Returns:
        The number of bytes actually decoded and returned, if any were available; -1 if there is no more content. If any content was copied, value must be less or equal than maxLength Note that this value is not guaranteed to equal maxLength even if enough content was available; that is, implementations can return shorter sections if they choose to, down to and including returning zero (0) if it was not possible to decode a full base64 triplet (3 output bytes from 4 input characters).
        Throws:
        javax.xml.stream.XMLStreamException