Класс TransformerException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.xml.transform.TransformerException
- Все реализуемые интерфейсы:
- Serializable
- Прямые известные подклассы:
- TransformerConfigurationException
public class TransformerException extends Exception
Этот класс определяет исключительное состояние, произошедшее во время процесса преобразования.
- См. также:
- Сериализованная форма
Конструкторы
| Конструктор и описание |
|---|
TransformerException(String message) Создать новый TransformerException. |
TransformerException(String message,
SourceLocator locator) Создать новый TransformerException из сообщения и Locator. |
TransformerException(String message,
SourceLocator locator,
Throwable e) Обернуть существующее исключение в TransformerException. |
TransformerException(String message,
Throwable e) Обернуть существующее исключение в TransformerException. |
TransformerException(Throwable e) Создать новый TransformerException, обертывающий существующее исключение. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
Throwable |
getCause() Возвращает причину данного исключения или |
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 из сообщения и 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()
Возвращает причину данного исключения или 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, 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.