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.