Class TypeConstraintException

All Implemented Interfaces:
Serializable

public class TypeConstraintException extends RuntimeException
This exception indicates that a violation of a dynamically checked type constraint was detected.

This exception can be thrown by the generated setter methods of the schema derived Java content classes. However, since fail-fast validation is an optional feature for Jakarta XML Binding Providers to support, not all setter methods will throw this exception when a type constraint is violated.

If this exception is throw while invoking a fail-fast setter, the value of the property is guaranteed to remain unchanged, as if the setter were never called.

Since:
1.6, JAXB 1.0
Author:
  • Ryan Shoemaker, Sun Microsystems, Inc.
  • Joe Fialli, Sun Microsystems, Inc.
See Also:
  • Constructor Details

    • TypeConstraintException

      public TypeConstraintException(String message)
      Construct a TypeConstraintException with the specified detail message. The errorCode and linkedException will default to null.
      Parameters:
      message - a description of the exception
    • TypeConstraintException

      public TypeConstraintException(String message, String errorCode)
      Construct a TypeConstraintException with the specified detail message and vendor specific errorCode. The linkedException will default to null.
      Parameters:
      message - a description of the exception
      errorCode - a string specifying the vendor specific error code
    • TypeConstraintException

      public TypeConstraintException(Throwable exception)
      Construct a TypeConstraintException with a linkedException. The detail message and vendor specific errorCode will default to null.
      Parameters:
      exception - the linked exception
    • TypeConstraintException

      public TypeConstraintException(String message, Throwable exception)
      Construct a TypeConstraintException with the specified detail message and linkedException. The errorCode will default to null.
      Parameters:
      message - a description of the exception
      exception - the linked exception
    • TypeConstraintException

      public TypeConstraintException(String message, String errorCode, Throwable exception)
      Construct a TypeConstraintException with the specified detail message, vendor specific errorCode, and linkedException.
      Parameters:
      message - a description of the exception
      errorCode - a string specifying the vendor specific error code
      exception - the linked exception
  • Method Details

    • getErrorCode

      public String getErrorCode()
      Get the vendor specific error code
      Returns:
      a string specifying the vendor specific error code
    • getLinkedException

      public Throwable getLinkedException()
      Get the linked exception
      Returns:
      the linked Exception, null if none exists
    • setLinkedException

      public void setLinkedException(Throwable exception)
      Add a linked Exception.
      Parameters:
      exception - the linked Exception (A null value is permitted and indicates that the linked exception does not exist or is unknown).
    • toString

      public String toString()
      Returns a short description of this TypeConstraintException.
      Overrides:
      toString in class Throwable
    • printStackTrace

      public void printStackTrace(PrintStream s)
      Prints this TypeConstraintException and its stack trace (including the stack trace of the linkedException if it is non-null) to the PrintStream.
      Overrides:
      printStackTrace in class Throwable
      Parameters:
      s - PrintStream to use for output
    • printStackTrace

      public void printStackTrace()
      Prints this TypeConstraintException and its stack trace (including the stack trace of the linkedException if it is non-null) to System.err.
      Overrides:
      printStackTrace in class Throwable