Class ValidationException

  • All Implemented Interfaces:
    java.io.Serializable, javax.xml.transform.SourceLocator, org.xml.sax.Locator

    public class ValidationException
    extends XPathException
    implements javax.xml.transform.SourceLocator, org.xml.sax.Locator
    This exception indicates a failure when validating an instance against a type defined in a schema.
    See Also:
    Serialized Form
    • Constructor Detail

      • 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.Exception exception)
        Creates a new ValidationException with the given nested exception.
        Parameters:
        exception - the nested exception
      • ValidationException

        public ValidationException​(java.lang.String message,
                                   java.lang.Exception 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,
                                   javax.xml.transform.SourceLocator locator)
        Create a new ValidationException from a message and a Locator.
        Parameters:
        message - The error or warning message.
        locator - The locator object for the error or warning.
    • Method Detail

      • setConstraintReference

        public void setConstraintReference​(int schemaPart,
                                           java.lang.String constraintName,
                                           java.lang.String clause)
        Set a reference to the constraint in XML Schema that is not satisfied
        Parameters:
        schemaPart - - 1 or 2, depending whether the constraint is in XMLSchema part 1 or part 2
        constraintName - - the short name of the constraint in XMLSchema, as a fragment identifier in the HTML of the XML Schema Part 1 specification
        clause - - the clause number within the description of that constraint
      • getConstraintReferenceMessage

        public java.lang.String getConstraintReferenceMessage()
        Get the constraint reference as a string for inserting into an error message.
        Returns:
        the reference as a message, or null if no information is available
      • getConstraintSchemaPart

        public int getConstraintSchemaPart()
        Get the "schema part" component of the constraint reference
        Returns:
        1 or 2 depending on whether the violated constraint is in XML Schema Part 1 or Part 2; or -1 if there is no constraint reference
      • getConstraintName

        public java.lang.String getConstraintName()
        Get the constraint name
        Returns:
        the name of the violated constraint, in the form of a fragment identifier within the published XML Schema specification; or null if the information is not available.
      • getConstraintClauseNumber

        public java.lang.String getConstraintClauseNumber()
        Get the constraint clause number
        Returns:
        the section number of the clause containing the constraint that has been violated. Generally a decimal number in the form n.n.n; possibly a sequence of such numbers separated by semicolons. Or null if the information is not available.
      • getConstraintReference

        public java.lang.String getConstraintReference()
        Get the constraint name and clause in the format defined in XML Schema Part C (Outcome Tabulations). This mandates the format validation-rule-name.clause-number
        Returns:
        the constraint reference, for example "cos-ct-extends.1.2"; or null if the reference is not known.
      • toString

        public java.lang.String toString()
        Returns the String representation of this Exception
        Overrides:
        toString in class java.lang.Throwable
        Returns:
        the String representation of this Exception
      • getPublicId

        public java.lang.String getPublicId()
        Specified by:
        getPublicId in interface org.xml.sax.Locator
        Specified by:
        getPublicId in interface javax.xml.transform.SourceLocator
      • getSystemId

        public java.lang.String getSystemId()
        Specified by:
        getSystemId in interface org.xml.sax.Locator
        Specified by:
        getSystemId in interface javax.xml.transform.SourceLocator
      • getLineNumber

        public int getLineNumber()
        Specified by:
        getLineNumber in interface org.xml.sax.Locator
        Specified by:
        getLineNumber in interface javax.xml.transform.SourceLocator
      • getColumnNumber

        public int getColumnNumber()
        Specified by:
        getColumnNumber in interface org.xml.sax.Locator
        Specified by:
        getColumnNumber in interface javax.xml.transform.SourceLocator
      • setPublicId

        public void setPublicId​(java.lang.String id)
      • setSystemId

        public void setSystemId​(java.lang.String id)
      • setLineNumber

        public void setLineNumber​(int line)
      • setColumnNumber

        public void setColumnNumber​(int column)
      • setLocator

        public void setLocator​(org.xml.sax.Locator locator)
      • setSourceLocator

        public void setSourceLocator​(javax.xml.transform.SourceLocator locator)
      • getLocator

        public javax.xml.transform.SourceLocator getLocator()
        Overrides:
        getLocator in class javax.xml.transform.TransformerException