模块 java.xml

软件包 javax.xml.transform

Class TransformerException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.xml.transform.TransformerException

实现的所有接口

Serializable

已知直接子类：

TransformerConfigurationException

public class TransformerException
extends 异常

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

从以下版本开始：

1.4

另请参见：

Serialized Form

构造方法摘要

构造方法

构造器	描述
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。

方法摘要

变量和类型	方法	描述
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对象的实例，该实例指定发生错误的位置。

声明方法的类 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。

当应用程序从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()

如果原因不存在或未知，则返回此throwable或null的原因。 （原因是导致抛出此抛掷物的抛掷物。）

重写：

getCause在类 Throwable

结果

原因，如果不知道则为null

initCause

public Throwable initCause(Throwable cause)

将此throwable的原因初始化为指定值。 （原因是导致抛出此抛掷物的抛掷物。）

此方法最多可以调用一次。 它通常在构造函数中调用，或者在创建throwable之后立即调用。 如果使用TransformerException(Throwable)或TransformerException(String,Throwable)创建此throwable，则此方法甚至不能调用一次。

重写：

initCause在类 Throwable

参数

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

结果

对此 Throwable实例的引用。

异常

IllegalArgumentException - 如果cause是可cause 。 （抛弃不可能是它自己的原因。）

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