DatabaseException (EclipseLink 2.6.4, API Reference)

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
Modifier and Type	Field and Description
`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

Constructors
Modifier	Constructor and Description
`protected`	`DatabaseException()` INTERNAL: EclipseLink exceptions should only be thrown by the EclipseLink code.
`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

Methods
Modifier and Type	Method and Description
`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, 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

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

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)

Class DatabaseException

Field Summary

Fields inherited from class org.eclipse.persistence.exceptions.EclipseLinkException

Constructor Summary

Method Summary

Methods inherited from class org.eclipse.persistence.exceptions.EclipseLinkException

Methods inherited from class java.lang.Throwable

Methods inherited from class java.lang.Object

Field Detail

exception

call

query

queryArguments

accessor

isCommunicationFailure

SQL_EXCEPTION

CONFIGURATION_ERROR_CLASS_NOT_FOUND

DATABASE_ACCESSOR_NOT_CONNECTED

ERROR_READING_BLOB_DATA

COULD_NOT_CONVERT_OBJECT_TYPE

LOGOUT_WHILE_TRANSACTION_IN_PROGRESS

SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE

ERROR_PREALLOCATING_SEQUENCE_NUMBERS

CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_FOR_UNITOFWORK

SYNCHRONIZED_UNITOFWORK_DOES_NOT_SUPPORT_COMMITANDRESUME

CONFIGURATION_ERROR_NEW_INSTANCE_INSTANTIATION_EXCEPTION

CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ACCESS_EXCEPTION

TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER

ERROR_RETRIEVE_DB_METADATA_THROUGH_JDBC_CONNECTION

COULD_NOT_FIND_MATCHED_DATABASE_FIELD_FOR_SPECIFIED_OPTOMISTICLOCKING_FIELDS

UNABLE_TO_ACQUIRE_CONNECTION_FROM_DRIVER

DATABASE_ACCESSOR_CONNECTION_IS_NULL

Constructor Detail

DatabaseException

DatabaseException

DatabaseException

Method Detail

cannotRegisterSynchronizatonListenerForUnitOfWork

configurationErrorClassNotFound

configurationErrorNewInstanceIllegalAccessException

configurationErrorNewInstanceInstantiationException

couldNotConvertObjectType

databaseAccessorNotConnected

databaseAccessorNotConnected

databaseAccessorConnectionIsNull

errorPreallocatingSequenceNumbers

errorReadingBlobData

specifiedLockingFieldsNotFoundInDatabase

getAccessor

getDatabaseErrorCode

getMessage

getQuery

getCall

setCall

getQueryArgumentsRecord

logoutWhileTransactionInProgress

sequenceTableInformationNotComplete

setAccessor

setQuery

setQueryArguments

sqlException

sqlException

sqlException

sqlException

sqlException

synchronizedUnitOfWorkDoesNotSupportCommitAndResume

transactionManagerNotSetForJTSDriver

errorRetrieveDbMetadataThroughJDBCConnection

unableToAcquireConnectionFromDriverException

unableToAcquireConnectionFromDriverException

isCommunicationFailure

setCommunicationFailure