de.ipcon.db.testing

Class TestTransaction

java.lang.Object

de.ipcon.db.core.Transaction

de.ipcon.db.testing.TestTransaction

All Implemented Interfaces:

BLOBLoaderI, BOLoaderI, BOLoaderWithCacheI, BOProcHolderI, BOQueryLoaderI, GrooqlBOLoaderI, SchemaProviderI, java.io.Serializable

Direct Known Subclasses:

TestTransactionV2

public class TestTransaction
extends Transaction

This is an extension of the Transaction class intended for testenvironments, where no underlying database for queries exist.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class de.ipcon.db.core.Transaction

Transaction.Additional, Transaction.FillBOResult, Transaction.Savepoint

Nested classes/interfaces inherited from interface de.ipcon.db.core.BOQueryLoaderI

BOQueryLoaderI.InternalHelper

Field Summary

Fields inherited from class de.ipcon.db.core.Transaction

bos, clientSaveLock, description, GET_ORIGNODE_DEFAULT_VALUE, LOG_LEVEL_DEBUG, LOG_LEVEL_DISABLE, LOG_LEVEL_ERROR, LOG_LEVEL_INFO, LOG_LEVEL_WARN, newbos, procs, PROPERTY_SCOPE_COMMIT, PROPERTY_SCOPE_PERSISTENT, PROPERTY_SCOPE_SAVEPOINT, PROPERTY_SCOPE_SERVER, PROPERTY_SCOPE_TRANSACTION, purges, refs, remarks, savePhase, SKIP_CLIENT_VERIFIES_FOR_ADMINS, SKIP_RECALCS_FOR_DATA_REPAIR, SKIP_SERVER_VERIFIES_FOR_ADMINS

Constructor Summary

Constructors

Constructor and Description
TestTransaction(BOLoaderI _loader)
TestTransaction(BOLoaderI _loader, java.lang.String _desc)

Method Summary

Modifier and Type	Method and Description
void	enterSavePhase()
BO	frapFromCache(BO bo) This method assures that the given BO instance gets this Transaction set as its BOLoader and also only references other BO instances that are in the cache of this Transaction (are "known to it", see isKnown()) and have this Transaction set as their BOLoader too.
BOT	getBOT(java.lang.Class<? extends BOI> clazz)
BN	getCurrentBN()
static TestTransaction	getInstance(BOLoaderI _loader)
static TestTransaction	getInstance(BOLoaderI _loader, SchemaI _schema)
static TestTransaction	getInstance(BOLoaderI _loader, SchemaI _schema, java.lang.String _desc)
static TestTransaction	getInstance(BOLoaderI _loader, java.lang.String _desc)
java.lang.Long	getNextId() get a unique Long id from the backend.
boolean	isTesting() Returns true if this BOLoaderI is for testing only, i.e. used in JUnit testing environments only.
void	setCurrentBN(BN $34)
long	simulateSave() Call this method to simulate saving the included BOs, adding them to the caches and sets their ID to a nonnegative number larger than sid.
long	simulateSave(boolean doVerify) Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.
long	simulateSave(long sid)
long	simulateSave(long sid, boolean doVerify) Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.
long	simulateSave(long sid, SimulateSaveVerificationMode verificationMode)
long	simulateSave(SimulateSaveVerificationMode verificationMode) Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.

Methods inherited from class de.ipcon.db.core.Transaction

acquireReadLock, acquireWriteLock, addFixingProc, addProc, addRemark, allLocalsToString, allProcsToString, allProcsToString, allProcsToString, allProcsToString, allProcsToString, allProcsToString, appendDescription, applyOtherTransactionsSaveSuccess, assertWriteLock, assureBotClass, canonize, canonize, canonize, checkIntegrity, checkpoint, close, closeAndClearLazyData, commit, commitBLOBs, continueWithTempIdsFrom, copyLocalsFrom, copyLocalsFrom, copyLocalsFrom, createOrTouchAdditional, currentSavepointToString, deepClone, deepClone, deepClone, deepClone, deserialize, disableBORecalc, disableClientVerification, disableServerVerification, disconnectBOs, disconnectBOs, drain, dumpCache, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, dumpProcs, evaluateVerifyOnServer, evaluateVerifyOnServer, execute, exists, exists, fillBO, fillBO, fillBO, fillBO, fillBO, fillBO, fillBO, filterAdditionals, finalizeSaveProcedure, finishBLOBs, fireAfterSave, flagAsMassChange, flagAsUserChoseToOverrideSaveVetoExceptions, flush, flushLocals, frapBO, frapBOAndHandleNonPersistentAttributes, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOBInfo, getBLOBInfo, getBLOBProcs, getBLOBProcs, getBLOBProcsBOIds, getBLOBProcsBOIds, getBO, getBO, getBO, getBO, getBOByAttr, getBOByAttr, getBOByAttr, getBOByAttr, getBOByAttrs, getBOByAttrs, getBOByAttrs, getBOByAttrs, getBOByStringAttr, getBOByStringAttr, getBOByStringAttr, getBOByStringAttr, getBOByStringAttrs, getBOByStringAttrs, getBOByStringAttrs, getBOByStringAttrs, getBOLoader, getBOs, getBOs, getBOs, getBOs, getBOs, getBOs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOUncached, getBOUncached, getBOUncached, getBT, getBTId, getCanonizedProcs, getCanonizedProcs, getCanonizedProcs, getCanonizedProcs, getClientSideId, getCryptoHandler, getCurrentUser, getDeletedBOCount, getDeletedBOCount, getDeletedBOIds, getDeletedBOIds, getDeletedBOIds, getDepMaps, getDescription, getDumper, getEventProvider, getFeatureManager, getFileVault, getFinalScope, getHumanReadablePropertyScope, getIncludedBOCount, getIncludedBOIds, getIncludedBOIds, getIncludedBOIds, getIncludedBOs, getIncludedBOsFiltered, getIncludedBOsFiltered, getIncludedBOsFiltered, getInstance, getInstance, getKnown, getKnown, getKnownBOs, getKnownBOs, getKnownBOs, getLatestSavepoint, getLocalLastModifiedBOs, getLogLevel, getLogPrefixForProgress, getMessageBus, getMiniDesc, getNewBOCount, getNewBOs, getNewValue, getOldValue, getOrigBTId, getOrigin, getOrigNode, getOrigNodeNN, getOrigTime, getOrigUser, getParentLoader, getPersistenceHandlerInSavePhase, getPersistentBooleanProperty, getPersistentDecimalProperty, getPersistentLongProperty, getPersistentPropertyKey, getPersistentStringProperty, getProcCount, getProcs, getProcs, getProcs, getProperty, getProvider, getPurgedBOCount, getPurgedBOCount, getRelationBOs, getRemarks, getRootLoader, getRootPaneToLockOnConnectionInterrupt, getSavepoints, getSavesCount, getSavesCountNN, getSchema, getSummary, getTemporaryIdSupplier, hasBLOB, hasBLOB, hasBLOBProcs, hasNewBOs, hasPersistentProperty, hasProcs, hasProperty, hasPurges, hasSavepoint, hasSavepoints, haveBLOB, include, include, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, includeCopy, incorporateDiffOfConflictingBO, increaseSavesCount, initProcCache, initRemarks, isActive, isAlwaysReloadOnFrap, isAnyAttributeChangedExcept, isAnyAttributeChangedExcept, isAnyAttributeChangedExcept, isAnyAttributeChangedExcept, isAnyAttributeChangedExcept, isAnyAttributeChangedExcept, isAttributeChanged, isAttributeChanged, isAttributeChanged, isAttributeInitialized, isAttributeNulled, isBOOrAnyToOneReachableBOInvolved, isBORecalcsDisabled, isCaching, isClientVerificationDisabled, isClosed, isClosing, isCreated, isDeletedOrNotInvolved, isDiffingMode, isExplicitActive, isForORMScript, isIgnoreBotCoherency, isIncluded, isInhibitDefaults, isInitEnvironmentMode, isInOTRMode, isInstance, isInvolved, isKnown, isKnown, isLocked, isLoggedIn, isLoggedInNN, isMassChange, isNotPersistentParm, isOnAuthoritativeSyncServer, isOneOfAttributesChanged, isOneOfAttributesChanged, isOneOfAttributesChanged, isPropertyFinal, isPurged, isRecording, isRecordNonPersistent, isRepairMode, isScopeCommit, isScopePersistent, isScopeSavepoint, isScopeServer, isScopeTransaction, isScopeValid, isServerVerificationDisabled, isSkipClientVerifiesForAdmins, isSkipServerVerifiesForAdmins, isSyncMode, isUnderAdminControl, isUnderBackendControl, isUnderServiceControl, isUnderSystemUserControl, isUndo, isUndoWithoutTimeTravel, isUndoWithTimeTravel, isUserChoseToOverrideSaveVetoExceptions, killNewProcsRunner, logDebug, logError, logInfo, logWarn, markForORMScript, markForSkipClientVerifiesForAdmins, markForSkipServerVerifiesForAdmins, mergeIn, mergeIn, mergeIn, newBOsToString, newBOsToString, newBOsToString, playReverse, precommitBLOBs, prepareFillBO, prepareFillBO, prepareFillBO, prepareFillBO, prepareFillBO, prepareFillBO, prepareFillBO, prepareQuery, prepareQuery, prependBTs, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, procsToString, query, query, query, queryBO, queryBO, queryBO, queryBO, queryBO, queryRelation, readBOInstance, readInstance, readInstance, readInstance, readProcInstance, recalcOfBOsShouldBeCanceled, recordAdd, recordAdd, recordPurge, recordRemove, recordSet, refBO, refBO, refBO, refBO, refBO, refParm, refParm, refParm, refParm, refParm, reFrapAfterSave, rehashCache, releaseReadLock, releaseWriteLock, removeBLOB, replay, replay, replayInStoreFinish, replayInStoreLog, replayInStorePrepare, replayInStoreWithoutLog, resetReversedMode, restoreBLOBHandlesFrom, rollback, rollbackBLOBs, rollbackLatestSavepoint, savepoint, savepoint, savepointBelongsHere, serialize, serverLocalTransactionStoreFinish, serverLocalTransactionStorePrepare, setAlwaysReloadOnFrap, setBOLoader, setBTId, setCurrentUser, setDescription, setDiffingMode, setExplicitActive, setIgnoreBotCoherency, setInhibitDefaults, setInitEnvironmentMode, setLocalLastModifiedBOs, setLogLevel, setOrigBTId, setOrigin, setOrigNode, setOrigTime, setOrigUser, setPersistentBooleanProperty, setPersistentDecimalProperty, setPersistentLongProperty, setPersistentStringProperty, setProperty, setProperty, setProvider, setRecordNonPersistent, setRepairMode, setRootPaneToLockOnConnectionInterrupt, setSavesCount, setSyncMode, setTemporaryIdSupplier, storeBLOB, stubClone, stubClone, testAuth, testAuth, toString, toString, tryAcquireReadLock, upgradeLocks, wasBLOBChanged, wasBLOBCreated, wasBLOBDeleted, wasDeleted, weHaveReadLock, writeBOInstance, writeInstanceToServer, writeInstanceWithoutBLOBTransfer, writeProcInstance

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.ipcon.db.core.BOLoaderI

frapBOArrayFromCache, frapBOIArrayFromCache, frapBOsFromCache, frapFromCache, isAncestorOf, isRootLoader, isServerSide, prepareQuery

Methods inherited from interface de.ipcon.db.blob.BLOBLoaderI

haveBLOB, haveBLOB

Methods inherited from interface de.ipcon.db.core.BOQueryLoaderI

getOneBOByAttr, getUniqueBOByAttr

Methods inherited from interface de.ipcon.db.core.BOProcHolderI

procsToString

Constructor Detail

TestTransaction

public TestTransaction(BOLoaderI _loader)

TestTransaction

public TestTransaction(BOLoaderI _loader,
                       java.lang.String _desc)

Method Detail

getInstance

public static TestTransaction getInstance(BOLoaderI _loader)

getInstance

public static TestTransaction getInstance(BOLoaderI _loader,
                                          java.lang.String _desc)

getInstance

public static TestTransaction getInstance(BOLoaderI _loader,
                                          SchemaI _schema)

getInstance

public static TestTransaction getInstance(BOLoaderI _loader,
                                          SchemaI _schema,
                                          java.lang.String _desc)

isTesting

public boolean isTesting()

Description copied from interface: BOLoaderI

Returns true if this BOLoaderI is for testing only, i.e. used in JUnit testing environments only.

frapFromCache

public BO frapFromCache(BO bo)

Description copied from class: Transaction

This method assures that the given BO instance gets this Transaction set as its BOLoader and also only references other BO instances that are in the cache of this Transaction (are "known to it", see isKnown()) and have this Transaction set as their BOLoader too. FIXME More explanations why frapping is necessary. The given BO instance will be cloned and that copy will be put into the cache and be modified if there is not already a matching instance there. This method should be used - instead of frapBO() - in cases where the Transaction gets BO instances that may also be used by/shared with other code unrelated to the code that uses this transaction - for examples BO instances from a CachingBOLoader that is used by other code/classes too. FIXME! To be on the safe side you could probably always use frapFromCache() instead of frapBO() - which is probably not what was intended. See also related comment in frapBO().

Specified by:

frapFromCache in interface BOLoaderI

Overrides:

frapFromCache in class Transaction

Parameters:

bo - the BO that should be frapped.

Returns:

if an instance of the given BO is already in the TX cache returns that - which then may be either the given instance itself or a different one; otherwise return a copy of the given instance (after having put the copy in the cache).

getBOT

public BOT getBOT(java.lang.Class<? extends BOI> clazz)

Specified by:

getBOT in interface BOLoaderI

Overrides:

getBOT in class Transaction

getNextId

public java.lang.Long getNextId()

Description copied from interface: BOLoaderI

get a unique Long id from the backend. Please note that the ids drawn here are considered 'consumed'. An intentional delay in the backend safeguards that the process of consuming all usable ids from an instance will take at least about 29247120867 years.

Specified by:

getNextId in interface BOLoaderI

Overrides:

getNextId in class Transaction

Returns:

Long id which is guaranteed to be unique within the whole cluster.

enterSavePhase

public void enterSavePhase()

Overrides:

enterSavePhase in class Transaction

simulateSave

public long simulateSave(boolean doVerify)

Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.

Overrides:

simulateSave in class Transaction

Parameters:

doVerify - if true, calls the different verify-methods when saving.

Returns:

the last id used to persist a new BO, incremented by one.

simulateSave

public long simulateSave(long sid,
                         boolean doVerify)

Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.

Overrides:

simulateSave in class Transaction

Parameters:

sid - the simulated Id that was used the latest

doVerify - if true, calls the different verify-methods when saving.

Returns:

the last id used to persist a new BO, incremented by one.

simulateSave

public long simulateSave(SimulateSaveVerificationMode verificationMode)

Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.

Parameters:

verificationMode - enum constant that specifies which verification methods should be executed

Returns:

the last id used to persist a new BO, incremented by one.

simulateSave

public long simulateSave()

Call this method to simulate saving the included BOs, adding them to the caches and sets their ID to a nonnegative number larger than sid. If doVerify is true, calls the different verify methods before committing. Use ONLY in test environments, e.g. unit tests.

Overrides:

simulateSave in class Transaction

Parameters:

sid - replaces the id of newbos with a consecutive number larger than this value (minimum 0)

doVerify - if true, calls the different verify-methods

Returns:

the last used final id + 1

simulateSave

public long simulateSave(long sid)

Overrides:

simulateSave in class Transaction

simulateSave

public long simulateSave(long sid,
                         SimulateSaveVerificationMode verificationMode)

getCurrentBN

public BN getCurrentBN()

setCurrentBN

public void setCurrentBN(BN $34)