Interface Validatable

    • Method Detail

      • validateAgainst

        XMLValidator validateAgainst​(XMLValidationSchema schema)
                              throws javax.xml.stream.XMLStreamException
        Method that will construct a XMLValidator instance from the given schema (unless a validator for that schema has already been added), initialize it if necessary, and make validatable object (reader, writer) call appropriate validation methods from this point on until the end of the document (that is, it's not scoped with sub-trees), or until validator is removed by an explicit call to stopValidatingAgainst(org.codehaus.stax2.validation.XMLValidationSchema).

        Note that while this method can be called at any point in output processing, validator instances are not required to be able to handle addition at other points than right before outputting the root element.

        Returns:
        Validator instance constructed, if validator was added, or null if a validator for the schema has already been constructed.
        Throws:
        javax.xml.stream.XMLStreamException
      • stopValidatingAgainst

        XMLValidator stopValidatingAgainst​(XMLValidator validator)
                                    throws javax.xml.stream.XMLStreamException
        Method that can be called by application to stop validating output using specified validator. The validator passed should be an earlier return value for a call to validateAgainst(org.codehaus.stax2.validation.XMLValidationSchema).

        Note: the specified validator is compared for identity with validators in use, not for equality.

        Returns:
        Validator instance found (ie. argument validator) if it was being used for validating current document; null if not.
        Throws:
        javax.xml.stream.XMLStreamException
      • setValidationProblemHandler

        ValidationProblemHandler setValidationProblemHandler​(ValidationProblemHandler h)
        Method that application can call to define a custom handler for validation problems encountered during validation process.
        Parameters:
        h - Handler to install, if non null; if null, indicates that the default (implementation-specific) handling should be used
        Returns:
        Previously set validation problem handler, if any; null if none was set