Package jakarta.validation

Interface ValidatorFactory

  • All Superinterfaces:
    AutoCloseable
    public interface ValidatorFactory
extends AutoCloseable
    Factory returning initialized Validator instances.

    Implementations are thread-safe and instances are typically cached and reused.

    Author:
    Emmanuel Bernard, Gunnar Morling, Hardy Ferentschik, Guillaume Smet

    • Method Detail

      • getValidator

        Validator getValidator()
        Returns an initialized Validator instance using the factory defaults for message interpolator, traversable resolver and constraint validator factory.

        Validator instances can be pooled and shared by the implementation.

        Returns:
        an initialized Validator instance

      • usingContext

        ValidatorContext usingContext()
        Defines a new validator context and returns a Validator compliant this new context.
        Returns:
        a ValidatorContext instance

      • getParameterNameProvider

        ParameterNameProvider getParameterNameProvider()
        Returns the ParameterNameProvider instance configured at initialization time for the ValidatorFactory. This is the instance used by #getValidator().
        Returns:
        ParameterNameProvider instance
        Since:
        1.1

      • getClockProvider

        ClockProvider getClockProvider()
        Returns the ClockProvider instance configured at initialization time for the ValidatorFactory. This is the instance used by #getValidator().
        Returns:
        ClockProvider instance
        Since:
        2.0

      • unwrap

        <T> T unwrap​(Class<T> type)
        Returns an instance of the specified type allowing access to provider-specific APIs. If the Jakarta Bean Validation provider implementation does not support the specified class, a ValidationException is thrown.
        Type Parameters:
        T - the type of the object to be returned
        Parameters:
        type - the class of the object to be returned
        Returns:
        an instance of the specified class
        Throws:
        ValidationException - if the provider does not support the call.

      • close

        void close()
        Closes the ValidatorFactory instance. After the ValidatorFactory instance is closed, calling the following methods is not allowed:
        • methods of this ValidatorFactory instance
        • methods of Validator instances created by this ValidatorFactory
        Specified by:
        close in interface AutoCloseable
        Since:
        1.1