EclipseLink 2.2.0, build 'v20110202-r8913' API Reference

org.eclipse.persistence.exceptions
Class DatabaseException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by org.eclipse.persistence.exceptions.EclipseLinkException
                  extended by 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
protected  org.eclipse.persistence.internal.databaseaccess.Accessor accessor
           
protected  Call call
           
static int CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK
           
static int CONFIGURATION_ERROR_CLASS_NOT_FOUND
           
static int CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION
           
static int CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION
           
static int COULD_NOT_CONVERT_OBJECT_TYPE
           
static int COULD_NOT_FIND_MATCHED_DATABASE_FIELD_FOR_SPECIFIED_OPTOMISTICLOCKING_FIELDS
           
static int DATABASE_ACCESSOR_CONNECTION_IS_NULL
           
static int DATABASE_ACCESSOR_NOT_CONNECTED
           
static int ERROR_PREALLOCATING_SEQUENCE_NUMBERS
           
static int ERROR_READING_BLOB_DATA
           
static int ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION
           
protected  java.sql.SQLException exception
           
protected  boolean isCommunicationFailure
           
static int LOGOUT_WHILE_TRANSACTION_IN_PROGRESS
           
protected  DatabaseQuery query
           
protected  org.eclipse.persistence.internal.sessions.AbstractRecord queryArguments
           
static int SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE
           
static int SQL_EXCEPTION
           
static int SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME
           
static int TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER
           
static int UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER
           
 
Fields inherited from class org.eclipse.persistence.exceptions.EclipseLinkException
CR, errorCode, hasBeenLogged, indentationString, internalException, session, shouldPrintInternalException
 
Constructor Summary
protected DatabaseException(java.sql.SQLException exception)
          INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
protected DatabaseException(java.lang.String message)
          INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
 
Method Summary
static DatabaseException cannotRegisterSynchronizatonListenerForUnitOfWork(java.lang.Exception e)
           
static DatabaseException configurationErrorClassNotFound(java.lang.String className)
           
static DatabaseException configurationErrorNewInstanceIllegalAccessException(java.lang.IllegalAccessException exception, java.lang.Class javaClass)
           
static DatabaseException configurationErrorNewInstanceInstantiationException(java.lang.InstantiationException exception, java.lang.Class javaClass)
           
static DatabaseException couldNotConvertObjectType(int type)
           
static DatabaseException databaseAccessorConnectionIsNull(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor, org.eclipse.persistence.internal.sessions.AbstractSession session)
           
static DatabaseException databaseAccessorNotConnected()
           
static DatabaseException databaseAccessorNotConnected(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor databaseAccessor)
           
static DatabaseException errorPreallocatingSequenceNumbers()
           
static DatabaseException errorReadingBlobData()
           
static DatabaseException errorRetrieveDbMetadataThroughJDBCConnection()
           
 org.eclipse.persistence.internal.databaseaccess.Accessor getAccessor()
          PUBLIC: Return the accessor.
 Call getCall()
          PUBLIC: Return the call that caused the exception.
 int getDatabaseErrorCode()
          PUBLIC: This is the database error number.
 java.lang.String getMessage()
          PUBLIC: This is the database error message.
 DatabaseQuery getQuery()
          PUBLIC: This method returns the databaseQuery.
 Record getQueryArgumentsRecord()
          PUBLIC: Return the query arguments used in the original query when exception is thrown
 boolean isCommunicationFailure()
           
static DatabaseException logoutWhileTransactionInProgress()
           
static DatabaseException sequenceTableInformationNotComplete()
           
 void setAccessor(org.eclipse.persistence.internal.databaseaccess.Accessor accessor)
          INTERNAL: Set the Accessor.
 void setCall(Call call)
          INTERNAL: Set the call that caused the exception.
 void setCommunicationFailure(boolean isCommunicationFailure)
           
 void setQuery(DatabaseQuery query)
          PUBLIC: This method set the databaseQuery.
 void setQueryArguments(org.eclipse.persistence.internal.sessions.AbstractRecord queryArguments)
          PUBLIC: Set the query arguments used in the original query when exception is thrown
static DatabaseException specifiedLockingFieldsNotFoundInDatabase(java.lang.String lockingFieldName)
           
static DatabaseException sqlException(java.sql.SQLException exception)
           
static DatabaseException sqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean commError)
           
static DatabaseException sqlException(java.sql.SQLException exception, org.eclipse.persistence.internal.databaseaccess.Accessor accessor, org.eclipse.persistence.internal.sessions.AbstractSession session, boolean isCommunicationFailure)
           
static DatabaseException sqlException(java.sql.SQLException exception, boolean commError)
           
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)
           
static DatabaseException synchronizedUnitOfWorkDoesNotSupportCommitAndResume()
           
static DatabaseException transactionManagerNotSetForJTSDriver()
           
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.
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.
 
Methods inherited from class org.eclipse.persistence.exceptions.EclipseLinkException
cr, getErrorCode, getIndentationString, getInternalException, getSession, hasBeenLogged, printStackTrace, printStackTrace, printStackTrace, setErrorCode, setHasBeenLogged, setIndentationString, setInternalException, setSession, setShouldPrintInternalException, shouldPrintInternalException, toString
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, setStackTrace
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

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(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:
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 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)

EclipseLink 2.2.0, build 'v20110202-r8913' API Reference