模块 java.xml
包 javax.xml.transform

类 TransformerException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.xml.transform.TransformerException
所有已实现的接口：
Serializable
已知子类：
TransformerConfigurationException
public class TransformerException extends Exception
此类指定在转换过程中发生的异常情况。
自从：
1.4
参见：

  • 构造方法详细信息

    • 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

      public Throwable  getCause()
      如果原因不存在或未知，则返回此 throwable 或 null 的原因。 （原因是导致该 throwable 被抛出的 throwable。）
      重写：
      getCause 在类 Throwable 中
      返回：
      原因，如果未知则为 null

    • initCause

      public Throwable  initCause(Throwable  cause)
      初始化原因此 throwable 的指定值。 （原因是导致该 throwable 被抛出的 throwable。）

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

      重写：
      initCause 在类 Throwable 中
      参数：
      cause - 原因（保存以供以后通过 getCause() 方法检索）。 （允许使用 null 值，表示原因不存在或未知。）
      返回：
      对此 Throwable 实例的引用。
      抛出：
      IllegalArgumentException - 如果 cause 是可抛出的。 （throwable 不能是它自己的原因。）
      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 - 转储将发送到的编写器。