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:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected 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 SQLException	exception
protected boolean	isCommunicationFailure
static int	LOGOUT_WHILE_TRANSACTION_IN_PROGRESS
protected DatabaseQuery	query
protected 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	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

Modifier and Type	Method	Description
static DatabaseException	cannotRegisterSynchronizatonListenerForUnitOfWork(Exception e)
static DatabaseException	configurationErrorClassNotFound(String className)
static DatabaseException	configurationErrorNewInstanceIllegalAccessException(IllegalAccessException exception, Class<?> javaClass)
static DatabaseException	configurationErrorNewInstanceInstantiationException(InstantiationException exception, Class<?> javaClass)
static DatabaseException	couldNotConvertObjectType(int type)
static DatabaseException	databaseAccessorConnectionIsNull(DatabaseAccessor databaseAccessor, AbstractSession session)
static DatabaseException	databaseAccessorNotConnected()
static DatabaseException	databaseAccessorNotConnected(DatabaseAccessor databaseAccessor)
static DatabaseException	errorPreallocatingSequenceNumbers()
static DatabaseException	errorReadingBlobData()
static DatabaseException	errorRetrieveDbMetadataThroughJDBCConnection()
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.
String	getMessage()	PUBLIC: This is the database error message.
DatabaseQuery	getQuery()	PUBLIC: This method returns the databaseQuery.
DataRecord	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(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(AbstractRecord queryArguments)	PUBLIC: Set the query arguments used in the original query when exception is thrown
static DatabaseException	specifiedLockingFieldsNotFoundInDatabase(String lockingFieldName)
static DatabaseException	sqlException(SQLException exception)
static DatabaseException	sqlException(SQLException exception, boolean commError)
static DatabaseException	sqlException(SQLException exception, Accessor accessor, AbstractSession session, boolean isCommunicationFailure)
static DatabaseException	sqlException(SQLException exception, AbstractSession session, boolean commError)
static DatabaseException	sqlException(SQLException exception, Call call, Accessor accessor, AbstractSession session, boolean isCommunicationFailure)
static DatabaseException	synchronizedUnitOfWorkDoesNotSupportCommitAndResume()
static DatabaseException	transactionManagerNotSetForJTSDriver()
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.
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.

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