public class TransformerException
extends 异常
java.lang.Object | |||
↳ | java.lang.Throwable | ||
↳ | java.lang.Exception | ||
↳ | javax.xml.transform.TransformerException |
Known Direct Subclasses |
此类指定在转换过程中发生的异常情况。
Public constructors |
|
---|---|
TransformerException(String message) 创建一个新的TransformerException。 |
|
TransformerException(Throwable e) 创建一个包装现有异常的新TransformerException。 |
|
TransformerException(String message, Throwable e) 在TransformerException中包装现有异常。 |
|
TransformerException(String message, SourceLocator locator) 从消息和定位器中创建一个新的TransformerException。 |
|
TransformerException(String message, SourceLocator locator, Throwable e) 在TransformerException中包装现有异常。 |
Public methods |
|
---|---|
Throwable |
getCause() 如果原因不存在或未知,则返回此throwable或 |
Throwable |
getException() 此方法检索此例外包装的异常。 |
String |
getLocationAsString() 以字符串形式获取位置信息。 |
SourceLocator |
getLocator() getLocator方法检索指定发生错误的SourceLocator对象的实例。 |
String |
getMessageAndLocation() 获取附加位置信息的错误消息。 |
Throwable |
initCause(Throwable cause) 将此throwable的 原因初始化为指定值。 |
void |
printStackTrace() 打印错误发生地点的方法跟踪。 |
void |
printStackTrace(PrintWriter s) 打印错误发生地点的方法跟踪。 |
void |
printStackTrace(PrintStream s) 打印错误发生地点的方法跟踪。 |
void |
setLocator(SourceLocator location) 方法setLocator设置指定错误发生位置的SourceLocator对象的实例。 |
Inherited methods |
|
---|---|
From class java.lang.Throwable
|
|
From class java.lang.Object
|
TransformerException (String message)
创建一个新的TransformerException。
Parameters | |
---|---|
message |
String : The error or warning message. |
TransformerException (Throwable e)
创建一个包装现有异常的新TransformerException。
Parameters | |
---|---|
e |
Throwable : The exception to be wrapped. |
TransformerException (String message, Throwable e)
在TransformerException中包装现有异常。
这用于在处理开始之前抛出处理器异常。
Parameters | |
---|---|
message |
String : The error or warning message, or null to use the message from the embedded exception. |
e |
Throwable : Any exception |
TransformerException (String message, SourceLocator locator)
从消息和定位器中创建一个新的TransformerException。
当应用程序在DocumentHandler回调中创建自己的异常时,此构造函数特别有用。
Parameters | |
---|---|
message |
String : The error or warning message. |
locator |
SourceLocator : The locator object for the error or warning. |
TransformerException (String message, SourceLocator locator, Throwable e)
在TransformerException中包装现有异常。
Parameters | |
---|---|
message |
String : The error or warning message, or null to use the message from the embedded exception. |
locator |
SourceLocator : The locator object for the error or warning. |
e |
Throwable : Any exception |
Throwable getCause ()
如果原因不存在或未知,则返回此throwable或null
的原因。 (原因是导致此throwable被抛出的throwable。)
Returns | |
---|---|
Throwable |
the cause of this throwable or null if the cause is nonexistent or unknown. |
Throwable getException ()
此方法检索此例外包装的异常。
Returns | |
---|---|
Throwable |
An Throwable object, or null. |
也可以看看:
String getLocationAsString ()
以字符串形式获取位置信息。
Returns | |
---|---|
String |
A string with location info, or null if there is no location information. |
SourceLocator getLocator ()
getLocator方法检索指定发生错误的SourceLocator对象的实例。
Returns | |
---|---|
SourceLocator |
A SourceLocator object, or null if none was specified. |
String getMessageAndLocation ()
获取附加位置信息的错误消息。
Returns | |
---|---|
String |
A String representing the error message with location information appended. |
Throwable initCause (Throwable cause)
将此throwable的原因初始化为指定值。 (原因是导致此throwable被抛出的throwable。)
该方法最多可以调用一次。 它通常在构造函数中调用,或者在创建throwable之后立即调用。 如果这个throwable是用TransformerException(Throwable)
或TransformerException(String, Throwable)
创建的,这个方法甚至不能被调用一次。
Parameters | |
---|---|
cause |
Throwable : the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.) |
Returns | |
---|---|
Throwable |
a reference to this Throwable instance. |
Throws | |
---|---|
IllegalArgumentException |
if cause is this throwable. (A throwable cannot be its own cause.) |
IllegalStateException |
if this throwable was created with TransformerException(Throwable) or TransformerException(String, Throwable) , or this method has already been called on this throwable. |
void printStackTrace (PrintWriter s)
打印错误发生地点的方法跟踪。 这将跟踪所有嵌套的异常对象以及此对象。
Parameters | |
---|---|
s |
PrintWriter : The writer where the dump will be sent to. |
void printStackTrace (PrintStream s)
打印错误发生地点的方法跟踪。 这将跟踪所有嵌套的异常对象以及此对象。
Parameters | |
---|---|
s |
PrintStream : The stream where the dump will be sent to. |
void setLocator (SourceLocator location)
方法setLocator设置指定错误发生位置的SourceLocator对象的实例。
Parameters | |
---|---|
location |
SourceLocator : A SourceLocator object, or null to clear the location. |