javax.validation: public class: Validation

javax.validation
public class: Validation [javadoc | source]

java.lang.Object
   javax.validation.Validation

This class is the entry point for the Bean Validation framework. There are three ways to bootstrap the framework:

The easiest approach is to use the default Bean Validation provider.
```
ValidatorFactory factory = Validation.getBuilder().build();
```
In this case javax.validation.bootstrap.DefaultValidationProviderResolver will be used to locate available providers. The chosen provider is defined as followed:
- if the XML configuration defines a provider, this provider is used
- if the XML configuratio does not define a provider or if no XML configuration is present the first provider returned by the ValidationProviderResolver isntance is used.
The second bootstrap approach allows to choose a custom ValidationProviderResolver. The chosen ValidationProvider is then determined in the same way as in the default bootstrapping case (see above).
```
ValidatorFactoryBuilder<?> builder = Validation
.defineBootstrapState()
.providerResolver( new MyResolverStrategy() )
.getBuilder();
ValidatorFactory factory = builder.build();
```

The third approach allows you to specify explicitly and in a type safe fashion the expected provider by using its specific ValidatorFactoryBuilder sub-interface. Optionally you can choose a custom ValidationProviderResolver.

ACMEValidatorFactoryBuilder builder = Validation
.builderType(ACMEValidatorFactoryBuilder.class)
.providerResolver( new MyResolverStrategy() ) // optionally set the provider resolver
.getBuilder();
ValidatorFactory factory = builder.build();

Note:

The ValidatorFactory object built by the bootstrap process should be cached and shared amongst Validator consumers.
This class is thread-safe.

Also see:

DefaultValidationProviderResolver

author: Emmanuel - Bernard

author: Hardy - Feretnschik

Method from javax.validation.Validation Summary:
builderType, defineBootstrapState, getBuilder

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.validation.Validation Detail:
public static SpecializedBuilderFactory builderType(Class builderType) { return new SpecializedBuilderFactoryImpl< T >( builderType ); } Build a `ValidatorFactoryBuilder` for a particular provider implementation. Optionally override the provider resolution strategy used to determine the provider. Used by applications targeting a specific provider programmatically. ACMEValidatorFactoryBuilder builder = Validation.builderType(ACMEValidatorFactoryBuilder.class) .providerResolver( new MyResolverStrategy() ) .build(); , where `ACMEValidatorFactoryBuilder` is the `ValidatorFactoryBuilder` sub interface uniquely identifying the ACME Bean Validation provider.
public static GenericBuilderFactory defineBootstrapState() { return new GenericBuilderFactoryImpl(); } Build a `ValidatorFactoryBuilder`. The provider list is resolved using the strategy provided to the bootstrap state. ValidatorFactoryBuilder<?> builder = Validation .defineBootstrapState() .providerResolver( new MyResolverStrategy() ) .getBuilder(); ValidatorFactory factory = builder.build(); The actual provider choice is given by the XML configuration. If the XML configuration does not exsist the first available provider will be returned.
public static ValidatorFactoryBuilder getBuilder() { return defineBootstrapState().getBuilder(); } Build a `ValidatorFactoryBuilder`. The actual provider choice is given by the XML configuration. If the XML configuration does not exsist the default is taken. The provider list is resolved using the javax.validation.bootstrap.DefaultValidationProviderResolver .

Method from javax.validation.Validation Detail:

 public static SpecializedBuilderFactory builderType(Class builderType) {
		return new SpecializedBuilderFactoryImpl< T >( builderType );
}

ValidatorFactoryBuilder

Used by applications targeting a specific provider programmatically.

ACMEValidatorFactoryBuilder builder = Validation.builderType(ACMEValidatorFactoryBuilder.class)
.providerResolver( new MyResolverStrategy() )
.build();

ACMEValidatorFactoryBuilder

ValidatorFactoryBuilder

 public static GenericBuilderFactory defineBootstrapState() {
		return new GenericBuilderFactoryImpl();
}

ValidatorFactoryBuilder

ValidatorFactoryBuilder<?> builder = Validation
.defineBootstrapState()
.providerResolver( new MyResolverStrategy() )
.getBuilder();
ValidatorFactory factory = builder.build();

 public static ValidatorFactoryBuilder getBuilder() {
		return defineBootstrapState().getBuilder();
}

ValidatorFactoryBuilder

The provider list is resolved using the javax.validation.bootstrap.DefaultValidationProviderResolver .