Класс TransformerException

javax.xml.transform.TransformerException

Все реализованные интерфейсы:: Serializable

Прямые известные подклассы:: TransformerConfigurationException

public class TransformerException extends Exception

Этот класс определяет исключительное состояние, возникшее во время процесса преобразования.

С:

1.4

См. также:

Сериализованная форма

Краткое описание конструкторов

Конструктор	Описание
`TransformerException(String message)`	Создаёт новый TransformerException.
`TransformerException(String message, Throwable e)`	Оборачивает существующее исключение в TransformerException.
`TransformerException(String message, SourceLocator locator)`	Создаёт новый TransformerException из сообщения и локатора.
`TransformerException(String message, SourceLocator locator, Throwable e)`	Оборачивает существующее исключение в TransformerException.
`TransformerException(Throwable e)`	Создаёт новый TransformerException, оборачивающий существующее исключение.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Throwable`	`getCause()`	Возвращает причину данного исключения или `null`, если причина отсутствует или неизвестна.
`Throwable`	`getException()`	Этот метод извлекает исключение, которое оборачивает данное исключение.
`String`	`getLocationAsString()`	Получить информацию о местоположении в виде строки.
`SourceLocator`	`getLocator()`	Метод getLocator извлекает экземпляр объекта SourceLocator, который указывает место возникновения ошибки.
`String`	`getMessageAndLocation()`	Получить сообщение об ошибке с добавленной информацией о местоположении.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину данного исключения заданным значением.
`void`	`printStackTrace()`	Выводит трассировку методов, из которых произошла ошибка.
`void`	`printStackTrace(PrintStream s)`	Выводит трассировку методов, из которых произошла ошибка.
`void`	`printStackTrace(PrintWriter s)`	Выводит трассировку методов, из которых произошла ошибка.
`void`	`setLocator(SourceLocator location)`	Метод setLocator устанавливает экземпляр объекта SourceLocator, который указывает место возникновения ошибки.

Методы, объявленные в классе java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, setStackTrace, toString

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

TransformerException

public TransformerException(String message)

Создать новый TransformerException.

Параметры:: message - Сообщение об ошибке или предупреждении.

TransformerException

public TransformerException(Throwable e)

Создать новый TransformerException, обертывающий существующее исключение.

Параметры:: e - Исключение, которое нужно обернуть.

TransformerException

public TransformerException(String message, Throwable e)

Обернуть существующее исключение в TransformerException.

Используется для выброса исключений процессора до начала обработки.

Параметры:: message - Сообщение об ошибке или предупреждении, или null, чтобы использовать сообщение из вложенного исключения.; e - Любое исключение

TransformerException

public TransformerException(String message, SourceLocator locator)

Создать новый TransformerException из сообщения и локализации.

Этот конструктор особенно полезен, когда приложение создает собственное исключение внутри обратного вызова DocumentHandler.

Параметры:: message - Сообщение об ошибке или предупреждении.; locator - Объект локализации для ошибки или предупреждения.

TransformerException

public TransformerException(String message, SourceLocator locator, Throwable e)

Обернуть существующее исключение в TransformerException.

Параметры:: message - Сообщение об ошибке или предупреждении, или null, чтобы использовать сообщение из вложенного исключения.; locator - Объект локализации для ошибки или предупреждения.; e - Любое исключение

Подробное описание методов

getLocator

public SourceLocator getLocator()

Метод getLocator извлекает экземпляр объекта SourceLocator, указывающий, где произошла ошибка.

Возвращает:: Объект SourceLocator или null, если он не был указан.

setLocator

public void setLocator(SourceLocator location)

Метод setLocator устанавливает экземпляр объекта SourceLocator, указывающий, где произошла ошибка.

Параметры:: location - Объект SourceLocator или null для сброса местоположения.

getException

public Throwable getException()

Этот метод извлекает исключение, которое обертывает данное исключение.

Возвращает:

Объект Throwable или null.

См. также:

getCause()

getCause

public Throwable getCause()

Возвращает причину этого исключения или null если причина отсутствует или неизвестна. (Причина — исключение, которое привело к выбросу этого исключения.)

Переопределяет:: getCause в классе Throwable
Возвращает:: причину или null, если неизвестна

initCause

public Throwable initCause(Throwable cause)

Инициализирует причину этого исключения указанным значением. (Причина — исключение, которое привело к выбросу этого исключения.)

Этот метод можно вызвать не более одного раза. Обычно он вызывается внутри конструктора или сразу после создания исключения. Если это исключение было создано с помощью TransformerException(Throwable) или TransformerException(String,Throwable), этот метод нельзя вызвать ни разу.

Переопределяет:: initCause в классе Throwable
Параметры:: cause - причина (сохраняется для последующего извлечения методом getCause()). (Разрешено значение null, которое указывает, что причина отсутствует или неизвестна.)
Возвращает:: ссылку на этот экземпляр Throwable
Исключения:: IllegalArgumentException - если cause равно этому исключению. (Исключение не может быть собственной причиной.); IllegalStateException - если это исключение было создано с помощью TransformerException(Throwable) или TransformerException(String,Throwable), или этот метод уже был вызван для этого исключения.

getMessageAndLocation

public String getMessageAndLocation()

Получить сообщение об ошибке с добавленной информацией о местоположении.

Возвращает:: Строку, представляющую сообщение об ошибке с добавленной информацией о местоположении.

getLocationAsString

public String getLocationAsString()

Получить информацию о местоположении в виде строки.

Возвращает:: Строку с информацией о местоположении или null, если информация о местоположении отсутствует.

printStackTrace

public void printStackTrace()

Распечатать трассировку методов, откуда произошла ошибка. Это отследит все вложенные объекты исключений, а также этот объект.

Переопределяет:: printStackTrace в классе Throwable

printStackTrace

public void printStackTrace(PrintStream s)

Переопределяет:: printStackTrace в классе Throwable
Параметры:: s - Поток, в который будет отправлена информация.

printStackTrace

public void printStackTrace(PrintWriter s)

Переопределяет:: printStackTrace в классе Throwable
Параметры:: s - Поток, в который будет отправлена информация.

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/javax/xml/transform/TransformerException.html