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

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。