Интерфейс ValidationEventHandler
- Все известные реализующие классы:
- DefaultValidationEventHandler, ValidationEventCollector
public interface ValidationEventHandler
Базовый интерфейс обработчика событий для ошибок валидации.
Если приложение нуждается в реализации кастомизированной обработки событий, оно должно реализовать этот интерфейс и зарегистрировать его с помощью Unmarshaller, Validator или Marshaller. JAXB Provider затем будет сообщать об ошибках и предупреждениях валидации, возникающих во время операций unmarshal, marshal и validate, этим обработчикам событий.
Если метод handleEvent вызывает необработанное исключение времени выполнения, JAXB Provider должен рассматривать это как если бы метод вернул false, эффективно завершая выполняемую в данный момент операцию (unmarshal, validate или marshal).
Изменение дерева Java-контента внутри обработчика событий не определено спецификацией и может привести к непредвиденному поведению.
Отказ от возвращения false из метода handleEvent после обнаружения критической ошибки не определено спецификацией и может привести к непредвиденному поведению.
Обработчик событий по умолчанию
См.: Validator javadocs
- С:
- JAXB1.0
- См. также:
-
Unmarshaller,Validator,Marshaller,ValidationEvent,ValidationEventCollector
Методы
| Модификатор и тип | Метод и описание |
|---|---|
boolean |
handleEvent(ValidationEvent event) Получить уведомление о предупреждении или ошибке валидации. |
Методы
handleEvent
boolean handleEvent(ValidationEvent event)
Получить уведомление о предупреждении или ошибке валидации. Объект ValidationEvent будет содержать ValidationEventLocator, указывающий место возникновения ошибки или предупреждения.
Если из этого метода выброшено необработанное исключение времени выполнения, JAXB-провайдер будет рассматривать это как если бы метод вернул false и прервет текущую операцию unmarshal, validate или marshal.
- Параметры:
-
event- информация об упакованном событии валидации. Ошибка провайдера, если этот параметр равен null. - Возвращает:
- true, если JAXB Provider должен попытаться продолжить текущую операцию unmarshal, validate или marshal после обработки этого предупреждения/ошибки; false, если провайдер должен завершить текущую операцию с соответствующей
UnmarshalException,ValidationException, илиMarshalException. - Исключения:
-
IllegalArgumentException- если объект события равен null.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.