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:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class org.eclipse.persistence.exceptions.EclipseLinkException
CR, errorCode, hasBeenLogged, indentationString, internalException, session, shouldPrintInternalException
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
DatabaseException()
INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.protected
DatabaseException(String message)
INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.protected
DatabaseException(SQLException exception)
INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
-
Method Summary
-
Methods inherited from class org.eclipse.persistence.exceptions.EclipseLinkException
cr, getErrorCode, getIndentationString, getInternalException, getSession, getUnformattedMessage, hasBeenLogged, printStackTrace, printStackTrace, printStackTrace, setErrorCode, setHasBeenLogged, setIndentationString, setInternalException, setSession, setShouldPrintInternalException, shouldPrintInternalException, toString
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace
-
-
-
-
Field Detail
-
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:
- Constant Field Values
-
CONFIGURATION_ERROR_CLASS_NOT_FOUND
public static final int CONFIGURATION_ERROR_CLASS_NOT_FOUND
- See Also:
- Constant Field Values
-
DATABASE_ACCESSOR_NOT_CONNECTED
public static final int DATABASE_ACCESSOR_NOT_CONNECTED
- See Also:
- Constant Field Values
-
ERROR_READING_BLOB_DATA
public static final int ERROR_READING_BLOB_DATA
- See Also:
- Constant Field Values
-
COULD_NOT_CONVERT_OBJECT_TYPE
public static final int COULD_NOT_CONVERT_OBJECT_TYPE
- See Also:
- Constant Field Values
-
LOGOUT_WHILE_TRANSACTION_IN_PROGRESS
public static final int LOGOUT_WHILE_TRANSACTION_IN_PROGRESS
- See Also:
- Constant Field Values
-
SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE
public static final int SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE
- See Also:
- Constant Field Values
-
ERROR_PREALLOCATING_SEQUENCE_NUMBERS
public static final int ERROR_PREALLOCATING_SEQUENCE_NUMBERS
- See Also:
- Constant Field Values
-
CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK
public static final int CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK
- See Also:
- Constant Field Values
-
SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME
public static final int SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME
- See Also:
- Constant Field Values
-
CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION
public static final int CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION
- See Also:
- Constant Field Values
-
CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION
public static final int CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION
- See Also:
- Constant Field Values
-
TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER
public static final int TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER
- See Also:
- Constant Field Values
-
ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION
public static final int ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION
- See Also:
- Constant Field Values
-
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:
- Constant Field Values
-
UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER
public static final int UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER
- See Also:
- Constant Field Values
-
DATABASE_ACCESSOR_CONNECTION_IS_NULL
public static final int DATABASE_ACCESSOR_CONNECTION_IS_NULL
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
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 Detail
-
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 classEclipseLinkException
-
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 Record 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.- Parameters:
driver
-- Returns:
-
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.- Parameters:
exception
-driver
-- Returns:
-
isCommunicationFailure
public boolean isCommunicationFailure()
-
setCommunicationFailure
public void setCommunicationFailure(boolean isCommunicationFailure)
-
-