com.sleepycat.je

Class ForeignConstraintException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sleepycat.je.DatabaseException

com.sleepycat.je.OperationFailureException

com.sleepycat.je.SecondaryReferenceException

com.sleepycat.je.SecondaryConstraintException

com.sleepycat.je.ForeignConstraintException

All Implemented Interfaces:

Serializable

public class ForeignConstraintException
extends SecondaryConstraintException

Thrown when an attempt to write a primary database record would insert a secondary record with a key that does not exist in a foreign key database, when the secondary key is configured as a foreign key.

When using the base API (com.sleepycat.je), this can occur when a SecondaryDatabase is configured to be associated with a foreign key database (see SecondaryConfig.setForeignKeyDatabase(com.sleepycat.je.Database)).

When using the DPL (com.sleepycat.persist), this can occur when a SecondaryKey is defined with a SecondaryKey.relatedEntity().

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
ForeignConstraintException(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
OperationFailureException	wrapSelf(String msg) For internal use only.

Methods inherited from class com.sleepycat.je.SecondaryReferenceException

getExpirationTime, getPrimaryDatabaseName, getPrimaryKey, getPrimaryLsn, getSecondaryDatabaseName, getSecondaryKey

Methods inherited from class com.sleepycat.je.OperationFailureException

isReplicaWrite

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

ForeignConstraintException

public ForeignConstraintException(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

wrapSelf

public OperationFailureException wrapSelf(String msg)

For internal use only.

Specified by:

wrapSelf in class OperationFailureException