/*
 * Jakarta Bean Validation API
 *
 * License: Apache License, Version 2.0
 * See the license.txt file in the root directory or <http://www.apache.org/licenses/LICENSE-2.0>.
 */
package javax.validation.bootstrap;

import javax.validation.Configuration;
import javax.validation.NoProviderFoundException;
import javax.validation.ValidationException;
import javax.validation.ValidationProviderResolver;
import javax.validation.ValidatorFactory;

Defines the state used to bootstrap Jakarta Bean Validation and creates a provider agnostic Configuration. 
Author:
Emmanuel Bernard/**
 * Defines the state used to bootstrap Jakarta Bean Validation and
 * creates a provider agnostic {@link Configuration}.
 *
 * @author Emmanuel Bernard
 */
public interface GenericBootstrap {

	
Defines the provider resolution strategy. This resolver returns the list of providers evaluated to build the Configuration. 
 If no resolver is defined, the default ValidationProviderResolver implementation is used. 
Params:
resolver – the ValidationProviderResolver to use for bootstrapping
Returns:
this following the chaining method pattern/**
	 * Defines the provider resolution strategy.
	 * This resolver returns the list of providers evaluated
	 * to build the {@link Configuration}.
	 * <p>
	 * If no resolver is defined, the default {@link ValidationProviderResolver}
	 * implementation is used.
	 *
	 * @param resolver the {@code ValidationProviderResolver} to use for bootstrapping
	 * @return {@code this} following the chaining method pattern
	 */
	GenericBootstrap providerResolver(ValidationProviderResolver resolver);

	
Returns a generic Configuration implementation. At this stage the provider used to build the ValidatorFactory is not defined. 
 The Configuration implementation is provided by the first provider returned by the ValidationProviderResolver strategy. 
Throws:
NoProviderFoundException – if no Jakarta Bean Validation provider was found
ValidationException – if a Jakarta Bean Validation provider was found but the Configuration object cannot be built; this is generally due to an issue with the ValidationProviderResolver
Returns:
a Configuration implementation compliant with the bootstrap state/**
	 * Returns a generic {@link Configuration} implementation.
	 * At this stage the provider used to build the {@link ValidatorFactory}
	 * is not defined.
	 * <p>
	 * The {@code Configuration} implementation is provided by the first provider
	 * returned by the {@link ValidationProviderResolver} strategy.
	 *
	 * @return a {@code Configuration} implementation compliant with the bootstrap state
	 * @throws NoProviderFoundException if no Jakarta Bean Validation provider was found
	 * @throws ValidationException if a Jakarta Bean Validation provider was found but the
	 *         {@code Configuration} object cannot be built; this is generally due to an
	 *         issue with the {@code ValidationProviderResolver}
	 */
	Configuration<?> configure();
}