Класс 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 из сообщения и объекта Locator.
`TransformerException(String message, SourceLocator locator, Throwable e)`	Оборачивает существующее исключение в TransformerException.
`TransformerException(Throwable e)`	Создает новый TransformerException, оборачивающий существующее исключение.

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

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

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

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

Методы, объявленные в классе 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 из сообщения и объекта Locator.

Этот конструктор особенно полезен, когда приложение создает собственное исключение внутри обратного вызова 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()

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

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

initCause

public Throwable initCause(Throwable cause)

Инициализирует причину этого throwable указанным значением. (Причина — это throwable, из-за которого было выброшено данное throwable.)

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

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

getMessageAndLocation

public String getMessageAndLocation()

Возвращает сообщение об ошибке с добавленными сведениями о местоположении.

Возвращает:: Объект String, представляющий сообщение об ошибке с добавленными сведениями о местоположении.

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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/transform/TransformerException.html