Изучаем Java EE 7

Как видите, ограничивающие аннотации могут применяться с большинством типов элементов, определяемых в Java. Только статические поля и статические методы не могут проверяться валидацией компонентов. В листинге 3.4 показан класс Order, где ограничивающие аннотации применяются к самому классу, атрибутам, конструктору и бизнес-методу.

Листинг 3.4. Объект, использующий ограничения с элементами нескольких типов

@ChronologicalDates

public class Order {

··@NotNull @Pattern(regexp = "[C,D,M][A-Z][0–9]*")

··private String orderId;

··private Date creationDate;

··@Min(1)

··private Double totalAmount;

··private Date paymentDate;

··private Date deliveryDate;

··private List orderLines;

··public Order() {

··}

··public Order(@Past Date creationDate) {

····this.creationDate = creationDate;

··}

··public @NotNull Double calculateTotalAmount(@GreaterThanZero Double changeRate) {

····//…

··}

··// Геттеры и сеттеры

}

В листинге 3.4 @ChronologicalDates — это ограничение, действующее на уровне класса и основанное на нескольких свойствах класса Order (в данном случае оно гарантирует, что значения creationDate, paymentDate и deliveryDate являются хронологическими). Атрибут orderId имеет два ограничения: он не может быть равен нулю (@NotNull) и должен соответствовать шаблону регулярного выражения (@Pattern). Конструктор Order гарантирует, что параметр creationDate должен обозначать момент в прошлом. Метод calculateTotalAmount (рассчитывающий общую сумму заказа на покупку) проверяет, является ли changeRate значением больше нуля — @GreaterThanZero, а также гарантирует, что возвращаемая сумма будет ненулевой.

Примечание

До сих пор в примерах я показывал аннотированные атрибуты, но вместо этого можно аннотировать геттеры. Вы можете определять ограничения либо для атрибута, либо для геттера, но не для обоих одновременно. Лучше оставаться последовательным и всегда использовать аннотации либо только с атрибутами, либо только с геттерами.

Встроенные ограничения

Спецификация Bean Validation позволяет вам писать собственные ограничения и валидировать их. Но в ней присутствует и несколько встроенных ограничений. Мы уже сталкивались с некоторыми из них в предыдущих примерах, но в табл. 3.2 приведен исчерпывающий список всех встроенных ограничений (таких, которые уже готовы для использования в коде и не требуют разработки аннотации или класса реализации). Все встроенные ограничения определяются в пакете javax.validation.constraints.

Таблица 3.2. Полный список встроенных ограничивающих аннотаций