nu.xom
Class XPathException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by nu.xom.XPathException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
XPathTypeException

public class XPathException
extends java.lang.RuntimeException

Indicates problems with XPath syntax or evaluation.

Version:
1.1b3
Author:
Elliotte Rusty Harold
See Also:
Serialized Form

Constructor Summary
XPathException(java.lang.String message)
           Creates a new XPathException with a detail message.
XPathException(java.lang.String message, java.lang.Throwable cause)
           Creates a new IllegalNameException with a detail message and an underlying root cause.
 
Method Summary
 java.lang.Throwable getCause()
           Return the original cause that led to this exception, or null if there was no original exception.
 java.lang.String getXPath()
           Returns the specific XPath expression being evaluated when this excepiton was thrown.
 java.lang.Throwable initCause(java.lang.Throwable cause)
           Sets the root cause of this exception.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

XPathException

public XPathException(java.lang.String message)

Creates a new XPathException with a detail message.

Parameters:
message - a string indicating the specific problem

XPathException

public XPathException(java.lang.String message,
                      java.lang.Throwable cause)

Creates a new IllegalNameException with a detail message and an underlying root cause.

Parameters:
message - a string indicating the specific problem
cause - the original cause of this exception
Method Detail

getCause

public java.lang.Throwable getCause()

Return the original cause that led to this exception, or null if there was no original exception.

Overrides:
getCause in class java.lang.Throwable
Returns:
the root cause of this exception

initCause

public java.lang.Throwable initCause(java.lang.Throwable cause)

Sets the root cause of this exception. This may only be called once. Subsequent calls throw an IllegalStateException.

This method is unnecessary in Java 1.4 where it could easily be inherited from the superclass. However, including it here allows this method to be used in Java 1.3 and earlier.

Overrides:
initCause in class java.lang.Throwable
Parameters:
cause - the root cause of this exception
Returns:
this XMLException
Throws:
java.lang.IllegalArgumentException - if the cause is this exception (An exception cannot be its own cause.)
java.lang.IllegalStateException - if this method is called twice

getXPath

public java.lang.String getXPath()

Returns the specific XPath expression being evaluated when this excepiton was thrown.

Returns:
the XPath expression that caused the exception


Copyright 2002-2007 Elliotte Rusty Harold
elharo@metalab.unc.edu