TransformerException

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.xml.transform
类 TransformerException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.transform.TransformerException

所有已实现的接口：: Serializable

直接已知子类：: TransformerConfigurationException

public class TransformerException
extends Exception
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。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。