javax.jdo
Class JDOException
java.lang.RuntimeException
public class JDOException
extends java.lang.RuntimeException
This is the root of all JDO Exceptions. It contains an optional detail
message, an optional nested Throwable
array and an optional failed object.
JDOException() - Constructs a new
JDOException without a detail message.
|
JDOException(String msg) - Constructs a new
JDOException with the specified detail message.
|
JDOException(String msg, Object failed) - Constructs a new
JDOException with the specified detail message
and failed object.
|
JDOException(String msg, Throwable nested) - Constructs a new
JDOException with the specified detail message
and nested Throwable .
|
JDOException(String msg, Throwable nested, Object failed) - Constructs a new
JDOException with the specified detail message,
nested Throwable , and failed object.
|
JDOException(String msg, Throwable[] nested) - Constructs a new
JDOException with the specified detail message
and nested Throwable s.
|
JDOException(String msg, Throwable[] nested, Object failed) - Constructs a new
JDOException with the specified detail message,
nested Throwable s, and failed object.
|
Throwable | getCause() - Often there is only one nested exception, and this method returns it.
|
Object | getFailedObject() - The exception may include a failed object.
|
Throwable[] | getNestedExceptions() - The exception may have been caused by multiple exceptions in the runtime.
|
Throwable | initCause(Throwable cause) - JDK 1.4 includes a new chaining mechanism for Throwable, but since
JDO has its own "legacy" chaining mechanism, the "standard" mechanism
cannot be used.
|
void | printStackTrace() - Prints this
JDOException and its backtrace to the
standard error output.
|
void | printStackTrace(java.io.PrintStream s) - Prints this
JDOException and its backtrace to the
specified print stream.
|
void | printStackTrace(java.io.PrintWriter s) - Prints this
JDOException and its backtrace to the specified
print writer.
|
String | toString() - The
String representation includes the name of the class,
the descriptive comment (if any),
the String representation of the failed Object (if any),
and the String representation of the nested Throwable s (if any).
|
JDOException
public JDOException()
Constructs a new JDOException
without a detail message.
JDOException
public JDOException(String msg)
Constructs a new JDOException
with the specified detail message.
msg
- the detail message.
JDOException
public JDOException(String msg,
Object failed)
Constructs a new JDOException
with the specified detail message
and failed object.
msg
- the detail message.failed
- the failed object.
JDOException
public JDOException(String msg,
Throwable nested)
Constructs a new JDOException
with the specified detail message
and nested Throwable
.
msg
- the detail message.nested
- the nested Throwable
.
JDOException
public JDOException(String msg,
Throwable nested,
Object failed)
Constructs a new JDOException
with the specified detail message,
nested Throwable
, and failed object.
msg
- the detail message.nested
- the nested Throwable
.failed
- the failed object.
JDOException
public JDOException(String msg,
Throwable[] nested)
Constructs a new JDOException
with the specified detail message
and nested Throwable
s.
msg
- the detail message.nested
- the nested Throwable[]
.
JDOException
public JDOException(String msg,
Throwable[] nested,
Object failed)
Constructs a new JDOException
with the specified detail message,
nested Throwable
s, and failed object.
msg
- the detail message.nested
- the nested Throwable[]
.failed
- the failed object.
getCause
public Throwable getCause()
Often there is only one nested exception, and this method returns it.
If there are more than one, then this method returns the first nested
exception. If there is no nested exception, then null is returned.
- the first or only nested Throwable.
getFailedObject
public Object getFailedObject()
The exception may include a failed object.
getNestedExceptions
public Throwable[] getNestedExceptions()
The exception may have been caused by multiple exceptions in the runtime.
If multiple objects caused the problem, each failed object will have
its own Exception
.
- the nested Throwable array.
initCause
public Throwable initCause(Throwable cause)
JDK 1.4 includes a new chaining mechanism for Throwable, but since
JDO has its own "legacy" chaining mechanism, the "standard" mechanism
cannot be used. This method always throws a JDOFatalInternalException.
printStackTrace
public void printStackTrace()
Prints this JDOException
and its backtrace to the
standard error output.
Print nested Throwables' stack trace as well.
printStackTrace
public void printStackTrace(java.io.PrintStream s)
Prints this JDOException
and its backtrace to the
specified print stream.
Print nested Throwables' stack trace as well.
s
- PrintStream
to use for output
printStackTrace
public void printStackTrace(java.io.PrintWriter s)
Prints this JDOException
and its backtrace to the specified
print writer.
Print nested Throwables' stack trace as well.
s
- PrintWriter
to use for output
toString
public String toString()
The String
representation includes the name of the class,
the descriptive comment (if any),
the String
representation of the failed Object
(if any),
and the String
representation of the nested Throwable
s (if any).