# Package javax.validation

Top level package of the Bean Validation API.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  BootstrapConfiguration | Represents the user specified default configuration in `META-INF/validation.xml`.
  Configuration<T extends Configuration<T>> | Receives configuration information, selects the appropriate Bean Validation provider and builds the appropriate `ValidatorFactory`.
  ConstraintValidator<A extends Annotation,T> | Defines the logic to validate a given constraint `A` for a given object type `T`.
  ConstraintValidatorContext | Provides contextual data and operation when applying a given constraint validator.
  ConstraintValidatorContext.ConstraintViolationBuilder | `ConstraintViolation` builder allowing to optionally associate the violation report to a sub path.
  ConstraintValidatorContext.ConstraintViolationBuilder.LeafNodeBuilderCustomizableContext | Represents a node whose context is configurable (i.e.
  ConstraintValidatorContext.ConstraintViolationBuilder.LeafNodeBuilderDefinedContext | Represents a node whose context is known (i.e.
  ConstraintValidatorContext.ConstraintViolationBuilder.LeafNodeContextBuilder | Represents refinement choices for a node which is in an `Iterator` or `Map`.
  ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext | Represents a node whose context is configurable (i.e.
  ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext | Represents a node whose context is known (i.e.
  ConstraintValidatorContext.ConstraintViolationBuilder.NodeContextBuilder | Represents refinement choices for a node which is in an `Iterator` or `Map`.
  ConstraintValidatorFactory | Instantiates a `ConstraintValidator` instance based off its class.
  ConstraintViolation<T> | Describes a constraint violation.
  MessageInterpolator | Interpolates a given constraint violation message.
  MessageInterpolator.Context | Information related to the interpolation context.
  ParameterNameProvider | Provides names for method and constructor parameters.
  Path | Represents the navigation path from an object to another in an object graph.
  Path.BeanNode | Node representing a bean.
  Path.ConstructorNode | Node representing a constructor.
  Path.CrossParameterNode | Node representing the element holding cross-parameter constraints of a method or constructor.
  Path.MethodNode | Node representing a method.
  Path.Node | Represents an element of a navigation path.
  Path.ParameterNode | Node representing a parameter of a method or constructor.
  Path.PropertyNode | Node representing a property.
  Path.ReturnValueNode | Node representing the return value of a method or constructor.
  Payload | Payload type that can be attached to a given constraint declaration.
  TraversableResolver | Contract determining if a property can be accessed by the Bean Validation provider.
  ValidationProviderResolver | Determines the list of Bean Validation providers available in the runtime environment Bean Validation providers are identified by the presence of `META-INF/services/javax.validation.spi.ValidationProvider` files following the Service Provider pattern described here.
  Validator | Validates bean instances.
  ValidatorContext | Represents the context that is used to create `Validator` instances.
  ValidatorFactory | Factory returning initialized `Validator` instances.

- Class Summary
  Class | Description
  --- | ---
  Validation | This class is the entry point for Bean Validation.

- Enum Summary
  Enum | Description
  --- | ---
  ConstraintTarget | Defines the constraint target.
  ElementKind | Enum of possible kinds of elements encountered in Bean Validation.

- Exception Summary
  Exception | Description
  --- | ---
  ConstraintDeclarationException | Exception raised if a constraint declaration is not legal.
  ConstraintDefinitionException | Exception raised if a constraint definition is not legal.
  ConstraintViolationException | Reports the result of constraint violations.
  GroupDefinitionException | Exception raised if a group definition is not legal.
  UnexpectedTypeException | Exception raised in the case that the constraint validator resolution cannot determine a suitable validator for a given type.
  ValidationException | Base exception of all Bean Validation "unexpected" problems.

- Annotation Types Summary
  Annotation Type | Description
  --- | ---
  Constraint | Marks an annotation as being a Bean Validation constraint.
  GroupSequence | Defines group sequence.
  OverridesAttribute | Marks an attribute as overriding the attribute of a composing constraint.
  OverridesAttribute.List | Defines several `OverridesAttribute` annotations on the same element
  ReportAsSingleViolation | A constraint annotation hosting this annotation will return the composed annotation error report if any of the composing annotations fail.
  Valid | Marks a property, method parameter or method return type for validation cascading.

## Package javax.validation Description

Top level package of the Bean Validation API. The main runtime artifacts are:

- `Validation`: the entry point to bootstrap Bean Validation
- `ValidatorFactory`: the bootstrapped Bean Validation engine
- `Validator`: contract to validate beans and access the metadata
- `ConstraintViolation`: constraint violation report

The main constraint definition artifacts are:

- `Constraint`: annotation marking an annotation as being a constraint
- `ConstraintValidator`: interface implemented by the piece of code validating a given constraint
- `ReportAsSingleViolation`: marks a composed constraint as returning a single constraint violation report

The main constraint declaration artifacts are:

- `Valid`: annotation marking an association as cascaded during validation
- `GroupSequence`: defines a sequence of groups that should be validated sequentially

Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.