Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-03-10

1 Теги: java, pom.xml, java enterprise, java ee, hibernate, bean validation 2.0 (jsr 380), @null, @notnull, @size, @past, @future, @min, @max, javax.validation.constraints, cdi, validateproperty, validatevalue

2 Ни для кого не секрет, что ни одна повседневная задача разработчика не обходится без потребности валидировать поступающие "извне" потоки данных: с пользовательских HTML-форм, внешних систем и т.д. На первый взгляд, ничего нет плохого в том, что каждый программист пытается по-своему решить эту задачу (фактически написав "очередной велосипед", используя множество проверок, состоящих из if-else блоков).

3 Но при таком подходе высока вероятность, что в будущем поддержка такого "спагетти"-кода станет крайне затруднительной из-за постоянной потребности в модификации атрибутов класса или в случае переиспользования проверок в различных участках системы, например, на клиенте и на сервере. Чтобы избежать подобных проблем, в стеке JavaEE предусмотрели спецификациюBean Validation 2.0 (JSR 380).

4 <h2>Итак, что же это за зверь?</h2>

5 Основная идея данной спецификации заключается в использовании таких аннотаций, как@Null /@NotNull, @Size, @Past /@Future, @Min /@Maxи т. д., размещаемых над полями класса для проверки заранее ожидаемых значений, вхождения в границы диапазона, соответствия регулярным выражениям и т. д.

6 Более того, эту функциональность без каких-либо проблем можно использовать и в JavaSE-приложениях, для чего лишь потребуется вpom.xmlподключить следующие зависимости:

7 <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>${validation.version}</version> </dependency> <dependency> <groupId>org.hibernate.validator</groupId> <artifactId>hibernate-validator</artifactId> <version>${validator.version}</version> </dependency> <dependency> <groupId>org.hibernate.validator</groupId> <artifactId>hibernate-validator-annotation-processor</artifactId> <version>${validator.version}</version> </dependency>ВалидаторHibernate(на момент написания заметки самая актуальная версия validator.version - 6.0.11.Final, validation.version - 2.0.1.Final) является референсной имплементацией спецификацииBean Validation.

8 Обращаю внимание, что добавление этой библиотеки в проект не добавит поддержки аспектов персистентности одноимённой библиотеки.

9 <h2>Немного практики</h2>

10 Теперь посмотрим, как же использовать всю мощь спецификации в прикладном коде. Представим, что определён классUserс некоторым набором характеристик:

11 import javax.validation.constraints.*; public class User { @NotBlank(message = "Name cannot be null") private String name; @AssertTrue private boolean hasWork; @Size(min = 10, max = 500, message = "Description should be in range of 10 and 500 symbols") private String description; @Min(value = 18, message = "Age should be greater than 18") @Max(value = 100, message = "Age should be less than 100") private int age; @NotNull @Email(message = "Email must be valid") private String email; // setters and getters }Уже только взглянув на сами аннотации, интуитивно догадываемся, что свойства: -nameдолжно быть отличным отnullи пустой строки “”; -hasWorkиметь значение истинно; -description- строка, количество символов которой не должно превышать 500 и быть меньше 10 символов; -ageлежит в диапазоне 18..100, включительно; -emailдолжно удовлетворять формату электронных писем.

12 В примере представлены далеко не все возможные аннотации, определяющие ограничения значений полей бинов. С полным списком можно познакомиться в пакетеjavax.validation.constraints.

13 Также акцентирую внимание на том, что допустимо комбинирование разных ограничений, не противоречащих здравой логике (в приведенном примере - одновременно использовать@Min @Maxи@NotNull @Email).

14 Не менее интересной является возможность использования данных аннотаций для элементов коллекций в следующем виде:

15 Set<@NotBlank String> hobbies; Далее, мы попробуем создать заранее инвалидный объект класса User, не определив ряд обязательных полей: User user = new User(); user.setHasWork(true); user.setDescription("Simple description about author!"); user.setAge(30);Осталось научиться проверять бины и получать информацию о потенциальных проблемах валидации такого рода объектов. Для этого важно получить ссылку на объект классаValidator. В JavaEE-контейнере можно просто заинжектить данный объект, используя спецификациюCDI:

16 @Inject Validator validator;Для JavaSE-приложений можно инициализировать данный объект явно:

17 ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); Validator validator = factory.getValidator();У объектаvalidatorесть несколько полезных методовvalidate, проверяющих все свойства бина -validatePropertyиvalidateValue, испытывающие конкретное свойство объекта.

18 Set<ConstraintViolation<User>> violations = validator.validate(user); for (ConstraintViolation<User> violation : violations) { log.error(violation.getMessage()); }В текущем примере поляnameиemailне проинициализированы и об этом будет сообщено в логе. Для получения невалидного значения достаточно вызвать:

19 violation.getInvalidValue()<h2>Вот и познакомились с базовыми возможностями спецификацииBean Validation!</h2>

20 Если у вас появилось желание узнать подробности и узнать, например, как создавать свои кастомные валидаторы, каким образом объединять проверки в группы, как использовать эти возможности с другими спецификациями (JAX-RS, JPA), а также делать сообщения интернациональными - приходите к нам на курс "Разработчик Java Enterprise"!

21 Есть вопрос? Напишите в комментариях!