Module java.xml

软件包 javax.xml.transform

Class TransformerException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.xml.transform.TransformerException

All Implemented Interfaces:

Serializable

已知直接子类：

TransformerConfigurationException

public class TransformerException
extends 异常

此类指定在转换过程中发生的异常情况。

从以下版本开始：

1.4

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor	描述
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。

方法摘要

Modifier and Type	方法	描述
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对象的实例，该对象指定发生错误的位置。

Methods inherited from class java.lang.Object

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

Methods inherited from class java.lang.Throwable

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

构造方法详细信息

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

getCause

public Throwable getCause()

如果原因不存在或未知，则返回此可抛出的原因或null 。 （原因是引发这个可抛掷物的抛掷物）

重写：

getCause在 Throwable

结果

这个可能的原因或 null如果原因不存在或未知。

initCause

public Throwable initCause(Throwable cause)

将此throwable的原因初始化为指定值。 （原因是引发这个可抛掷物的抛掷物）

这个方法最多可以调用一次。 它通常从构造函数中调用，或者在创建throwable之后立即调用。 如果这个throwable是用TransformerException(Throwable)或TransformerException(String,Throwable)创建的， 那么这个方法也不能被调用一次。

重写：

initCause在 Throwable

参数

cause - 原因（由getCause()方法保存供以后检索）。 （允许A null值，表示原因不存在或未知。）

结果

参考这个 Throwable例子。

异常

IllegalArgumentException - 如果cause是这个可抛出的。 （一个可以不是自己的事业）

IllegalStateException - 如果这个throwable是用 TransformerException(Throwable)或 TransformerException(String,Throwable)创建的，或者这个方法已经在这个throwable上被调用了。

getMessageAndLocation

public String getMessageAndLocation()

获取附加位置信息的错误消息。

结果

A 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 - 转储将发送到的作者。