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

Fields

Modifier and Type	Field and Description
protected Node	offendingNode The Node that led to the parsing error, or null.

Constructor Summary

Constructors

Constructor and Description
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

Methods

Modifier and Type	Method and Description
Node	getOffendingNode() Returns the Node that caused the error in parsing.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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.