Класс 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()`	Возвращает причину этого исключения или `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, указывающий, где произошла ошибка.

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

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным при возникновении данного исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, при возникновении данного исключения.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращаться методом `Throwable.getStackTrace()` и выводиться методами `Throwable.printStackTrace()` и связанными с ним методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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()

Возвращает причину этого исключения или 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()

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

Возвращает:: Объект 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.