com.sleepycat.je

Class SecondaryReferenceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sleepycat.je.DatabaseException

com.sleepycat.je.OperationFailureException

com.sleepycat.je.SecondaryReferenceException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

SecondaryConstraintException, SecondaryIntegrityException

public abstract class SecondaryReferenceException
extends OperationFailureException

Base class for exceptions thrown when a read or write operation fails because of a secondary constraint or integrity problem. Provides accessors for getting further information about the database and keys involved in the failure. See subclasses for more information.

The Transaction handle is invalidated as a result of this exception.

Since:

4.0

See Also:

Special considerations for using Secondary Databases with and without Transactions, Serialized Form

Constructor Summary

Constructors

Constructor and Description
SecondaryReferenceException(Locker locker, String message, String secDbName, String priDbName, DatabaseEntry secKey, DatabaseEntry priKey, long priLsn, long expirationTime, ExtinctionFilter.ExtinctionStatus extinctionStatus) For internal use only.

Method Summary

Modifier and Type	Method and Description
long	getExpirationTime() Returns the expiration time of the record being accessed during the failure.
String	getPrimaryDatabaseName() Returns the name of the primary database being accessed during the failure.
DatabaseEntry	getPrimaryKey() Returns the primary key being accessed during the failure.
long	getPrimaryLsn() Returns the internal Log Sequence Number of the primary record being accessed during the failure.
String	getSecondaryDatabaseName() Returns the name of the secondary database being accessed during the failure.
DatabaseEntry	getSecondaryKey() Returns the secondary key being accessed during the failure.

Methods inherited from class com.sleepycat.je.OperationFailureException

isReplicaWrite, wrapSelf

Methods inherited from class com.sleepycat.je.DatabaseException

addErrorMessage, addRethrownStackTrace, getMessage, getVersionHeader

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SecondaryReferenceException

public SecondaryReferenceException(Locker locker,
                                   String message,
                                   String secDbName,
                                   String priDbName,
                                   DatabaseEntry secKey,
                                   DatabaseEntry priKey,
                                   long priLsn,
                                   long expirationTime,
                                   ExtinctionFilter.ExtinctionStatus extinctionStatus)

For internal use only.

Method Detail

getSecondaryDatabaseName

public String getSecondaryDatabaseName()

Returns the name of the secondary database being accessed during the failure.

getPrimaryDatabaseName

public String getPrimaryDatabaseName()

Returns the name of the primary database being accessed during the failure.

Since:

18.2

getSecondaryKey

public DatabaseEntry getSecondaryKey()

Returns the secondary key being accessed during the failure. Note that in some cases, the returned primary key can be null.

getPrimaryKey

public DatabaseEntry getPrimaryKey()

Returns the primary key being accessed during the failure. Note that in some cases, the returned primary key can be null.

getPrimaryLsn

public long getPrimaryLsn()

Returns the internal Log Sequence Number of the primary record being accessed during the failure.

Since:

18.2

getExpirationTime

public long getExpirationTime()

Returns the expiration time of the record being accessed during the failure.

Since:

7.0