javax.jdo
Class JDOException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--javax.jdo.JDOException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

JDOCanRetryException, JDOFatalException

public class JDOException

extends java.lang.RuntimeException

This is the root of all JDO Exceptions. It contains an optional detail message, an optional nested exception array and an optional failed object.

Version:

0.9

Author:

Craig Russell

See Also:

Serialized Form

Field Summary

(package private) java.lang.Object	failed This exception may be the result of incorrect parameters supplied to an API.
(package private) java.lang.Exception[]	nested This exception was generated because of an exception in the runtime library.

Fields inherited from class java.lang.RuntimeException

Constructor Summary

JDOException()
Constructs a new JDOException without detail message.

JDOException(java.lang.String msg)
Constructs a new JDOException with the specified detail message.

JDOException(java.lang.String msg, java.lang.Exception[] nested)
Constructs a new JDOException with the specified detail message and nested exceptions.

JDOException(java.lang.String msg, java.lang.Exception[] nested, java.lang.Object failed)
Constructs a new JDOException with the specified detail message, nested exceptions, and failed object.

JDOException(java.lang.String msg, java.lang.Object failed)
Constructs a new JDOException with the specified detail message and failed object.

Method Summary

java.lang.Object	getFailedObject() The exception may include a failed object.
java.lang.Exception[]	getNestedExceptions() The exception may have been caused by multiple exceptions in the runtime.
java.lang.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 Exceptions (if any).

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

nested

java.lang.Exception[] nested

This exception was generated because of an exception in the runtime library.

failed

java.lang.Object failed

This exception may be the result of incorrect parameters supplied to an API. This is the object from which the user can determine the cause of the problem.

Constructor Detail

JDOException

public JDOException()

Constructs a new JDOException without detail message.

JDOException

public JDOException(java.lang.String msg)

Constructs a new JDOException with the specified detail message.

Parameters:

msg - the detail message.

JDOException

public JDOException(java.lang.String msg,
                    java.lang.Exception[] nested)

Constructs a new JDOException with the specified detail message and nested exceptions.

Parameters:

msg - the detail message.

nested - the nested Exception[].

JDOException

public JDOException(java.lang.String msg,
                    java.lang.Object failed)

Constructs a new JDOException with the specified detail message and failed object.

Parameters:

msg - the detail message.

failed - the failed object.

JDOException

public JDOException(java.lang.String msg,
                    java.lang.Exception[] nested,
                    java.lang.Object failed)

Constructs a new JDOException with the specified detail message, nested exceptions, and failed object.

Parameters:

msg - the detail message.

nested - the nested Exception[].

failed - the failed object.

Method Detail

getFailedObject

public java.lang.Object getFailedObject()

The exception may include a failed object.

Returns:

the failed object.

getNestedExceptions

public java.lang.Exception[] 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.

Returns:

the nested Exception array.

toString

public java.lang.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 Exceptions (if any).

Overrides:

toString in class java.lang.Throwable

Returns:

the String.