Изучаем Java EE 7 - [44]
>@ChronologicalDates(groups = Delivery.class)
>public class Order {
>··@NotNull
>··private Long id;
>··@NotNull @Past
>··private Date creationDate;
>··private Double totalAmount;
>··@NotNull(groups = Payment.class) @Past(groups = Payment.class)
>··private Date paymentDate;
>··@NotNull(groups = Delivery.class) @Past(groups = Delivery.class)
>··private Date deliveryDate;
>··private List
>··// Конструкторы, геттеры, сеттеры
>}
Как видите, в ходе валидации вам всего лишь следует явно указать, какие именно группы вы хотите проверить, и поставщик валидации из Bean Validation выполнит частичную проверку.
Дескрипторы развертывания
Как и большинство других технологий, входящих в состав Java EE 7, при валидации компонентов мы можем определять метаданные с помощью аннотаций (как это делалось выше) и с помощью XML. В Bean Validation у нас может быть несколько опциональных файлов, которые располагаются в каталоге META-INF. Первый файл, validation.xml, может применяться приложениями для уточнения некоторых особенностей поведения валидации компонентов (в частности, поведения действующего по умолчанию поставщика валидации компонентов, интерполятора сообщений, а также конкретных свойств). Кроме того, у вас может быть несколько файлов, описывающих объявления ограничений для ваших компонентов. Как и все дескрипторы развертывания в Java EE 7, XML переопределяет аннотации.
В листинге 3.19 показан дескриптор развертывания validation.xml, имеющий корневой XML-элемент validation-config. Гораздо важнее, что здесь определяется внешний файл для отображения ограничений: constraints.xml (показан в листинге 3.20).
>
>
>····xmlns="http://jboss.org/xml/ns/javax/validation/configuration"
>····xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance"
>····xsi: schemaLocation="http://jboss.org/xml/ns/javax/validation/configuration
>·························validation-configuration-1.1.xsd"
>····version="1.1">
>··
>
>
>
>····xmlns="http://jboss.org/xml/ns/javax/validation/mapping"
>····xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance"
>····xsi: schemaLocation="http://jboss.org/xml/ns/javax/validation/mapping
>·························validation-mapping-1.1.xsd"
>····version="1.1">
>··
>····
>······
>········
>······
>····
>····
>······
>······
>········
>······
>····
>····
>······
>········
>······
>····
>··
>
Файл constraints.xml из листинга 3.20 определяет метаданные для объявления ограничений, используемых с классом Book. Сначала он применяет ограничение @NotNull к атрибуту title и заново задает выводимое по умолчанию сообщение об ошибке («Название не может быть пустым»). К атрибуту price применяются два разных ограничения, его минимальное значение равно 2. Ситуация напоминает код из листинга 3.1, где метаданные определялись с помощью аннотаций.
Валидация ограничений
До сих пор мы плотно работали с ограничениями — определяли их, агрегировали, реализовывали наши собственные, настраивали сообщения об ошибках, возились с группами. Но без специальной валидационной среды исполнения проверка ограничений невозможна. Как и с большинством технологий Java EE 7, код в данном случае должен работать внутри контейнера или управляться поставщиком.
Ограничения можно применять к компонентам, атрибутам, геттерам, конструкторам, параметрам методов и возвращаемым значениям. Итак, валидация может выполняться для элементов всех этих типов. Можно валидировать компоненты, свойства, значения, методы и группы, а также задавать собственные ограничения для графа объектов. Чтобы все эти ограничения проверялись во время исполнения, вам потребуется валидационный API.
Валидационные API
Среда исполнения валидации использует небольшой набор API, которые позволяют ей проверять ограничения. Основной API — это интерфейс javax.validation.Validator. Он содержит соглашения для валидации объектов и графов объектов независимо от уровня, на котором этот интерфейс реализован (уровень представления, уровень бизнес-логики или бизнес-модели). При ошибке валидации возвращается набор интерфейсов javax.validation.ConstraintViolation. Он предоставляет контекст произошедшего нарушения, а также сообщение, описывающее нарушение.
