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