org.codehaus.stax2.validation.ValidationProblemHandler Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of stax2-api Show documentation

Stax2 API is an extension to basic Stax 1.0 API that adds significant new functionality, such as full-featured bi-direction validation interface and high-performance Typed Access API.

There is a newer version: 4.2.2

Show newest version

package org.codehaus.stax2.validation;

/**
 * This interface defines method(s) needed to implement a custom validation
 * problem (warning, error, fatal error) handler. Such handlers can be used,
 * for example, to collect validation problems without automatically
 * throwing exceptions. It can also be used to throw exception for problems
 * that by default would only be reported as warnings.
 */
public interface ValidationProblemHandler
{
    /**
     * Method called by validator, when a validation problem is encountered.
     * Impementations can choose to ignore the problem, log something about
     * the problem, store it for later processing, or throw
     * a {@link XMLValidationException}.
     *
     * @param problem Validation problem encountered.
     */
    public void reportProblem(XMLValidationProblem problem)
        throws XMLValidationException;
}