javax.imageio.metadata
Class IIOInvalidTreeException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.io.IOException
                    |
                    +--javax.imageio.IIOException
                          |
                          +--javax.imageio.metadata.IIOInvalidTreeException
All Implemented Interfaces:
Serializable
public class IIOInvalidTreeException
extends IIOException

An IIOInvalidTreeException is thrown when an attempt by an IIOMetadata object to parse a tree of IIOMetadataNodes fails. The node that led to the parsing error may be stored. As with any parsing error, the actual error may occur at a different point that that where it is detected. The node returned by getOffendingNode should merely be considered as a clue to the actual nature of the problem.

See Also:
IIOMetadata.setFromTree(java.lang.String, org.w3c.dom.Node), IIOMetadata.mergeTree(java.lang.String, org.w3c.dom.Node), IIOMetadataNode, Serialized Form

 

Field Summary

protected  Node offendingNode
    The Node that led to the parsing error, or null.
 

 

Constructor Summary

IIOInvalidTreeException(String message, Node offendingNode)
    Constructs an IIOInvalidTreeException with a message string and a reference to the Node that caused the parsing error.
IIOInvalidTreeException(String message, Throwable cause, Node offendingNode)
    Constructs an IIOInvalidTreeException with a message string, a reference to an exception that caused this exception, and a reference to the Node that caused the parsing error.
 

 

Method Summary

 Node getOffendingNode()
    Returns the Node that caused the error in parsing.
 
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
 

 

Field Detail

 

offendingNode

protected Node offendingNode
The Node that led to the parsing error, or null.

 

Constructor Detail

 

IIOInvalidTreeException

public IIOInvalidTreeException(String message,
                               Node offendingNode)
Constructs an IIOInvalidTreeException with a message string and a reference to the Node that caused the parsing error.

Parameters:
message - a String containing the reason for the parsing failure.
offendingNode - the DOM Node that caused the exception, or null.

 

IIOInvalidTreeException

public IIOInvalidTreeException(String message,
                               Throwable cause,
                               Node offendingNode)
Constructs an IIOInvalidTreeException with a message string, a reference to an exception that caused this exception, and a reference to the Node that caused the parsing error.

Parameters:
message - a String containing the reason for the parsing failure.
cause - the Throwable (Error or Exception) that caused this exception to occur, or null.
offendingNode - the DOM Node that caused the exception, or null.

 

Method Detail

 

getOffendingNode

public Node getOffendingNode()
Returns the Node that caused the error in parsing.

Returns:
the offending Node.