|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.lang.Throwable java.lang.Exception javax.xml.xpath.XPathException
public class XPathException
XPathException
表示一般的 XPath 异常。
构造方法摘要 | |
---|---|
XPathException(String message)
构造带指定详细 message 的新 XPathException 。 |
|
XPathException(Throwable cause)
构造带指定 cause 的新 XPathException 。 |
方法摘要 | |
---|---|
Throwable |
getCause()
返回此 throwable 的 cause;如果 cause 不存在或未知,则返回 null 。 |
void |
printStackTrace()
将此 throwable 及其追踪输出至标准错误流。 |
void |
printStackTrace(PrintStream s)
将此 throwable 及其追踪输出到指定的输出流。 |
void |
printStackTrace(PrintWriter s)
将此 throwable 及其追踪输出到指定的 PrintWriter。 |
从类 java.lang.Throwable 继承的方法 |
---|
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public XPathException(String message)
构造带指定详细 message
的新 XPathException
。
cause
未初始化。
如果 message
为 null
,则抛出 NullPointerException
。
message
- 详细消息。public XPathException(Throwable cause)
构造带指定 cause
的新 XPathException
。
如果 cause
为 null
,则抛出 NullPointerException
。
cause
- 原因
NullPointerException
- 如果 cause
为 null
。方法详细信息 |
---|
public Throwable getCause()
Throwable
复制的描述null
。(该 Cause 是导致抛出此 throwable 的throwable。)
此实现返回由一个需要 Throwable 的构造方法提供的 cause,或者在创建之后通过 Throwable.initCause(Throwable)
方法进行设置的 cause。虽然通常不需要重写此方法,但子类可以重写它,以返回一个通过某些其他方式设置的 cause。这适用于在异常链(异常嵌套)机制被加入到 Throwable 之前存在“遗留 Throwable 链机制”的情况。注意,不必 重写任何 PrintStackTrace 方法,所有方法都调用 getCause 方法来确定 throwable 的 cause。
Throwable
中的 getCause
null
。public void printStackTrace(PrintStream s)
Throwable
复制的描述
Throwable
中的 printStackTrace
s
- 用于输出的 PrintStream
public void printStackTrace()
Throwable
复制的描述Throwable
对象的堆栈跟踪输出至错误输出流,作为字段 System.err
的值。输出的第一行包含此对象的 Throwable.toString()
方法的结果。剩余行表示以前由方法 Throwable.fillInStackTrace()
记录的数据。此信息的格式取决于实现,但以下示例是最常见的:
本示例通过运行以下程序生成:java.lang.NullPointerException at MyClass.mash(MyClass.java:9) at MyClass.crunch(MyClass.java:6) at MyClass.main(MyClass.java:3)
class MyClass { public static void main(String[] args) { crunch(null); } static void crunch(int[] a) { mash(a); } static void mash(int[] b) { System.out.println(b[0]); } }对于带初始化非空 cause 的 throwable 的追踪,通常应该包括 cause 的追踪。此信息的格式取决于实现,但以下示例是最常见的:
HighLevelException: MidLevelException: LowLevelException at Junk.a(Junk.java:13) at Junk.main(Junk.java:4) Caused by: MidLevelException: LowLevelException at Junk.c(Junk.java:23) at Junk.b(Junk.java:17) at Junk.a(Junk.java:11) ... 1 more Caused by: LowLevelException at Junk.e(Junk.java:30) at Junk.d(Junk.java:27) at Junk.c(Junk.java:21) ... 3 more注意,存在包含字符 "..." 的行。这些行指示此异常的椎栈跟踪的其余部分匹配来自异常(由 "enclosing" 异常引起)的堆栈跟踪底部的指定数量的帧。这种简便方法可以大大缩短通常情况下的输出长度,这里抛出了包装的异常,其方法与捕获“作为 cause 的异常”的方法相同。上述示例通过运行以下程序生成:
public class Junk { public static void main(String args[]) { try { a(); } catch(HighLevelException e) { e.printStackTrace(); } } static void a() throws HighLevelException { try { b(); } catch(MidLevelException e) { throw new HighLevelException(e); } } static void b() throws MidLevelException { c(); } static void c() throws MidLevelException { try { d(); } catch(LowLevelException e) { throw new MidLevelException(e); } } static void d() throws LowLevelException { e(); } static void e() throws LowLevelException { throw new LowLevelException(); } } class HighLevelException extends Exception { HighLevelException(Throwable cause) { super(cause); } } class MidLevelException extends Exception { MidLevelException(Throwable cause) { super(cause); } } class LowLevelException extends Exception { }
Throwable
中的 printStackTrace
public void printStackTrace(PrintWriter s)
Throwable
复制的描述
Throwable
中的 printStackTrace
s
- 用于输出的 PrintWriter
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。