JDO Exceptions

All exceptions raised by a JDO implementation are runtime exceptions which means that you can choose to catch the exceptions or not. The reason for JDO using unchecked exceptions is that JDO tries to provide transparent persistence, and so needs to present the same interface and exceptions whatever the state an object has.

JDOException

This is the base class for all JDO exceptions. It is a subclass of RuntimeException, and need not be declared or caught.


Can Retry Exceptions

JDO Can Retry Exceptions
ExceptionDescription
JDOCanRetryException This is the base class for errors that can be retried.
JDOUserException This is the base class for user errors that can be retried.
JDODataStoreException This is the base class for datastore errors that can be retried. Any root SQLException that caused this will typically be nested within this exception.
JDOObjectNotFoundException This exception is to notify the application that an object does not exist in the datastore. When this exception is thrown during a transaction, there has been no change in the status of the transaction in progress. If this exception is a nested exception thrown during commit, then the transaction is rolled back.
JDOUnsupportedOptionException This exception is thrown by an implementation to indicate that it does not implement a JDO optional feature.

Fatal Exceptions

JDO Fatal Exceptions
ExceptionDescription
JDOFatalException This is the base class for errors that cannot be retried. This exception generally means that the transaction associated with the PersistenceManager has been rolled back, and the transaction should be abandoned.
JDOFatalUserException This is the base class for user errors that cannot be retried.
JDOFatalInternalException This is the base class for JDO implementation failures.
JDOFatalDataStoreException This is the base class for fatal datastore errors. When this exception is thrown, the transaction has been rolled back. Any root SQLException that caused this will typically be nested within this exception.
JDOOptimisticVerificationException This exception is the result of a user commit operation in an optimistic transaction where the verification of new, modified, or deleted instances fails the verification. The user will never see this exception except as a result of commit.
JDODetachedFieldAccessException This exception is the result of a user accessing a field of a detached instance, where the field was not copied to the detached instance.