Module org.eclipse.persistence.core
Package org.eclipse.persistence.exceptions

Class DatabaseException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.eclipse.persistence.exceptions.EclipseLinkException
org.eclipse.persistence.exceptions.DatabaseException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
EISException
public class DatabaseException extends EclipseLinkException

Purpose: Wrapper for any database exception that occurred through EclipseLink.

See Also:

  • Field Details

    • exception

      protected SQLException exception

    • call

      protected transient Call call

    • query

      protected transient DatabaseQuery query

    • queryArguments

      protected transient AbstractRecord queryArguments

    • accessor

      protected transient Accessor accessor

    • isCommunicationFailure

      protected boolean isCommunicationFailure

    • SQL_EXCEPTION

      public static final int SQL_EXCEPTION
      See Also:

    • CONFIGURATION_ERROR_CLASS_NOT_FOUND

      public static final int CONFIGURATION_ERROR_CLASS_NOT_FOUND
      See Also:

    • DATABASE_ACCESSOR_NOT_CONNECTED

      public static final int DATABASE_ACCESSOR_NOT_CONNECTED
      See Also:

    • ERROR_READING_BLOB_DATA

      public static final int ERROR_READING_BLOB_DATA
      See Also:

    • COULD_NOT_CONVERT_OBJECT_TYPE

      public static final int COULD_NOT_CONVERT_OBJECT_TYPE
      See Also:

    • LOGOUT_WHILE_TRANSACTION_IN_PROGRESS

      public static final int LOGOUT_WHILE_TRANSACTION_IN_PROGRESS
      See Also:

    • SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE

      public static final int SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE
      See Also:

    • ERROR_PREALLOCATING_SEQUENCE_NUMBERS

      public static final int ERROR_PREALLOCATING_SEQUENCE_NUMBERS
      See Also:

    • CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK

      public static final int CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK
      See Also:

    • SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME

      public static final int SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME
      See Also:

    • CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION

      public static final int CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION
      See Also:

    • CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION

      public static final int CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION
      See Also:

    • TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER

      public static final int TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER
      See Also:

    • ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION

      public static final int ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION
      See Also:

    • COULD_NOT_FIND_MATCHED_DATABASE_FIELD_FOR_SPECIFIED_OPTOMISTICLOCKING_FIELDS

      public static final int COULD_NOT_FIND_MATCHED_DATABASE_FIELD_FOR_SPECIFIED_OPTOMISTICLOCKING_FIELDS
      See Also:

    • UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER

      public static final int UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER
      See Also:

    • DATABASE_ACCESSOR_CONNECTION_IS_NULL

      public static final int DATABASE_ACCESSOR_CONNECTION_IS_NULL
      See Also:

  • Constructor Details

    • DatabaseException

      protected DatabaseException()
      INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.

    • DatabaseException

      protected DatabaseException(String message)
      INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.

    • DatabaseException

      protected DatabaseException(SQLException exception)
      INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.

  • Method Details

    • cannotRegisterSynchronizatonListenerForUnitOfWork

      public static DatabaseException cannotRegisterSynchronizatonListenerForUnitOfWork(Exception e)

    • configurationErrorClassNotFound

      public static DatabaseException configurationErrorClassNotFound(String className)

    • configurationErrorNewInstanceIllegalAccessException

      public static DatabaseException configurationErrorNewInstanceIllegalAccessException(IllegalAccessException exception, Class<?> javaClass)

    • configurationErrorNewInstanceInstantiationException

      public static DatabaseException configurationErrorNewInstanceInstantiationException(InstantiationException exception, Class<?> javaClass)

    • couldNotConvertObjectType

      public static DatabaseException couldNotConvertObjectType(int type)

    • databaseAccessorNotConnected

      public static DatabaseException databaseAccessorNotConnected()

    • databaseAccessorNotConnected

      public static DatabaseException databaseAccessorNotConnected(DatabaseAccessor databaseAccessor)

    • databaseAccessorConnectionIsNull

      public static DatabaseException databaseAccessorConnectionIsNull(DatabaseAccessor databaseAccessor, AbstractSession session)

    • errorPreallocatingSequenceNumbers

      public static DatabaseException errorPreallocatingSequenceNumbers()

    • errorReadingBlobData

      public static DatabaseException errorReadingBlobData()

    • specifiedLockingFieldsNotFoundInDatabase

      public static DatabaseException specifiedLockingFieldsNotFoundInDatabase(String lockingFieldName)

    • getAccessor

      public Accessor getAccessor()
      PUBLIC: Return the accessor.

    • getDatabaseErrorCode

      public int getDatabaseErrorCode()
      PUBLIC: This is the database error number. Since it is possible to have no internal exception the errorCode will be zero in this case.

    • getMessage

      public String getMessage()
      PUBLIC: This is the database error message.
      Overrides:
      getMessage in class EclipseLinkException

    • getQuery

      public DatabaseQuery getQuery()
      PUBLIC: This method returns the databaseQuery. DatabaseQuery is a visible class to the EclipseLink user. Users create an appropriate query by creating an instance of a concrete subclasses of DatabaseQuery.

    • getCall

      public Call getCall()
      PUBLIC: Return the call that caused the exception.

    • setCall

      public void setCall(Call call)
      INTERNAL: Set the call that caused the exception.

    • getQueryArgumentsRecord

      public DataRecord getQueryArgumentsRecord()
      PUBLIC: Return the query arguments used in the original query when exception is thrown

    • logoutWhileTransactionInProgress

      public static DatabaseException logoutWhileTransactionInProgress()

    • sequenceTableInformationNotComplete

      public static DatabaseException sequenceTableInformationNotComplete()

    • setAccessor

      public void setAccessor(Accessor accessor)
      INTERNAL: Set the Accessor.

    • setQuery

      public void setQuery(DatabaseQuery query)
      PUBLIC: This method set the databaseQuery. DatabaseQuery is a visible class to the EclipseLink user. Users create an appropriate query by creating an instance of a concrete subclasses of DatabaseQuery.

    • setQueryArguments

      public void setQueryArguments(AbstractRecord queryArguments)
      PUBLIC: Set the query arguments used in the original query when exception is thrown

    • sqlException

      public static DatabaseException sqlException(SQLException exception)

    • sqlException

      public static DatabaseException sqlException(SQLException exception, boolean commError)

    • sqlException

      public static DatabaseException sqlException(SQLException exception, AbstractSession session, boolean commError)

    • sqlException

      public static DatabaseException sqlException(SQLException exception, Accessor accessor, AbstractSession session, boolean isCommunicationFailure)

    • sqlException

      public static DatabaseException sqlException(SQLException exception, Call call, Accessor accessor, AbstractSession session, boolean isCommunicationFailure)

    • synchronizedUnitOfWorkDoesNotSupportCommitAndResume

      public static DatabaseException synchronizedUnitOfWorkDoesNotSupportCommitAndResume()

    • transactionManagerNotSetForJTSDriver

      public static DatabaseException transactionManagerNotSetForJTSDriver()

    • errorRetrieveDbMetadataThroughJDBCConnection

      public static DatabaseException errorRetrieveDbMetadataThroughJDBCConnection()

    • unableToAcquireConnectionFromDriverException

      public static DatabaseException unableToAcquireConnectionFromDriverException(String driver, String user, String url)
      The connection returned from this driver was null, the driver may be missing(using the default) or the wrong one for the database.

    • unableToAcquireConnectionFromDriverException

      public static DatabaseException unableToAcquireConnectionFromDriverException(SQLException exception, String driver, String user, String url)
      The connection returned from this driver was null, the driver may be missing(using the default) or the wrong one for the database.

    • isCommunicationFailure

      public boolean isCommunicationFailure()

    • setCommunicationFailure

      public void setCommunicationFailure(boolean isCommunicationFailure)