org.apache.axiom.om
Class OMHierarchyException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by org.apache.axiom.om.OMException
                  extended by org.apache.axiom.om.OMHierarchyException
All Implemented Interfaces:
Serializable

public class OMHierarchyException
extends OMException

Thrown if an object model operation would lead to a hierarchy that is not allowed in the given object model implementation.

If this exception is encountered by a builder when creating an OM node from an event received by the parser and if the corresponding content can be ignored (i.e. is not semantically relevant), the builder should ignore the exception and skip the event. An example is whitespace appearing before or after the root element of a document. This would be represented as an OMText node below the OMDocument. If the OM implementation doesn't allow text nodes as children of a document (as for example in DOM), it should throw this exception so that the builder can discard the event.

See Also:
Serialized Form

Constructor Summary
OMHierarchyException(String message)
           
 
Method Summary
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

OMHierarchyException

public OMHierarchyException(String message)


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