Класс TransformerException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- 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 или |
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, указывающий, где произошла ошибка. |
Методы, объявленные в классе 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 из сообщения и Locator.
Этот конструктор особенно полезен, когда приложение создает собственное исключение внутри обратного вызова DocumentHandler.
- Параметры:
-
message- Сообщение об ошибке или предупреждении. -
locator- Объект locator для ошибки или предупреждения.
TransformerException
public TransformerException(String message,
SourceLocator locator,
Throwable e)
Оборачивает существующее исключение в TransformerException.
- Параметры:
-
message- Сообщение об ошибке или предупреждении, или null для использования сообщения из вложенного исключения. -
locator- Объект 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()
Возвращает причину этого объекта throwable или null, если причина отсутствует или неизвестна. (Причина — это объект throwable, вызвавший этот объект throwable).
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()
Получить сообщение об ошибке с добавленной информацией о местоположении.
- Возвращает:
- Строку, представляющую сообщение об ошибке с добавленной информацией о местоположении.
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, 2020, 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/11/docs/api/java.xml/javax/xml/transform/TransformerException.html