org.apache.axiom.om.util
Class OMXMLStreamReaderValidator

java.lang.Object
  extended by org.apache.axiom.om.util.OMXMLStreamReaderValidator
All Implemented Interfaces:
XMLStreamConstants, XMLStreamReader, OMAttachmentAccessor, OMXMLStreamReader

public class OMXMLStreamReaderValidator
extends Object
implements OMXMLStreamReader

There are several places in the code where events are passed from a source to a consumer using XMLStreamReader events. OMXMLStreamReader (impl)--> consumer of XMLStreamReader events This simple class can be interjected as a filter and used to do some simple validation. Validating the events coming from source (impl) can help find and correct errors when they occur. Otherwise the errors may be caught much further downstream and hard to fix. OMXMLStreamReader (impl)--> OMXMLStreamReaderValiator-> consumer of XMLStreamReader events In the initial version, the XMStreamValidator ensures that the start element events match the end element events.

See Also:
OMElement.getXMLStreamReader(boolean)

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
 
Constructor Summary
OMXMLStreamReaderValidator(OMXMLStreamReader delegate, boolean throwExceptions)
           
 
Method Summary
 void close()
           
 int getAttributeCount()
           
 String getAttributeLocalName(int arg0)
           
 QName getAttributeName(int arg0)
           
 String getAttributeNamespace(int arg0)
           
 String getAttributePrefix(int arg0)
           
 String getAttributeType(int arg0)
           
 String getAttributeValue(int arg0)
           
 String getAttributeValue(String arg0, String arg1)
           
 String getCharacterEncodingScheme()
           
 DataHandler getDataHandler(String blobcid)
           
 String getElementText()
           
 String getEncoding()
           
 int getEventType()
           
 String getLocalName()
           
 Location getLocation()
           
 QName getName()
           
 NamespaceContext getNamespaceContext()
           
 int getNamespaceCount()
           
 String getNamespacePrefix(int arg0)
           
 String getNamespaceURI()
           
 String getNamespaceURI(int arg0)
           
 String getNamespaceURI(String arg0)
           
 String getPIData()
           
 String getPITarget()
           
 String getPrefix()
           
 Object getProperty(String arg0)
           
 String getText()
           
 char[] getTextCharacters()
           
 int getTextCharacters(int arg0, char[] arg1, int arg2, int arg3)
           
 int getTextLength()
           
 int getTextStart()
           
 String getVersion()
           
 boolean hasName()
           
 boolean hasNext()
           
 boolean hasText()
           
 boolean isAttributeSpecified(int arg0)
           
 boolean isCharacters()
           
 boolean isEndElement()
           
 boolean isInlineMTOM()
          By default, an OMText item that has an MTOM datahandler will be rendered as a inlined text event.
 boolean isStandalone()
           
 boolean isStartElement()
           
 boolean isWhiteSpace()
           
protected  void logParserState()
          Dump the current event of the delegate.
 int next()
           
 int nextTag()
           
 void require(int arg0, String arg1, String arg2)
           
 void setInlineMTOM(boolean value)
           
 boolean standaloneSet()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

OMXMLStreamReaderValidator

public OMXMLStreamReaderValidator(OMXMLStreamReader delegate,
                                  boolean throwExceptions)
Parameters:
delegate - XMLStreamReader to validate
throwExceptions - (true if exceptions should be thrown when errors are encountered)
Method Detail

next

public int next()
         throws XMLStreamException
Specified by:
next in interface XMLStreamReader
Throws:
XMLStreamException

close

public void close()
           throws XMLStreamException
Specified by:
close in interface XMLStreamReader
Throws:
XMLStreamException

getAttributeCount

public int getAttributeCount()
Specified by:
getAttributeCount in interface XMLStreamReader

getAttributeLocalName

public String getAttributeLocalName(int arg0)
Specified by:
getAttributeLocalName in interface XMLStreamReader

getAttributeName

public QName getAttributeName(int arg0)
Specified by:
getAttributeName in interface XMLStreamReader

getAttributeNamespace

public String getAttributeNamespace(int arg0)
Specified by:
getAttributeNamespace in interface XMLStreamReader

getAttributePrefix

public String getAttributePrefix(int arg0)
Specified by:
getAttributePrefix in interface XMLStreamReader

getAttributeType

public String getAttributeType(int arg0)
Specified by:
getAttributeType in interface XMLStreamReader

getAttributeValue

public String getAttributeValue(int arg0)
Specified by:
getAttributeValue in interface XMLStreamReader

getAttributeValue

public String getAttributeValue(String arg0,
                                String arg1)
Specified by:
getAttributeValue in interface XMLStreamReader

getCharacterEncodingScheme

public String getCharacterEncodingScheme()
Specified by:
getCharacterEncodingScheme in interface XMLStreamReader

getElementText

public String getElementText()
                      throws XMLStreamException
Specified by:
getElementText in interface XMLStreamReader
Throws:
XMLStreamException

getEncoding

public String getEncoding()
Specified by:
getEncoding in interface XMLStreamReader

getEventType

public int getEventType()
Specified by:
getEventType in interface XMLStreamReader

getLocalName

public String getLocalName()
Specified by:
getLocalName in interface XMLStreamReader

getLocation

public Location getLocation()
Specified by:
getLocation in interface XMLStreamReader

getName

public QName getName()
Specified by:
getName in interface XMLStreamReader

getNamespaceContext

public NamespaceContext getNamespaceContext()
Specified by:
getNamespaceContext in interface XMLStreamReader

getNamespaceCount

public int getNamespaceCount()
Specified by:
getNamespaceCount in interface XMLStreamReader

getNamespacePrefix

public String getNamespacePrefix(int arg0)
Specified by:
getNamespacePrefix in interface XMLStreamReader

getNamespaceURI

public String getNamespaceURI()
Specified by:
getNamespaceURI in interface XMLStreamReader

getNamespaceURI

public String getNamespaceURI(int arg0)
Specified by:
getNamespaceURI in interface XMLStreamReader

getNamespaceURI

public String getNamespaceURI(String arg0)
Specified by:
getNamespaceURI in interface XMLStreamReader

getPIData

public String getPIData()
Specified by:
getPIData in interface XMLStreamReader

getPITarget

public String getPITarget()
Specified by:
getPITarget in interface XMLStreamReader

getPrefix

public String getPrefix()
Specified by:
getPrefix in interface XMLStreamReader

getProperty

public Object getProperty(String arg0)
                   throws IllegalArgumentException
Specified by:
getProperty in interface XMLStreamReader
Throws:
IllegalArgumentException

getText

public String getText()
Specified by:
getText in interface XMLStreamReader

getTextCharacters

public char[] getTextCharacters()
Specified by:
getTextCharacters in interface XMLStreamReader

getTextCharacters

public int getTextCharacters(int arg0,
                             char[] arg1,
                             int arg2,
                             int arg3)
                      throws XMLStreamException
Specified by:
getTextCharacters in interface XMLStreamReader
Throws:
XMLStreamException

getTextLength

public int getTextLength()
Specified by:
getTextLength in interface XMLStreamReader

getTextStart

public int getTextStart()
Specified by:
getTextStart in interface XMLStreamReader

getVersion

public String getVersion()
Specified by:
getVersion in interface XMLStreamReader

hasName

public boolean hasName()
Specified by:
hasName in interface XMLStreamReader

hasNext

public boolean hasNext()
                throws XMLStreamException
Specified by:
hasNext in interface XMLStreamReader
Throws:
XMLStreamException

hasText

public boolean hasText()
Specified by:
hasText in interface XMLStreamReader

isAttributeSpecified

public boolean isAttributeSpecified(int arg0)
Specified by:
isAttributeSpecified in interface XMLStreamReader

isCharacters

public boolean isCharacters()
Specified by:
isCharacters in interface XMLStreamReader

isEndElement

public boolean isEndElement()
Specified by:
isEndElement in interface XMLStreamReader

isStandalone

public boolean isStandalone()
Specified by:
isStandalone in interface XMLStreamReader

isStartElement

public boolean isStartElement()
Specified by:
isStartElement in interface XMLStreamReader

isWhiteSpace

public boolean isWhiteSpace()
Specified by:
isWhiteSpace in interface XMLStreamReader

nextTag

public int nextTag()
            throws XMLStreamException
Specified by:
nextTag in interface XMLStreamReader
Throws:
XMLStreamException

require

public void require(int arg0,
                    String arg1,
                    String arg2)
             throws XMLStreamException
Specified by:
require in interface XMLStreamReader
Throws:
XMLStreamException

standaloneSet

public boolean standaloneSet()
Specified by:
standaloneSet in interface XMLStreamReader

logParserState

protected void logParserState()
Dump the current event of the delegate.


getDataHandler

public DataHandler getDataHandler(String blobcid)
Specified by:
getDataHandler in interface OMAttachmentAccessor
Parameters:
blobcid - (without the surrounding angle brackets and "cid:" prefix)
Returns:
The DataHandler of the mime part referred by the Content-Id or *null* if the mime part referred by the content-id does not exist

isInlineMTOM

public boolean isInlineMTOM()
Description copied from interface: OMXMLStreamReader
By default, an OMText item that has an MTOM datahandler will be rendered as a inlined text event.

Specified by:
isInlineMTOM in interface OMXMLStreamReader
Returns:
true if inlined as TEXT, false if XOP_INCLUDE is used

setInlineMTOM

public void setInlineMTOM(boolean value)
Specified by:
setInlineMTOM in interface OMXMLStreamReader
Parameters:
value - set to true if inlining of text is desired (default) throw OMException if not the value is not supported.


Copyright © 2004-2010 The Apache Software Foundation. All Rights Reserved.