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:
java.io.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 protectedDatabaseException()INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.protectedDatabaseException(java.lang.String message)INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.protectedDatabaseException(java.sql.SQLException exception)INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static DatabaseExceptioncannotRegisterSynchronizatonListenerForUnitOfWork(java.lang.Exception e)static DatabaseExceptionconfigurationErrorClassNotFound(java.lang.String className)static DatabaseExceptionconfigurationErrorNewInstanceIllegalAccessException(java.lang.IllegalAccessException exception, java.lang.Class javaClass)static DatabaseExceptionconfigurationErrorNewInstanceInstantiationException(java.lang.InstantiationException exception, java.lang.Class javaClass)static DatabaseExceptioncouldNotConvertObjectType(int type)static DatabaseExceptiondatabaseAccessorConnectionIsNull(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor, org.eclipse.persistence.internal.sessions.AbstractSession session)static DatabaseExceptiondatabaseAccessorNotConnected()static DatabaseExceptiondatabaseAccessorNotConnected(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor)static DatabaseExceptionerrorPreallocatingSequenceNumbers()static DatabaseExceptionerrorReadingBlobData()static DatabaseExceptionerrorRetrieveDbMetadataThroughJDBCConnection()org.eclipse.persistence.internal.databaseaccess.AccessorgetAccessor()PUBLIC: Return the accessor.CallgetCall()PUBLIC: Return the call that caused the exception.intgetDatabaseErrorCode()PUBLIC: This is the database error number.java.lang.StringgetMessage()PUBLIC: This is the database error message.DatabaseQuerygetQuery()PUBLIC: This method returns the databaseQuery.RecordgetQueryArgumentsRecord()PUBLIC: Return the query arguments used in the original query when exception is thrownbooleanisCommunicationFailure()static DatabaseExceptionlogoutWhileTransactionInProgress()static DatabaseExceptionsequenceTableInformationNotComplete()voidsetAccessor(org.eclipse.persistence.internal.databaseaccess.Accessor accessor)INTERNAL: Set the Accessor.voidsetCall(Call call)INTERNAL: Set the call that caused the exception.voidsetCommunicationFailure(boolean isCommunicationFailure)voidsetQuery(DatabaseQuery query)PUBLIC: This method set the databaseQuery.voidsetQueryArguments(org.eclipse.persistence.internal.sessions.AbstractRecord queryArguments)PUBLIC: Set the query arguments used in the original query when exception is thrownstatic DatabaseExceptionspecifiedLockingFieldsNotFoundInDatabase(java.lang.String lockingFieldName)static DatabaseExceptionsqlException(java.sql.SQLException exception)static DatabaseExceptionsqlException(java.sql.SQLException exception, boolean commError)static DatabaseExceptionsqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.databaseaccess.Accessor accessor, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isCommunicationFailure)static DatabaseExceptionsqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean commError)static DatabaseExceptionsqlException(java.sql.SQLException exception, Call call, org.eclipse.persistence.internal.databaseaccess.Accessor accessor, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isCommunicationFailure)static DatabaseExceptionsynchronizedUnitOfWorkDoesNotSupportCommitAndResume()static DatabaseExceptiontransactionManagerNotSetForJTSDriver()static DatabaseExceptionunableToAcquireConnectionFromDriverException(java.lang.String driver, java.lang.String user, java.lang.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.static DatabaseExceptionunableToAcquireConnectionFromDriverException(java.sql.SQLException exception, java.lang.String driver, java.lang.String user, java.lang.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.-
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
-
-
-
-
Field Detail
-
exception
protected java.sql.SQLException exception
-
call
protected transient Call call
-
query
protected transient DatabaseQuery query
-
queryArguments
protected transient org.eclipse.persistence.internal.sessions.AbstractRecord queryArguments
-
accessor
protected transient org.eclipse.persistence.internal.databaseaccess.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(java.lang.String message)
INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
-
DatabaseException
protected DatabaseException(java.sql.SQLException exception)
INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
-
-
Method Detail
-
cannotRegisterSynchronizatonListenerForUnitOfWork
public static DatabaseException cannotRegisterSynchronizatonListenerForUnitOfWork(java.lang.Exception e)
-
configurationErrorClassNotFound
public static DatabaseException configurationErrorClassNotFound(java.lang.String className)
-
configurationErrorNewInstanceIllegalAccessException
public static DatabaseException configurationErrorNewInstanceIllegalAccessException(java.lang.IllegalAccessException exception, java.lang.Class javaClass)
-
configurationErrorNewInstanceInstantiationException
public static DatabaseException configurationErrorNewInstanceInstantiationException(java.lang.InstantiationException exception, java.lang.Class javaClass)
-
couldNotConvertObjectType
public static DatabaseException couldNotConvertObjectType(int type)
-
databaseAccessorNotConnected
public static DatabaseException databaseAccessorNotConnected()
-
databaseAccessorNotConnected
public static DatabaseException databaseAccessorNotConnected(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor)
-
databaseAccessorConnectionIsNull
public static DatabaseException databaseAccessorConnectionIsNull(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor, org.eclipse.persistence.internal.sessions.AbstractSession session)
-
errorPreallocatingSequenceNumbers
public static DatabaseException errorPreallocatingSequenceNumbers()
-
errorReadingBlobData
public static DatabaseException errorReadingBlobData()
-
specifiedLockingFieldsNotFoundInDatabase
public static DatabaseException specifiedLockingFieldsNotFoundInDatabase(java.lang.String lockingFieldName)
-
getAccessor
public org.eclipse.persistence.internal.databaseaccess.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 java.lang.String getMessage()
PUBLIC: This is the database error message.- Overrides:
getMessagein 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(org.eclipse.persistence.internal.databaseaccess.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(org.eclipse.persistence.internal.sessions.AbstractRecord queryArguments)
PUBLIC: Set the query arguments used in the original query when exception is thrown
-
sqlException
public static DatabaseException sqlException(java.sql.SQLException exception)
-
sqlException
public static DatabaseException sqlException(java.sql.SQLException exception, boolean commError)
-
sqlException
public static DatabaseException sqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean commError)
-
sqlException
public static DatabaseException sqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.databaseaccess.Accessor accessor, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isCommunicationFailure)
-
sqlException
public static DatabaseException sqlException(java.sql.SQLException exception, Call call, org.eclipse.persistence.internal.databaseaccess.Accessor accessor, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isCommunicationFailure)
-
synchronizedUnitOfWorkDoesNotSupportCommitAndResume
public static DatabaseException synchronizedUnitOfWorkDoesNotSupportCommitAndResume()
-
transactionManagerNotSetForJTSDriver
public static DatabaseException transactionManagerNotSetForJTSDriver()
-
errorRetrieveDbMetadataThroughJDBCConnection
public static DatabaseException errorRetrieveDbMetadataThroughJDBCConnection()
-
unableToAcquireConnectionFromDriverException
public static DatabaseException unableToAcquireConnectionFromDriverException(java.lang.String driver, java.lang.String user, java.lang.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(java.sql.SQLException exception, java.lang.String driver, java.lang.String user, java.lang.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)
-
-