javax.xml.transform
类 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)
从消息和 Locator 创建一个新 TransformerException。

TransformerException(String message, SourceLocator locator, Throwable e)
包装了 TransformerException 中的现有异常。

TransformerException(String message, 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 对象的实例，此对象指定了错误发生的位置。

从类 java.lang.Throwable 继承的方法

fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, 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)

从消息和 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。（原因是抛出此抛出对象引起的抛出对象。）

覆盖：

类 Throwable 中的 getCause

返回：

此 throwable 的 cause，如果 cause 不存在或是未知的，则返回 null。

initCause

public Throwable initCause(Throwable cause)

将此抛出对象的原因 初始化为指定值。（原因是抛出此抛出对象引起的抛出对象。）

此方法至多可以调用一次。此方法通常从构造方法中调用，或者在创建抛出对象后立即调用。如果此抛出对象通过 TransformerException(Throwable) 或 TransformerException(String,Throwable) 创建，则此方法甚至一次也不能调用。

覆盖：

类 Throwable 中的 initCause

参数：

cause - cause（保存此 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()

打印从中产生错误的方法跟踪。这将跟踪所有嵌套的异常对象，包括此对象。

覆盖：

类 Throwable 中的 printStackTrace

printStackTrace

public void printStackTrace(PrintStream s)

打印从中产生错误的方法跟踪。这将跟踪所有嵌套的异常对象，包括此对象。

覆盖：

类 Throwable 中的 printStackTrace

参数：

s - 将从中发送转储的流。

printStackTrace

public void printStackTrace(PrintWriter s)

打印从中产生错误的方法跟踪。这将跟踪所有嵌套的异常对象，包括此对象。

覆盖：

类 Throwable 中的 printStackTrace

参数：

s - 将从中发送转储的 writer。