public interface ErrorListener
Чтобы обеспечить настроенную обработку ошибок, реализуйте этот интерфейс и используйте setErrorListener
метод, чтобы зарегистрировать экземпляр implmentation с Transformer
. Transformer
тогда отчеты все ошибки и предупреждения через этот интерфейс.
Если приложение не регистрирует свое собственное ErrorListener
, значение по умолчанию ErrorListener
используется, который сообщает обо всех предупреждениях и ошибках к System.err
и не бросает никого Exception
s. Приложения строго поощряются зарегистрировать и использовать ErrorListener
s, которые обеспечивают правильное поведение для предупреждений и ошибок.
Для ошибок преобразования, a Transformer
должен использовать этот интерфейс вместо того, чтобы бросить Exception
: это до приложения, чтобы решить, бросить ли Exception
для различных типов ошибок и предупреждений. Отметьте однако что Transformer
не обязан продолжаться с преобразованием после звонка fatalError(TransformerException exception)
.
Transformer
s может использовать этот механизм, чтобы сообщить о XML, анализирующем ошибки преобразования так же как ошибки.
Модификатор и Тип | Метод и Описание |
---|---|
void |
error(TransformerException exception)
Получите уведомление об исправимой ошибке.
|
void |
fatalError(TransformerException exception)
Получите уведомление о неисправимой ошибке.
|
void |
warning(TransformerException exception)
Получите уведомление о предупреждении.
|
void warning(TransformerException exception) throws TransformerException
Transformer
может использовать этот метод, чтобы сообщить об условиях, которые не являются ошибками или фатальными ошибками. Поведение значения по умолчанию не состоит в том, чтобы предпринять меры.
После вызова этого метода Преобразователь должен продолжаться с преобразованием. Для приложения должно все еще быть возможно обработать документ через до конца.
exception
- Информация о предупреждении инкапсулируется в исключении преобразователя.TransformerException
- если приложение хочет прекращать преобразование.TransformerException
void error(TransformerException exception) throws TransformerException
Преобразователь должен продолжать пытаться обеспечить нормальное преобразование после вызова этого метода. Для приложения должно все еще быть возможно обработать документ через до конца, если ни с какими другими ошибками не встречаются.
exception
- Информация об ошибке инкапсулируется в исключении преобразователя.TransformerException
- если приложение хочет прекращать преобразование.TransformerException
void fatalError(TransformerException exception) throws TransformerException
Получите уведомление о неисправимой ошибке.
Процессор может хотеть продолжаться, но не будет обычно продолжаться к успешному завершению.
Метод должен выдать исключение, если это неспособно обработать ошибку, или если это хочет, чтобы выполнение сразу завершилось. Процессор будет не обязательно соблюдать этот запрос.
exception
- Информация об ошибке инкапсулируется в a TransformerException
.TransformerException
- если приложение хочет прекращать преобразование.TransformerException
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92