Изучаем Java EE 7

Метод	Описание
disableDefaultConstraintViolation	Отменяет генерацию задаваемого по умолчанию объекта ConstraintViolation
getDefaultConstraintMessageTemplate	Возвращает актуальное сообщение, заданное по умолчанию, без интерполяции
buildConstraintViolationWithTemplate	Возвращает ConstraintViolationBuilder, обеспечивающий построение пользовательского отчета о нарушении ограничения

Интерфейс ConstraintValidatorContext позволяет повторно определить заданное по умолчанию сообщение, связанное с ограничением. Метод buildConstraintViolationWithTemplate возвращает ConstraintViolationBuilder, опираясь на гибкий образец API, позволяющий создавать пользовательские отчеты о нарушениях. Следующий код добавляет к отчету информацию о новом нарушении ограничения:

context.buildConstraintViolationWithTemplate("Invalid protocol")

·······.addConstraintViolation();

Такая техника позволяет генерировать и создавать одно или несколько пользовательских сообщений-отчетов. Если рассмотреть пример с ограничением @URL из листинга 3.7, то мы увидим, что всему ограничению здесь соответствует лишь одно сообщение об ошибке (Malformed URL). Но у этого ограничения несколько атрибутов (protocol, host и port), и нам могут понадобиться специфичные сообщения для каждого из этих атрибутов, например: Invalid protocol (Недопустимый протокол) или Invalid host (Недопустимый хост).

Примечание

Интерфейс ConstraintViolation описывает нарушение ограничения. Он предоставляет контекст, в котором произошло нарушение, а также сообщение, описывающее это нарушение. Подробнее об этом читайте в разделе «Валидация ограничений» данной главы.

В листинге 3.17 мы вновь рассмотрим класс реализации ограничения URL и воспользуемся ConstraintValidatorContext, чтобы изменить сообщение об ошибке. Код полностью отключает генерацию заданного по умолчанию сообщения об ошибке (disableDefaultConstraintViolation) и отдельно определяет сообщения об ошибках для каждого атрибута.

Листинг 3.17. Ограничение URL, использующее ConstraintValidatorContext для настройки сообщений об ошибках

public class URLValidator implements ConstraintValidator {

··private String protocol;

··private String host;

··private int port;

··public void initialize(URL url) {

····this.protocol = url.protocol();

····this.host = url.host();

····this.port = url.port();

··}

··public boolean isValid(String value, ConstraintValidatorContext context) {

····if (value == null || value.length() == 0) {

······return true;

····}

····java.net.URL url;

····try {

······url = new java.net.URL(value);

····} catch (MalformedURLException e) {

······return false;

····}

····if (protocol!= null && protocol.length() > 0 && 

!url.getProtocol(). equals(protocol)) {

······context.disableDefaultConstraintViolation();

······context.buildConstraintViolationWithTemplate("Неверный 

протокол"). addConstraintViolation();

······return false;

····}

····if (host!= null && host.length() > 0 &&!url.getHost(). startsWith(host)) {

······context.disableDefaultConstraintViolation();

······context.buildConstraintViolationWithTemplate("Неверный 

хост"). addConstraintViolation();

······return false;

····}