Класс 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

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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/transform/TransformerException.html