org.exolab.castor.xml
Class ValidationException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.exolab.castor.core.exceptions.CastorException
              org.exolab.castor.xml.XMLException
                  org.exolab.castor.xml.ValidationException

All Implemented Interfaces:

java.io.Serializable

public class ValidationException
extends XMLException

An exception that can be used to signal XML validation errors

Version:

$Revision: 1.4 $ $Date: 2004/10/05 20:25:24 $

Author:

Keith Visco

See Also:

Serialized Form

Constructor Summary

ValidationException()
Creates a new ValidationException with no message, or nested Exception

ValidationException(java.lang.String message)
Creates a new ValidationException with the given message.

ValidationException(java.lang.String message, java.lang.Exception exception, int errorCode)
Creates a new ValidationException with the given message, nested exception, and errorCode.

ValidationException(java.lang.String message, int errorCode)
Creates a new ValidationException with the given message.

ValidationException(java.lang.String message, java.lang.Throwable exception)
Creates a new ValidationException with the given message and nested exception.

ValidationException(java.lang.Throwable exception)
Creates a new ValidationException with the given nested exception.

Method Summary

Location	getLocation() Returns the location of the exception
ValidationException	getNext() Returns the next ValidationException in the list, or null if no additional validation exceptions exist.
protected boolean	remove(ValidationException exception) Removes the given ValidationException from the current list of ValidationException.
protected void	setLast(ValidationException exception) Adds the given ValidationException as the last exception in the list.
void	setLocation(Location location) Sets the location information for this ValidationException
protected void	setNext(ValidationException exception) Sets the given ValidationException as the next exception in the list.
java.lang.String	toString() Returns the String representation of this Exception

Methods inherited from class org.exolab.castor.xml.XMLException

getErrorCode, setErrorCode

Methods inherited from class org.exolab.castor.core.exceptions.CastorException

getCause, getException, getMessage, initCause, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ValidationException

public ValidationException()

Creates a new ValidationException with no message, or nested Exception

ValidationException

public ValidationException(java.lang.String message)

Creates a new ValidationException with the given message.

Parameters:

message - the message for this Exception

ValidationException

public ValidationException(java.lang.String message,
                           int errorCode)

Creates a new ValidationException with the given message.

Parameters:

message - the message for this Exception

errorCode - the errorCode for this Exception

ValidationException

public ValidationException(java.lang.Throwable exception)

Creates a new ValidationException with the given nested exception.

Parameters:

exception - the nested exception

ValidationException

public ValidationException(java.lang.String message,
                           java.lang.Throwable exception)

Creates a new ValidationException with the given message and nested exception.

Parameters:

message - the detail message for this exception

exception - the nested exception

ValidationException

public ValidationException(java.lang.String message,
                           java.lang.Exception exception,
                           int errorCode)

Creates a new ValidationException with the given message, nested exception, and errorCode.

Parameters:

message - the detail message for this exception

exception - the nested exception

errorCode - the errorCode for this Exception

Method Detail

getLocation

public Location getLocation()

Returns the location of the exception

Returns:

the location of the exception

getNext

public ValidationException getNext()

Returns the next ValidationException in the list, or null if no additional validation exceptions exist.

Returns:

the next ValidationException in the list, or null if there are no additional exceptions.

setLocation

public void setLocation(Location location)

Sets the location information for this ValidationException

Overrides:

setLocation in class XMLException

Parameters:

location, - the location information for this validation exception

remove

protected boolean remove(ValidationException exception)

Removes the given ValidationException from the current list of ValidationException.

Parameters:

exception - the ValidationException to remove

Returns:

true if the given ValidationException was successfully removed.

setLast

protected void setLast(ValidationException exception)

Adds the given ValidationException as the last exception in the list. This is equivalent to calling #setNext if no additional ValidationException(s) exist.

Parameters:

exception - the ValidationException to set as the last exception in the list.

setNext

protected void setNext(ValidationException exception)

Sets the given ValidationException as the next exception in the list. This method will overwrite any existing ValidationException that may already exist as the next exception.

Parameters:

exception - the ValidationException to set as the next exception in the list.

toString

public java.lang.String toString()

Returns the String representation of this Exception

Overrides:

toString in class XMLException

Returns:

the String representation of this Exception