JavaTM 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

此类指定了转换过程中发生的异常条件。

另请参见:
序列化表格

构造方法摘要
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。

JavaTM 2 Platform
Standard Ed. 5.0

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

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策