Transaction (MyTISM API Documentation)

java.lang.Object
- de.ipcon.db.core.Transaction

All Implemented Interfaces:

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

Direct Known Subclasses:

TestTransaction
```
public class Transaction
extends java.lang.Object
implements java.io.Serializable, BOLoaderWithCacheI, BOProcHolderI
```
This is a lightweight implementation of a Transaction initially tailored for outside server operation (=client side), it's now used in the server core, too. The notion of a Transaction itself is not transparent, although the change recording of the objects itself is, but the inclusion and creation of objects is not. This is intentional. Although the constructor is public, it should be avoided to directly instantiate Transaction object, but get them from a TransactionProviderI.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Transaction.Additional

static class Transaction.FillBOResult

class Transaction.Savepoint
- Nested classes/interfaces inherited from interface de.ipcon.db.core.BOQueryLoaderI
  BOQueryLoaderI.InternalHelper

Nested Classes
Modifier and Type	Class and Description
`static class`	`Transaction.Additional`
`static class`	`Transaction.FillBOResult`
`class`	`Transaction.Savepoint`

Field Summary

Fields
Modifier and Type	Field and Description
`IndexedHashSet<BO>`	`bos` The BOs which are included in the Transaction and for which modifications are recorded; a subset of "refs".
`java.lang.Integer`	`clientSaveLock` synchronize saves of this tx in the client / GUI
`java.lang.String`	`description`
`static int`	`GET_ORIGNODE_DEFAULT_VALUE`
`static int`	`LOG_LEVEL_DEBUG`
`static int`	`LOG_LEVEL_DISABLE`
`static int`	`LOG_LEVEL_ERROR`
`static int`	`LOG_LEVEL_INFO`
`static int`	`LOG_LEVEL_WARN`
`IndexedHashSet<BO>`	`newbos` The BOs which were newly created in this Transaction; a subset of "bos".
`java.util.ArrayList<BOProc>`	`procs` The procedures to be executed when restoring to the server
`static byte`	`PROPERTY_SCOPE_COMMIT` A property stored with this scope is removed after commit.
`static byte`	`PROPERTY_SCOPE_PERSISTENT` A property stored with this scope is transferred to the server and available there and additionally stored as a persistent property of the BT created from this TX.
`static byte`	`PROPERTY_SCOPE_SAVEPOINT` A property stored with this scope is present in the current Savepoint and is removed once the Savepoint is rollback()ed.
`static byte`	`PROPERTY_SCOPE_SERVER` A property stored with this scope is transferred to the server, so you can do some things on the server with it.
`static byte`	`PROPERTY_SCOPE_TRANSACTION` A property stored with (only) this scope is present within this transaction object as long as the transaction lives, but not transmitted from client to server or vice versa.
`IndexedHashSet<BO>`	`purges` The BOs which were marked for removal (purging) from the database within this transaction; a subset of "bos".
`IndexedHashSet<BO>`	`refs` BOs that are somehow associated with this Transaction, either because they are included or are used as a parameter in a BOProc; a superset of "bos".
`java.lang.String`	`remarks`
`boolean`	`savePhase`
`static java.lang.String`	`SKIP_CLIENT_VERIFIES_FOR_ADMINS` If this property is set to Boolean.TRUE with scope `PROPERTY_SCOPE_COMMIT` or `PROPERTY_SCOPE_TRANSACTION`, verify on client and the before and after variants are skipped for admins.
`static java.lang.String`	`SKIP_RECALCS_FOR_DATA_REPAIR` If this property is set to Boolean.TRUE, the cancelRecalc method will return true suppressing all recalcs, depending on the property scope, either on client side or both client and server side.
`static java.lang.String`	`SKIP_SERVER_VERIFIES_FOR_ADMINS` If this property is set to Boolean.TRUE with scope `PROPERTY_SCOPE_SERVER`, verify on server and the before and after variants are skipped for admins.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`acquireReadLock()` Acquires the read lock for this Transaction.
`void`	`acquireWriteLock()` Acquires the write lock for this Transaction, thus synchronizing access to modifications to this Transaction.
`void`	`addFixingProc(BOProc bp)` Adds a BOProc to this Transaction that contains future local changes to fix data-inconsistencies during sync.
`void`	`addProc(BOProc bp)` Adds the given BOProc to the list of recorded changes by this transaction.
`void`	`addRemark(java.lang.String _str)` Convenience method that adds the given String to this Transactions "Remarks" string with a newline prepended (if "Remarks" wasn't null or empty before).
`java.lang.String`	`allLocalsToString()` Returns a String containing all keys and values of the current txLocals.
`java.lang.String`	`allProcsToString()` wrapper for `#procsToString(int, int, boolean, BO, boolean, int, boolen, boolean)` that automatically collects and prints all available procs and formats the output to be grouped
`java.lang.String`	`allProcsToString(boolean html)`
`java.lang.String`	`allProcsToString(boolean html, BO onlyThisBO)`
`java.lang.String`	`allProcsToString(boolean html, BO onlyThisBO, boolean canonize)`
`java.lang.String`	`allProcsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO)`
`java.lang.String`	`allProcsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, boolean skipBackProcs)`
`void`	`appendDescription(java.lang.String _desc)` Appends the given String to an already existing description of this Transaction or sets the description to the passed String, if none was set before.
`void`	`applyOtherTransactionsSaveSuccess(Transaction otx)` Iterates through the procs of the provided transaction and applies all modifications relevant to this transaction to the cached BOs.
`void`	`assertWriteLock()` Checks whether the current thread holds a writelock upon this transaction and throws an exception if not.
`BO`	`assureBotClass(BO bo)` Assures that the actual class of the given `BO` instance is consistent with (that is the same as) the class the `BOT` of the instance represents.
`TransactionCanonification`	`canonize(boolean modifyCurrent)` This calculates a canonification of this transaction.
`TransactionCanonification`	`canonize(boolean modifyCurrent, int from)`
`TransactionCanonification`	`canonize(boolean modifyCurrent, int from, int till)`
`void`	`checkIntegrity(boolean addRemarkForUndeletedNewBOsWithoutProcs)` Checks the integrity of this transaction in regard to its recorded BOs.
`void`	`checkpoint()`
`void`	`close()` Closes this Transaction.
`void`	`closeAndClearLazyData()` Closes this Transaction.
`void`	`commit()`
`void`	`commitBLOBs()`
`void`	`continueWithTempIdsFrom(Transaction _tx)` Sets the start of temp ids given by this transaction to the current temp id of the given Transaction; used to avoid overlapping of temp ids, FIXME!
`void`	`copyLocalsFrom(Transaction tx)`
`void`	`copyLocalsFrom(Transaction tx, boolean excludeCurrentUser)`
`void`	`copyLocalsFrom(Transaction tx, boolean excludeCurrentUser, boolean skipExisting)`
`java.util.Set`	`createOrTouchAdditional(java.util.Date transactionDate, Transaction.Additional addtx)` Memorizes `BOs` that were created in `addtx` in the "new" list of the `PersistenceHandlerI` and updates the `Lmod` of changed `BOs` from `addtx`.
`java.lang.String`	`currentSavepointToString()` Returns a String containing the name of the current savepoint or null if there is none.
`Transaction`	`deepClone(BOLoaderI bol, SchemaI schema)` Creates a new Transaction from this Transaction having all BOs reloaded with the passed BOLoaderI Also sets the passed schema as explicit schema, if it is not null, otherwise carries over the explicit schema of this Transaction to the new one, if any.
`Transaction`	`deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles)`
`Transaction`	`deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles, boolean preserveTxLocals)`
`Transaction`	`deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles, boolean preserveTxLocals, boolean preserveCurrentUser)`
`static Transaction`	`deserialize(SerializedTransaction stx, BOLoaderI bol, SchemaI schema, TemporaryIdSupplierI tempIdSupplier)`
`void`	`disableBORecalc()` Disables recalc of BO properties when calling set/add/remove This setting bypasses all recalculation of BO properties which might be necessary to do delicate data repairs without having the usual 'BO mechanics' in the way.
`void`	`disableClientVerification()` Disables client-side verification within this transaction for privileged users.
`void`	`disableServerVerification()` Disables server-side verification within this transaction for privileged users.
`void`	`disconnectBOs()` Deprecated.
`void`	`disconnectBOs(boolean clearLazyData)`
`void`	`drain()` Completely empties the current BOLoaderWithCacheI.
`void`	`dumpCache(org.apache.log4j.Logger l)`
`void`	`dumpProcs()`
`void`	`dumpProcs(java.util.ArrayList _procs)`
`void`	`dumpProcs(int _from, int _to)`
`void`	`dumpProcs(int _from, int _to, java.util.List _procs)`
`void`	`dumpProcs(org.apache.log4j.Logger l)` Dumps the procedures in a human-readable format to the specified logger.
`void`	`dumpProcs(org.apache.log4j.Logger _log, int _from, int _to)`
`void`	`dumpProcs(org.apache.log4j.Logger _log, int _from, int _to, java.util.List _procs)`
`void`	`dumpProcs(org.apache.log4j.Logger _log, int _from, int _to, java.util.List _procs, org.apache.log4j.Level _level)`
`void`	`dumpProcs(org.apache.log4j.Logger l, org.apache.log4j.Level _level)`
`void`	`dumpProcs(org.apache.log4j.Logger l, java.util.List _procs)`
`void`	`dumpProcs(org.apache.log4j.Logger l, java.util.List _procs, org.apache.log4j.Level _level)`
`void`	`enterSavePhase()`
`Transaction.Additional`	`evaluateVerifyOnServer(java.lang.Long nodeNumber, Benutzer user)` This may generate and return new BOProcs; will be called shortly before commit if no conflicts have occurred.
`Transaction.Additional`	`evaluateVerifyOnServer(java.lang.Long nodeNumber, Benutzer user, java.util.Set explicitTouchedBOs)`
`void`	`execute(BatchedBackendRequestI[] srs)`
`boolean`	`exists(java.lang.Long id)` Returns true if a BO with the passed Id and class exists in the cache of this Transaction or in the database, false if no such BO exists or the passed Id is null or negative.
`boolean`	`exists(java.lang.Long id, java.lang.Class<? extends BOI> classtip)` Returns true if a BO with the given id exists.
`BO`	`fillBO(BO bo, BO copyIntoBO)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)`
`BO`	`fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors, boolean recursiveCall)`
`Transaction.Additional`	`filterAdditionals(Transaction.Additional adds)`
`void`	`finalizeSaveProcedure(TransactionAnswer ta, SaveBOListenerI sbl)` Calls `#replayAdditionalProcs(Collection)` for replaying and incorporating "relevant" additional server-side changes (BOProcs) locally as well.
`void`	`finishBLOBs()`
`void`	`fireAfterSave(java.lang.Long nodeNumber, Benutzer user, SaveException se)` Called by `DBMan` after the save process finished, either successfully (`se = null`) or due to an "application level" error (`se <> null`).
`void`	`flagAsMassChange()` Marks this transaction as mass change.
`void`	`flagAsUserChoseToOverrideSaveVetoExceptions(java.lang.String message)` Marks this transaction as user chose to override (all) SaveVetoExceptions.
`void`	`flush()` Just like close, except that the cache remains intact and the transaction can continue.
`void`	`flushLocals()`
`BO`	`frapBO(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.
`BO`	`frapBOAndHandleNonPersistentAttributes(BO bo)` Fraps the passed BO and additionally sets any set npattr values in the BO to frap (or any BOs connected to it) which are not yet set in a possibly cached local copy, so server-side calculated npattr values are not lost but taken over into the BO from our cache.
`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.
`byte[]`	`getBLOB(java.lang.Long id)` get the BLOB belonging to BO[id].
`long`	`getBLOB(java.lang.Long id, java.io.DataOutput os)` Writes the BLOB belonging to BO[id] to the passed DataOutput.
`long`	`getBLOB(java.lang.Long id, java.io.DataOutput os, boolean closeOS)` Writes the BLOB belonging to BO[id] to the passed DataOutput.
`long`	`getBLOB(java.lang.Long id, java.io.DataOutput os, boolean closeOS, java.lang.Long backuppingBPId)` Writes the BLOB belonging to BO[id] to the passed DataOutput.
`byte[]`	`getBLOB(java.lang.Long id, java.lang.Long backuppingBPId)` get the BLOB belonging to BO[id].
`long`	`getBLOB(java.lang.Long id, java.io.OutputStream os)` Writes the BLOB belonging to BO[id] to the passed OutputStream.
`long`	`getBLOB(java.lang.Long id, java.io.OutputStream os, boolean closeOS)` Writes the BLOB belonging to BO[id] to the passed OutputStream.
`long`	`getBLOB(java.lang.Long id, java.io.OutputStream os, boolean closeOS, java.lang.Long backuppingBPId)` Writes the BLOB belonging to BO[id] to the passed OutputStream.
`VFile`	`getBLOBInfo(java.lang.Long id)` gathers information about the BLOB belonging to BO[i].
`VFile`	`getBLOBInfo(java.lang.Long id, java.lang.Long backuppingBPId)` gathers information about the BLOB belonging to BO[i].
`java.util.List<BOProc>`	`getBLOBProcs()` Checks the existing `BOProc`s of THIS if they are relevant to BLOB changes and if so put them in a `List`
`java.util.List<BOProc>`	`getBLOBProcs(BO bo)`
`java.lang.Long[]`	`getBLOBProcsBOIds()` Returns the Ids of all BOs that get their BLOB changed within this Transaction.
`java.lang.Long[]`	`getBLOBProcsBOIds(boolean skipNewBOs)`
`BO`	`getBO(BO bo)` Returns the passed Business Object (BO) in the context of this Transaction, if it is involved in the Transaction, otherwise it is returned as is.
`BO`	`getBO(java.lang.Long id)` Returns the Business Object (BO) with the passed Id and class in the context of this Transaction.
`BO`	`getBO(java.lang.Long id, java.lang.Class<? extends BOI> classtip)` Returns the BO with the given id.
`BO`	`getBO(java.lang.Long id, java.lang.Class<? extends BOI> classtip, boolean noFetch)`
`BO`	`getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s)` FIXME: nullIfNotFound: default 0, will signal Exception ignoreNotUnique: default 0 onlyKnown: default 0
`BO`	`getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound)`
`BO`	`getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound, boolean ignoreNotUnique)`
`BO`	`getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)`
`BO`	`getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s)` Calls getBOsByAttrs and does a uniqueness check by default.
`BO`	`getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound)`
`BO`	`getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound, boolean ignoreNotUnique)`
`BO`	`getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)`
`BO`	`getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s)` Deprecated.
`BO`	`getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound)`
`BO`	`getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound, boolean ignoreNotUnique)`
`BO`	`getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)`
`BO`	`getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s)` Deprecated.
`BO`	`getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound)`
`BO`	`getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound, boolean ignoreNotUnique)`
`BO`	`getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)`
`BOLoaderI`	`getBOLoader()`
`BO[]`	`getBOs()` Deprecated. @see #getIncludedBOs
`java.util.TreeMap<java.lang.Long,BO>`	`getBOs(java.lang.Class<? extends BOI> _classTip)` Method to retrieve all the included BOs with a specific class.
`BO[]`	`getBOs(long[] ids)` Wrapper method for the method getBOs( Object, Class ), such that we can call getBOs direct with an of array of Ids of the primitive type 'long'.
`BO[]`	`getBOs(java.lang.Long[] ids)` Wrapper method for the method getBOs( Object, Class ), such that we can call getBOs direct with an array of Ids of type Long.
`BO[]`	`getBOs(long[] ids, java.lang.Class<? extends BOI> classtip)` returns the BOs with the given ids.
`BO[]`	`getBOs(java.lang.Long[] ids, java.lang.Class<? extends BOI> classtip)` returns the BOs with the given ids.
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values)` Retrieves Business Objects (BOs) by the specified attributes within this transaction and persistent storage.
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue, int limit)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue, int limit, java.util.Set<java.lang.Long> excludeBOIds)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit, boolean[] nots)`
`java.util.List`	`getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit, boolean[] nots, java.util.Set<java.lang.Long> excludeBOIds)`
`BOT`	`getBOT(java.lang.Class<? extends BOI> clazz)`
`BO`	`getBOUncached(BO _bo)` Retrieves a Business Object (BO) without using the cache.
`BO`	`getBOUncached(java.lang.Long id)`
`BO`	`getBOUncached(java.lang.Long id, java.lang.Class<? extends BOI> classtip)` Loads and returns the BO with this Id with a non caching BOLoader.
`BT`	`getBT()`
`java.lang.Long`	`getBTId()`
`java.util.List<BOProc>`	`getCanonizedProcs()` Returns a list representing the procs after a `TransactionCanonification` of this Transaction.
`java.util.List<BOProc>`	`getCanonizedProcs(BO bo)` Filters the canonized BOProc-s of this Transaction to the ones affecting the passed BO and possibly the provided attribute.
`java.util.List<BOProc>`	`getCanonizedProcs(BO bo, java.util.Set<java.lang.String> attrs)` Filters the canonized BOProc-s of this Transaction to the ones affecting the passed BO and the provided attributes.
`java.util.List<BOProc>`	`getCanonizedProcs(BO bo, java.lang.String attributeName)`
`java.lang.Long`	`getClientSideId(BO bo)` Returns the client-side Id for the specified business object (BO).
`CryptoHandlerI`	`getCryptoHandler()` get a reference to the CryptoHandler used.
`Benutzer`	`getCurrentUser()` Returns the current user that controls this Transaction.
`int`	`getDeletedBOCount()` Returns the number of Business Objects (BOs) that are effectively marked as (soft) deleted within this transaction, taking into account any subsequent (soft) undeletions of a BO.
`int`	`getDeletedBOCount(int offset)` Returns the number of Business Objects (BOs) that are effectively marked as (soft) deleted within this transaction, taking into account any subsequent (soft) undeletions of a BO.
`java.lang.Long[]`	`getDeletedBOIds()`
`java.lang.Long[]`	`getDeletedBOIds(java.lang.Class<? extends BOI> _onlyForClass)`
`java.lang.Long[]`	`getDeletedBOIds(java.lang.Class<? extends BOI> _onlyForClass, boolean _newBOs)`
`java.util.List<java.util.Map>`	`getDepMaps(BO bo)`
`java.lang.String`	`getDescription()` Returns the currently set description of this Transaction.
`TransactionDumper`	`getDumper()`
`DBManEventProviderI`	`getEventProvider()` Returns the DBManEventProviderI of this BOLoader, if any.
`FeatureManagerI`	`getFeatureManager()`
`FileVaultI`	`getFileVault()`
`static byte`	`getFinalScope(byte scope)` Returns the passed scope in the version that marks the value as unmodifiable.
`static java.lang.String`	`getHumanReadablePropertyScope(byte scope)` Returns a human readable String describing the passed Transaction property scope.
`int`	`getIncludedBOCount()`
`java.lang.Long[]`	`getIncludedBOIds()`
`java.lang.Long[]`	`getIncludedBOIds(java.lang.Class<? extends BOI> _onlyForClass)`
`java.lang.Long[]`	`getIncludedBOIds(java.lang.Class<? extends BOI> _onlyForClass, boolean _newBOs)`
`BO[]`	`getIncludedBOs()`
`BO[]`	`getIncludedBOsFiltered()` Returns an array with all included BOs, but only of the passed class or subclasses of that.
`BO[]`	`getIncludedBOsFiltered(java.lang.Class<? extends BOI> onlyForClass)`
`BO[]`	`getIncludedBOsFiltered(java.lang.Class<? extends BOI> onlyForClass, boolean alsoNewBOs)`
`static Transaction`	`getInstance(BOLoaderI _loader)`
`static Transaction`	`getInstance(BOLoaderI _loader, SchemaI _schema)`
`static Transaction`	`getInstance(BOLoaderI _loader, SchemaI _schema, java.lang.String _desc)`
`static Transaction`	`getInstance(BOLoaderI _loader, SchemaI _schema, java.lang.String _desc, TemporaryIdSupplierI _temporaryIdSupplier)`
`static Transaction`	`getInstance(BOLoaderI _loader, java.lang.String _desc)`
`static Transaction`	`getInstance(BOLoaderI _loader, java.lang.String _desc, TemporaryIdSupplierI _temporaryIdSupplier)`
`java.util.Collection<BO>`	`getKnown(java.lang.Class<? extends BOI> clazz)`
`BO`	`getKnown(java.lang.Long id)` Returns the cached BO with this id.
`java.util.Map<java.lang.Long,BO>`	`getKnownBOs()` Returns an unmodifiable map with all known BOs.
`java.util.Map<java.lang.Long,BO>`	`getKnownBOs(java.lang.Class<? extends BOI> clazz)`
`java.util.Map<java.lang.Long,BO>`	`getKnownBOs(java.lang.Class<? extends BOI> clazz, int limit)`
`Transaction.Savepoint`	`getLatestSavepoint(java.lang.Object owner)` Get the latest valid (read:youngest) savepoint filed under the given owner
`long`	`getLocalLastModifiedBOs()`
`int`	`getLogLevel()`
`java.lang.String`	`getLogPrefixForProgress()`
`TransactionMessageBusI`	`getMessageBus()`
`java.lang.String`	`getMiniDesc(BO bo)`
`int`	`getNewBOCount()` Returns the number of new BOs created within this Transaction.
`BO[]`	`getNewBOs()`
`java.lang.Object`	`getNewValue(BO bo, java.lang.String attributeName)` Calculated the new value of the attribute att of the given BO bo.
`java.lang.Long`	`getNextId()` get a unique Long id from the backend.
`java.lang.Object`	`getOldValue(BO bo, java.lang.String attributeName)` Calculated the old value of the attribute att of the given BO bo.
`java.lang.Long`	`getOrigBTId()`
`java.lang.RuntimeException`	`getOrigin()`
`java.lang.Long`	`getOrigNode()`
`long`	`getOrigNodeNN()`
`java.util.Date`	`getOrigTime()`
`java.lang.Long`	`getOrigUser()`
`BOLoaderI`	`getParentLoader()` returns the BOLoader which this BOLoader uses to load its objects.
`PersistenceHandlerI`	`getPersistenceHandlerInSavePhase()`
`java.lang.Boolean`	`getPersistentBooleanProperty(EntityI namespaceEntity, java.lang.String name)`
`java.math.BigDecimal`	`getPersistentDecimalProperty(EntityI namespaceEntity, java.lang.String name)`
`java.lang.Long`	`getPersistentLongProperty(EntityI namespaceEntity, java.lang.String name)`
`static java.lang.String`	`getPersistentPropertyKey(EntityI namespaceEntity, java.lang.String name)`
`java.lang.String`	`getPersistentStringProperty(EntityI namespaceEntity, java.lang.String name)`
`int`	`getProcCount()` Gets the number of changes recorded in this transaction.
`BOProc[]`	`getProcs()`
`java.util.List<BOProc>`	`getProcs(BO bo)` Gets all recorded Procs for a bo and the provided attribute.
`java.util.List<BOProc>`	`getProcs(BO bo, java.lang.String attributeName)`
`java.lang.Object`	`getProperty(java.lang.String name)` Returns object represented by name or null, if no property with the passed name is found.
`TransactionProviderI`	`getProvider()`
`int`	`getPurgedBOCount()` Returns the number of Business Objects (BOs) purged from the database within this transaction.
`int`	`getPurgedBOCount(int offset)`
`BO[]`	`getRelationBOs(java.lang.Long id, java.lang.Class<? extends BOI> classtip, java.lang.String attName)` this method is used by the lazy loading map/list implementation to load related objects when needed.
`java.lang.String`	`getRemarks()` Returns a String containing all remarks that were set for this transaction.
`BOLoaderI`	`getRootLoader()` Returns the root BOLoader of this BOLoader or this if there is no more parent loader.
`javax.swing.JRootPane`	`getRootPaneToLockOnConnectionInterrupt()`
`Transaction.Savepoint[]`	`getSavepoints(java.lang.Object owner)` Get all valid savepoints filed under the given owner in a list, the latest snapshot at index 0.
`java.lang.Integer`	`getSavesCount()`
`int`	`getSavesCountNN()`
`SchemaI`	`getSchema()` Implements BOLoaderI#getSchema() by returning the schema of this transaction's BOLoaderI `getBOLoader()`
`java.lang.String`	`getSummary()` Prints a summary of this transaction (procs in a summarized, simplified form), e.g.
`TemporaryIdSupplierI`	`getTemporaryIdSupplier()`
`boolean`	`hasBLOB(java.lang.Long id)`
`boolean`	`hasBLOB(java.lang.Long id, java.lang.Long backuppingBPId)`
`boolean`	`hasBLOBProcs()`
`boolean`	`hasNewBOs()` Checks if new BOs have been created with this transaction.
`boolean`	`hasPersistentProperty(EntityI namespaceEntity, java.lang.String name)`
`boolean`	`hasProcs()` Checks if this holder has recorded any changes (procedures).
`boolean`	`hasProperty(java.lang.String key)` Returns true if a transaction property with the passed key exists.
`boolean`	`hasPurges()` Checks if BOs were marked for removal (purging) from the database within this transaction.
`boolean`	`hasSavepoint(java.lang.String name, java.lang.Object owner)` Returns true if there is an active savepoint with the given name and owner.
`boolean`	`hasSavepoints()`
`java.util.BitSet`	`haveBLOB(long[] ids)`
`BO`	`include(BO bo)`
`BO`	`include(BO bo, boolean forceNew)`
`BO`	`includeCopy(BO bo)` Copies attribute values and references from the given BO to a new BO.
`BO`	`includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts)`
`BO`	`includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)`
`BO`	`includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate)`
`BO`	`includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated)`
`BO`	`includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)`
`BO`	`includeCopy(BO bo, java.lang.String[] skipAtts)` Method to copy the attribute values from the given BO of the given Entity.
`BO`	`includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations)`
`BO`	`includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate)`
`BO`	`includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated)`
`BO`	`includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)`
`void`	`incorporateDiffOfConflictingBO(BO localBO, BO conflictingBO, SchemaI schema)` Incorporates into this Transactions the diff between the first passed (old) BO and the second passed (new and conflicting) BO, i.e. all necessary changes that are needed to transform `changedBO` into `conflictingBO`.
`void`	`increaseSavesCount()`
`void`	`initProcCache()` creates cache(s) for BOProcs for faster analysis
`void`	`initRemarks(java.lang.String _str)` Initializes the remarks to the given String.
`boolean`	`isActive()` Returns true if any proc(edure)s / changes were recorded in this transaction.
`boolean`	`isAlwaysReloadOnFrap()`
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames)` Checks if any attribute for a BO has been changed except a list of allowed ones.
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames, boolean evenIfValueUnchanged)`
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)`
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames)`
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames, boolean evenIfValueUnchanged)`
`boolean`	`isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)`
`boolean`	`isAttributeChanged(BO bo, java.lang.String attributeName)` Returns true if the given attribute of the given BO was changed in this transaction
`boolean`	`isAttributeChanged(BO bo, java.lang.String attributeName, boolean evenIfValueUnchanged)`
`boolean`	`isAttributeChanged(BO bo, java.lang.String attributeName, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)`
`boolean`	`isAttributeInitialized(BO bo, java.lang.String attributeName)` Returns true if the given attribute of the given BO was changed from null to a non-null value in this transaction.
`boolean`	`isAttributeNulled(BO bo, java.lang.String attributeName)` Returns true if the given attribute of the given BO was changed from a non-null value to null in this transaction.
`boolean`	`isBOOrAnyToOneReachableBOInvolved(BO bo)` Returns true/1 if the given BO or any via n-1 relations connected BO is involved in this transaction (means the passed or any such related BO has changed or it has been newly created).
`boolean`	`isBORecalcsDisabled()` Checks if the recalc of BO properties is disabled within this transaction and the current user may do so.
`boolean`	`isCaching()` If true, then this BOLoaderI uses an internal cache, holding all BOs hat were loaded or frapped into it.
`boolean`	`isClientVerificationDisabled()` Checks if client-side verification is disabled for this transaction and the current user has the privilege to bypass it.
`boolean`	`isClosed()`
`boolean`	`isClosing()`
`boolean`	`isCreated(BO bo)` Returns true/1 if the given BO was created in this transaction
`boolean`	`isDeletedOrNotInvolved(BO bo)` Returns true/1 if the given BO is not involved in this transaction or marked for deletion or is already deleted
`boolean`	`isDiffingMode()`
`boolean`	`isExplicitActive()`
`boolean`	`isForORMScript()` Returns true if this Transaction was marked as being used in the context of an ORM update script.
`boolean`	`isIgnoreBotCoherency()`
`boolean`	`isIncluded(BO bo)` Returns true/1 if the given BO is included in this transaction
`boolean`	`isInhibitDefaults()`
`boolean`	`isInitEnvironmentMode()`
`boolean`	`isInOTRMode()`
`boolean`	`isInstance(Transaction otx)` Returns true if the passed Transaction is the same instance as this Transaction.
`boolean`	`isInvolved(BO bo)` Returns true/1 if the given BO is involved in this transaction (means the BO has changed or it has been newly created).
`boolean`	`isKnown(BO bo)` Checks if a BO already exists within this transaction.
`boolean`	`isKnown(java.lang.Long id)` Checks if the transaction cache contains the provided id
`boolean`	`isLocked()`
`java.lang.Boolean`	`isLoggedIn(Benutzer _ben)` Tells if the given Benutzer is currently logged in.
`boolean`	`isLoggedInNN(Benutzer _ben)` Tells if the given Benutzer is currently logged in.
`boolean`	`isMassChange()` Returns true if this Transaction was marked as mass change.
`boolean`	`isNotPersistentParm(java.lang.Object o, java.lang.String attrName, java.lang.String attrUsage)` Checks if parameter o is a temporary BO that found its way into a transaction.
`boolean`	`isOnAuthoritativeSyncServer()` Tells if this transaction is handled on the authoritative sync server.
`boolean`	`isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames)` Returns true if at least one of the given attributes of the given BO were changed in this transaction
`boolean`	`isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames, boolean evenIfValueUnchanged)`
`boolean`	`isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)`
`static boolean`	`isPropertyFinal(byte scope)` Returns true if the passed property scope qualifies the property as `PROPERTY_IS_FINAL`.
`boolean`	`isPurged(BO bo)`
`boolean`	`isRecording()` Returns true if this BOLoaderI records changes.
`boolean`	`isRecordNonPersistent()`
`boolean`	`isRepairMode()`
`static boolean`	`isScopeCommit(byte scope)` Returns true if the passed property scope represents `PROPERTY_SCOPE_COMMIT`.
`static boolean`	`isScopePersistent(byte scope)` Returns true if the passed property scope represents `PROPERTY_SCOPE_PERSISTENT`.
`static boolean`	`isScopeSavepoint(byte scope)` Returns true if the passed property scope represents `PROPERTY_SCOPE_SAVEPOINT`.
`static boolean`	`isScopeServer(byte scope)` Returns true if the passed property scope represents `PROPERTY_SCOPE_SERVER`.
`static boolean`	`isScopeTransaction(byte scope)` Returns true if the passed property scope represents `PROPERTY_SCOPE_TRANSACTION`.
`static boolean`	`isScopeValid(byte scope)` Checks if the passed property scope is valid and signals an IllegalArgumentException if not.
`boolean`	`isServerVerificationDisabled()` Checks if server-side verification is disabled for this transaction and the current user has the privilege to bypass it.
`boolean`	`isSkipClientVerifiesForAdmins()` Deprecated. Use `isClientVerificationDisabled()` instead.
`boolean`	`isSkipServerVerifiesForAdmins()` Deprecated. Use `isServerVerificationDisabled()` instead.
`boolean`	`isSyncMode()` Represents a savepoint within a transaction, enabling selective rollback of changes.
`boolean`	`isUnderAdminControl()` Determines if this transaction is executed by an administrator user.
`boolean`	`isUnderBackendControl()` Determines if this transaction is executed by the backend.
`boolean`	`isUnderServiceControl()` Determines if this transaction is executed by a service user.
`boolean`	`isUnderSystemUserControl()` Determines if this transaction is executed by a system user.
`boolean`	`isUndo()` Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI).
`boolean`	`isUndoWithoutTimeTravel()` Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI) and a "time-travel" did not happen.
`boolean`	`isUndoWithTimeTravel()` Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI) and a "time-travel" did actually happen.
`boolean`	`isUserChoseToOverrideSaveVetoExceptions()` Returns true if this Transaction was marked as user chose to override (all) SaveVetoExceptions.
`static void`	`killNewProcsRunner()` This should only be called if a classloader is disposed of and we need to stop this class's NewProcsRunner!
`void`	`logDebug(java.lang.String _logmessage)` Adds the message to the remarks if the specified loglevel is equal/above Debug
`void`	`logError(java.lang.String _logmessage)` Adds the message to the remarks if the specified loglevel is equal/above Error
`void`	`logInfo(java.lang.String _logmessage)` Adds the message to the remarks if the specified loglevel is equal/above Info
`void`	`logWarn(java.lang.String _logmessage)` Adds the message to the remarks if the specified loglevel is equal/above Warn
`void`	`markForORMScript()` Marks this Transaction as being used in the context of an ORM update script, so some checks may react upon that and be less strict.
`void`	`markForSkipClientVerifiesForAdmins()` Deprecated. Use `disableClientVerification()` instead.
`void`	`markForSkipServerVerifiesForAdmins()` Deprecated. Use `disableServerVerification()` instead.
`void`	`mergeIn(Transaction otherTx)` Merges in another Transaction into this Transaction under certain circumstances and invalidates the merged in Transaction after that.
`void`	`mergeIn(Transaction otherTx, boolean appendOtherDescriptions)`
`void`	`mergeIn(Transaction otherTx, boolean appendOtherDescriptions, boolean addOtherRemarks)`
`java.lang.String`	`newBOsToString()` Converts the new BOs to a human-readable string representation.
`java.lang.String`	`newBOsToString(boolean html)` Converts the new BOs to a human-readable string representation.
`java.lang.String`	`newBOsToString(boolean html, int offset)` Converts the new BOs to a human-readable string representation.
`void`	`playReverse()`
`void`	`precommitBLOBs()`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)`
`Transaction.FillBOResult`	`prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors, boolean recursiveCall)`
`BatchedBackendRequestI`	`prepareQuery(java.lang.String s)`
`BatchedBackendRequestI`	`prepareQuery(java.lang.String s, java.lang.Object[] o)`
`void`	`prependBTs(BT[] bts)` Applies changes from the provided BTs to make them appear to happen before any direct change of this transaction.
`java.lang.String`	`procsToString()` Converts the procedures of this transaction to a human-readable string representation.
`java.lang.String`	`procsToString(boolean html)` Converts the procedures to a human-readable string representation.
`java.lang.String`	`procsToString(boolean html, BO onlyThisBO)` Converts the procedures affecting a specific BO to a human-readable string representation.
`java.lang.String`	`procsToString(boolean html, BO onlyThisBO, boolean canonize)`
`java.lang.String`	`procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO)`
`java.lang.String`	`procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, int maxProcs)`
`java.lang.String`	`procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, int maxProcs, boolean skipBackProcs)`
`java.lang.String`	`procsToString(boolean html, boolean skipBackProcs, BO onlyThisBO)` Converts the procedures affecting a specific BO to a human-readable string representation.
`java.lang.String`	`procsToString(int from, int till)` Converts the procedures of this transaction to a human-readable string representation.
`java.lang.String`	`procsToString(int from, int till, boolean html)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped, boolean canonize)`
`java.lang.String`	`procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped, boolean canonize, boolean skipBackProcs)`
`de.ipcon.db.core.QueryResultsI`	`query(BOQuery _eq)` query objects in an iterative way to hide backend processing time.
`de.ipcon.db.core.QueryResultsI`	`query(java.lang.String t)` wrapper for query(t, Object[0])
`de.ipcon.db.core.QueryResultsI`	`query(java.lang.String t, java.lang.Object[] pvals)` query objects in an iterative way to hide backend processing time.
`java.util.List`	`queryBO(BOQuery _eq)` query objects and block until all objects are transferred, returns Objects as a List.
`java.util.List`	`queryBO(BOQuery _eq, boolean includeKnownBOs)`
`java.util.List`	`queryBO(java.lang.String query)` wrapper for queryBO(String, Object[0])
`java.util.List`	`queryBO(java.lang.String query, java.lang.Object[] pvals)` query objects and block until all objects are transferred, returns Objects as a List.
`java.util.List`	`queryBO(java.lang.String query, java.lang.Object[] pvals, boolean includeKnownBOs)`
`de.ipcon.db.core.QueryResultsI`	`queryRelation(long id, java.lang.Class<? extends BOI> classtip, java.lang.String attributeName)` does the same as @see #getRelationBOs, but returns a QueryResultsI like @see #query.
`BO`	`readBOInstance(SecureObjectInputI s)`
`void`	`readInstance(SecureObjectInputI s, boolean stubClone)`
`void`	`readInstance(SecureObjectInputI s, boolean stubClone, boolean checkIntegrity)`
`void`	`readInstance(SecureObjectInputI s, boolean stubClone, boolean checkIntegrity, boolean forDeepClone)`
`BOProc`	`readProcInstance(SecureObjectInputI s, java.util.ArrayList<BO> boList, boolean stubClone, boolean forDeepClone)`
`boolean`	`recalcOfBOsShouldBeCanceled()` Returns true if this Transaction is in OTR mode, is in sync mode or is locked and thus any recalcs in BOs loaded by this Transaction should be canceled.
`void`	`recordAdd(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm)` Records the addition of a related object to a Business Object (BO) within this transaction.
`void`	`recordAdd(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm, BO oldParm)`
`void`	`recordPurge(BO bo)` Records a purge operation for the specified BO (Business Object) in this transaction.
`void`	`recordRemove(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm)` Records the removal of a related object from a Business Object (BO) within this transaction.
`void`	`recordSet(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object old, java.lang.Object $new)` Records the modification of an attribute's value in a Business Object (BO) within this transaction.
`BO`	`refBO(BO bo)`
`BO`	`refBO(BO bo, java.lang.String _whatMsg)`
`BO`	`refBO(BO bo, java.lang.String _whatMsg, BO debugBO)`
`BO`	`refBO(BO bo, java.lang.String _whatMsg, BO debugBO, java.lang.String debugAttr)`
`BO`	`refBO(BO bo, java.lang.String _whatMsg, BO debugBO, java.lang.String debugAttr, BOProc debugProc)`
`java.lang.Object`	`refParm(java.lang.Object o)`
`java.lang.Object`	`refParm(java.lang.Object o, java.lang.String what)`
`java.lang.Object`	`refParm(java.lang.Object o, java.lang.String what, BO debugBO)`
`java.lang.Object`	`refParm(java.lang.Object o, java.lang.String what, BO debugBO, java.lang.String debugAttr)`
`java.lang.Object`	`refParm(java.lang.Object o, java.lang.String what, BO debugBO, java.lang.String debugAttr, BOProc debugProc)`
`void`	`reFrapAfterSave(TransactionConflictReport report, boolean stubs)` Does maintenance to keep the internal object references in this Transaction intact after saving.
`void`	`rehashCache()`
`void`	`releaseReadLock()` Releases the read lock for this Transaction again.
`void`	`releaseWriteLock()` Releases the write lock for this Transaction again, thus allowing modifications by another thread.
`ManagedFileI`	`removeBLOB(BO bo)`
`void`	`replay()` Replays the `BOProcs` of this `Transaction`, applying the recorded changes again.
`void`	`replay(Transaction conflictingTX)`
`void`	`replayInStoreFinish(TransactionConflictReport report, boolean isChangeByBenutzer)`
`void`	`replayInStoreLog(TransactionConflictReport report, Benutzer user)`
`TransactionConflictReport`	`replayInStorePrepare(SchemaI schema, Benutzer user)` Prepares this transaction for storage by reloading all associated objects through the persistence handler.
`void`	`replayInStoreWithoutLog(TransactionConflictReport report, Benutzer user)`
`void`	`resetReversedMode()` internal use only
`void`	`restoreBLOBHandlesFrom(Transaction tx)`
`void`	`rollback()`
`void`	`rollbackBLOBs()`
`boolean`	`rollbackLatestSavepoint(java.lang.Object owner)` Roll back to the latest valid (read:youngest) savepoint filed under the given owner, if there is one, and return true.
`Transaction.Savepoint`	`savepoint(java.lang.String name)` Creates and returns a savepoint with the given name in this transaction.
`Transaction.Savepoint`	`savepoint(java.lang.String name, java.lang.Object owner)` Creates and returns a savepoint with the given name and owner in this transaction
`boolean`	`savepointBelongsHere(Transaction.Savepoint _sp)` Tells if the given Savepoint belongs to this Transaction.
`SerializedTransaction`	`serialize()`
`void`	`serverLocalTransactionStoreFinish(java.util.Date serverLocalTransactionDate, boolean isChangeByBenutzer, PersistenceHandlerI ph)`
`TransactionConflictReport`	`serverLocalTransactionStorePrepare(SchemaI schema)` Prepares this server-local transaction for storage, optimizing for the scenario where objects are already loaded server-side.
`void`	`setAlwaysReloadOnFrap(boolean $351)`
`void`	`setBOLoader(BOLoaderI l)`
`void`	`setBTId(java.lang.Long $347)`
`void`	`setCurrentUser(Benutzer ben)` Sets the current user that controls this Transaction.
`void`	`setDescription(java.lang.String _desc)` Sets the description (something like a commit message) of this Transaction.
`void`	`setDiffingMode(boolean $340)`
`void`	`setExplicitActive(boolean $353)`
`void`	`setIgnoreBotCoherency(boolean $349)`
`void`	`setInhibitDefaults(boolean $354)`
`void`	`setInitEnvironmentMode(boolean $341)`
`void`	`setLocalLastModifiedBOs(long $346)`
`void`	`setLogLevel(int $348)`
`void`	`setOrigBTId(java.lang.Long $343)`
`void`	`setOrigin(java.lang.RuntimeException $355)`
`void`	`setOrigNode(java.lang.Long $342)`
`void`	`setOrigTime(java.util.Date $345)`
`void`	`setOrigUser(java.lang.Long $344)`
`void`	`setPersistentBooleanProperty(EntityI namespaceEntity, java.lang.String name, java.lang.Boolean value)`
`void`	`setPersistentDecimalProperty(EntityI namespaceEntity, java.lang.String name, java.math.BigDecimal value)`
`void`	`setPersistentLongProperty(EntityI namespaceEntity, java.lang.String name, java.lang.Long value)`
`void`	`setPersistentStringProperty(EntityI namespaceEntity, java.lang.String name, java.lang.String value)`
`void`	`setProperty(java.lang.String name, java.lang.Object value, byte scope)` sets property value in current transaction context to specified value with the specified scope.
`void`	`setProperty(java.lang.String name, java.lang.Object value, byte scope, boolean isFinal)`
`void`	`setProvider(TransactionProviderI $352)`
`void`	`setRecordNonPersistent(boolean $350)`
`void`	`setRepairMode(boolean $339)`
`void`	`setRootPaneToLockOnConnectionInterrupt(javax.swing.JRootPane $357)`
`void`	`setSavesCount(java.lang.Integer $356)`
`void`	`setSyncMode(boolean $338)`
`void`	`setTemporaryIdSupplier(TemporaryIdSupplierI _temporaryIdSupplier)`
`long`	`simulateSave()`
`long`	`simulateSave(boolean doVerify)` Use ONLY in test environments.
`long`	`simulateSave(long sid)`
`long`	`simulateSave(long sid, boolean doVerify)`
`ManagedFileI`	`storeBLOB(BO bo, java.io.InputStream is)` Reads binary data from an InputStream and stores it as BLOB of the passed BO.
`Transaction`	`stubClone(BOLoaderI bol)`
`Transaction`	`stubClone(BOLoaderI bol, boolean doCanonize)`
`java.lang.Long`	`testAuth(Anmeldung a)` Tests wether given credentials can be verified.
`boolean`	`testAuth(de.ipcon.db.core.PasswortUeberpruefung a)` Tests wether given credentials can be verified.
`java.lang.String`	`toString()`
`java.lang.String`	`toString(boolean _showRuntimeInfo)`
`boolean`	`tryAcquireReadLock()`
`void`	`upgradeLocks()`
`boolean`	`wasBLOBChanged(BO bo)` Returns true/1 if the given BO had a BLOB-change in this transaction
`boolean`	`wasBLOBCreated(BO bo)` Returns true/1 if the given BO had a BLOB-creation in this transaction
`boolean`	`wasBLOBDeleted(BO bo)` Returns true/1 if the given BO had a BLOB-deletion in this transaction
`boolean`	`wasDeleted(BO bo)` Returns true/1 if the given BO was marked for deletion in this transaction
`boolean`	`weHaveReadLock()`
`void`	`writeBOInstance(SecureObjectOutputI s, BO bo)`
`void`	`writeInstanceToServer(SecureObjectOutputI s, java.lang.Thread savingThread)`
`void`	`writeInstanceWithoutBLOBTransfer(SecureObjectOutputI s)`
`void`	`writeProcInstance(SecureObjectOutputI s, java.util.HashMap<BO,java.lang.Integer> indexMap, BOProc proc, boolean stubClone, boolean forDeepClone)`

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, isTesting, 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

- Field Detail
  - LOG_LEVEL_DEBUG
```
public static final int LOG_LEVEL_DEBUG
```
    See Also:
    
    Constant Field Values
  - LOG_LEVEL_INFO
```
public static final int LOG_LEVEL_INFO
```
    See Also:
    
    Constant Field Values
  - LOG_LEVEL_WARN
```
public static final int LOG_LEVEL_WARN
```
    See Also:
    
    Constant Field Values
  - LOG_LEVEL_ERROR
```
public static final int LOG_LEVEL_ERROR
```
    See Also:
    
    Constant Field Values
  - LOG_LEVEL_DISABLE
```
public static final int LOG_LEVEL_DISABLE
```
    See Also:
    
    Constant Field Values
  - GET_ORIGNODE_DEFAULT_VALUE
```
public static final int GET_ORIGNODE_DEFAULT_VALUE
```
    See Also:
    
    Constant Field Values
  - PROPERTY_SCOPE_SAVEPOINT
```
public static final byte PROPERTY_SCOPE_SAVEPOINT
```
    A property stored with this scope is present in the current Savepoint and is removed once the Savepoint is rollback()ed.
    
    See Also:
    
    setProperty(String, Object, byte), Constant Field Values
  - PROPERTY_SCOPE_COMMIT
```
public static final byte PROPERTY_SCOPE_COMMIT
```
    A property stored with this scope is removed after commit.
    
    See Also:
    
    setProperty(String, Object, byte), Constant Field Values
  - PROPERTY_SCOPE_SERVER
```
public static final byte PROPERTY_SCOPE_SERVER
```
    A property stored with this scope is transferred to the server, so you can do some things on the server with it. A property using only this scope will be removed from the local Transaction after saving, unless its scope is combined with PROPERTY_SCOPE_TRANSACTION.
    
    See Also:
    
    setProperty(String, Object, byte), Constant Field Values
  - PROPERTY_SCOPE_TRANSACTION
```
public static final byte PROPERTY_SCOPE_TRANSACTION
```
    A property stored with (only) this scope is present within this transaction object as long as the transaction lives, but not transmitted from client to server or vice versa.
    
    See Also:
    
    setProperty(String, Object, byte), Constant Field Values
  - PROPERTY_SCOPE_PERSISTENT
```
public static final byte PROPERTY_SCOPE_PERSISTENT
```
    A property stored with this scope is transferred to the server and available there and additionally stored as a persistent property of the BT created from this TX.
    
    See Also:
    
    setProperty(String, Object, byte), Constant Field Values
  - SKIP_CLIENT_VERIFIES_FOR_ADMINS
```
public static final java.lang.String SKIP_CLIENT_VERIFIES_FOR_ADMINS
```
    If this property is set to Boolean.TRUE with scope PROPERTY_SCOPE_COMMIT or PROPERTY_SCOPE_TRANSACTION, verify on client and the before and after variants are skipped for admins.
    
    See Also:
    
    de.ipcon.gui.solstice.Client#saveBO(Transaction, boolean), Constant Field Values
  - SKIP_SERVER_VERIFIES_FOR_ADMINS
```
public static final java.lang.String SKIP_SERVER_VERIFIES_FOR_ADMINS
```
    If this property is set to Boolean.TRUE with scope PROPERTY_SCOPE_SERVER, verify on server and the before and after variants are skipped for admins.
    
    See Also:
    
    evaluateVerifyOnServer(Long, Benutzer, Set), Constant Field Values
  - SKIP_RECALCS_FOR_DATA_REPAIR
```
public static final java.lang.String SKIP_RECALCS_FOR_DATA_REPAIR
```
    If this property is set to Boolean.TRUE, the cancelRecalc method will return true suppressing all recalcs, depending on the property scope, either on client side or both client and server side. Please mind that the current user must be a member of the 'Admins Datenkorrektur' group.
    
    See Also:
    
    Constant Field Values
  - procs
```
public java.util.ArrayList<BOProc> procs
```
    The procedures to be executed when restoring to the server
  - newbos
```
public IndexedHashSet<BO> newbos
```
    The BOs which were newly created in this Transaction; a subset of "bos".
  - purges
```
public IndexedHashSet<BO> purges
```
    The BOs which were marked for removal (purging) from the database within this transaction; a subset of "bos".
  - bos
```
public IndexedHashSet<BO> bos
```
    The BOs which are included in the Transaction and for which modifications are recorded; a subset of "refs".
  - refs
```
public IndexedHashSet<BO> refs
```
    BOs that are somehow associated with this Transaction, either because they are included or are used as a parameter in a BOProc; a superset of "bos".
  - remarks
```
public java.lang.String remarks
```
  - description
```
public java.lang.String description
```
  - clientSaveLock
```
public transient java.lang.Integer clientSaveLock
```
    synchronize saves of this tx in the client / GUI
  - savePhase
```
public transient boolean savePhase
```
- Method Detail
  - killNewProcsRunner
```
public static void killNewProcsRunner()
```
    This should only be called if a classloader is disposed of and we need to stop this class's NewProcsRunner!
  - getHumanReadablePropertyScope
```
public static java.lang.String getHumanReadablePropertyScope(byte scope)
```
    Returns a human readable String describing the passed Transaction property scope.
  - isScopeValid
```
public static boolean isScopeValid(byte scope)
```
    Checks if the passed property scope is valid and signals an IllegalArgumentException if not.
  - isScopeCommit
```
public static boolean isScopeCommit(byte scope)
```
    Returns true if the passed property scope represents PROPERTY_SCOPE_COMMIT.
  - isScopeTransaction
```
public static boolean isScopeTransaction(byte scope)
```
    Returns true if the passed property scope represents PROPERTY_SCOPE_TRANSACTION.
  - isScopeServer
```
public static boolean isScopeServer(byte scope)
```
    Returns true if the passed property scope represents PROPERTY_SCOPE_SERVER.
  - isScopePersistent
```
public static boolean isScopePersistent(byte scope)
```
    Returns true if the passed property scope represents PROPERTY_SCOPE_PERSISTENT.
  - isScopeSavepoint
```
public static boolean isScopeSavepoint(byte scope)
```
    Returns true if the passed property scope represents PROPERTY_SCOPE_SAVEPOINT.
  - isPropertyFinal
```
public static boolean isPropertyFinal(byte scope)
```
    Returns true if the passed property scope qualifies the property as PROPERTY_IS_FINAL.
  - getFinalScope
```
public static byte getFinalScope(byte scope)
```
    Returns the passed scope in the version that marks the value as unmodifiable.
  - isInstance
```
public boolean isInstance(Transaction otx)
```
    Returns true if the passed Transaction is the same instance as this Transaction. Used as a Predicate for SaveBOListenerI.transactionSaveSuccess(de.ipcon.db.core.Transaction, java.util.function.Predicate<de.ipcon.db.core.Transaction>).
  - acquireReadLock
```
public void acquireReadLock()
```
    Acquires the read lock for this Transaction. More than one thread may acquire the read lock. This lock allows both readers and writers to reacquire read or write locks in the style of a ReentrantLock. Non-reentrant readers are not allowed until all write locks held by the writing thread have been released. Additionally, a writer can acquire the read lock, but not vice-versa. Upgrading from a read lock to the write lock is not possible. If a reader tries to acquire the write lock it will never succeed.
  - tryAcquireReadLock
```
public boolean tryAcquireReadLock()
```
  - weHaveReadLock
```
public boolean weHaveReadLock()
```
  - releaseReadLock
```
public void releaseReadLock()
```
    Releases the read lock for this Transaction again.
  - acquireWriteLock
```
public void acquireWriteLock()
```
    Acquires the write lock for this Transaction, thus synchronizing access to modifications to this Transaction. Downgrading from the write lock to a read lock is allowed and can be accomplished by acquiring the write lock, then the read lock and then releasing the write lock. However, upgrading from a read lock to the write lock is not possible.
  - releaseWriteLock
```
public void releaseWriteLock()
```
    Releases the write lock for this Transaction again, thus allowing modifications by another thread.
  - assertWriteLock
```
public void assertWriteLock()
```
    Checks whether the current thread holds a writelock upon this transaction and throws an exception if not.
    
    Throws:
    
    java.lang.IllegalStateException - if this thread doesn't hold a writelock upon this transaction
  - resetReversedMode
```
public void resetReversedMode()
```
    internal use only
  - setCurrentUser
```
public void setCurrentUser(Benutzer ben)
```
    Sets the current user that controls this Transaction. The user can only be set once and is final after that.
  - getCurrentUser
```
public final Benutzer getCurrentUser()
```
    Returns the current user that controls this Transaction.
  - continueWithTempIdsFrom
```
public void continueWithTempIdsFrom(Transaction _tx)
```
    Sets the start of temp ids given by this transaction to the current temp id of the given Transaction; used to avoid overlapping of temp ids, FIXME! but only works if _tx does not generate any new objects/assigns new temporary ids after this! Currently only used in saveBO of FormContextMenu.MultiFormSelection
  - isOnAuthoritativeSyncServer
```
public boolean isOnAuthoritativeSyncServer()
```
    Tells if this transaction is handled on the authoritative sync server.
  - recalcOfBOsShouldBeCanceled
```
public boolean recalcOfBOsShouldBeCanceled()
```
    Returns true if this Transaction is in OTR mode, is in sync mode or is locked and thus any recalcs in BOs loaded by this Transaction should be canceled.
  - isInOTRMode
```
public boolean isInOTRMode()
```
  - isLocked
```
public boolean isLocked()
```
  - isClosing
```
public boolean isClosing()
```
  - isClosed
```
public boolean isClosed()
```
  - isUndo
```
public boolean isUndo()
```
    Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI).
  - isUndoWithTimeTravel
```
public boolean isUndoWithTimeTravel()
```
    Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI) and a "time-travel" did actually happen.
  - isUndoWithoutTimeTravel
```
public boolean isUndoWithoutTimeTravel()
```
    Returns true if this Transaction was created in the context of an "undo" of a BT via BT#undo(TransactionProviderI, BOLoaderI) and a "time-travel" did not happen.
  - disableClientVerification
```
public void disableClientVerification()
```
    Disables client-side verification within this transaction for privileged users.
    This setting bypasses all client-side verification steps, including pre- and post-verification handling, for the following user roles:
    - Administrators
    - Backend processes (without a user)
    - KernelModule system users (such as the alarm or notification system)
    - Service users
    The disablement remains in effect for the entire duration of the transaction.
    
    Important:
    - Since version 1.1051 (2024-11-28), this method throws an IllegalStateException if the user does not have the necessary privileges to disable verifications, as determined by hasVerificationDisablingPrivileges(). This change prevents unnoticed errors that could occur in previous versions when this method was called without sufficient permissions.
    - Prior to version 1.1051, calling this method without the necessary privileges yielded neither an exception nor any effect. The verification flags (isClientVerificationDisabled() / isServerVerificationDisabled()) would remain false, and all verifications would be performed despite calling the disabling methods. This is because these methods also check for hasVerificationDisablingPrivileges() and return false if the user lacks the required permissions.
    Throws:
    
    java.lang.IllegalStateException - if the user does not have privileges to bypass verifications.
  - isClientVerificationDisabled
```
public boolean isClientVerificationDisabled()
```
    Checks if client-side verification is disabled for this transaction and the current user has the privilege to bypass it.
    
    Returns:
    
    true if client-side verification is disabled for the current user, false otherwise.
  - disableServerVerification
```
public void disableServerVerification()
```
    Disables server-side verification within this transaction for privileged users.
    This setting bypasses all server-side verification steps, including pre- and post-verification handling, for the following user roles:
    - Administrators
    - Backend processes (without a user)
    - KernelModule system users (such as the alarm or notification system)
    - Service users
    The disablement persists throughout the transaction's lifetime and across all server-side operations.
    
    Important:
    - Since version 1.1051 (2024-11-28), this method throws an IllegalStateException if the user does not have the necessary privileges to disable verifications, as determined by hasVerificationDisablingPrivileges(). This change prevents unnoticed errors that could occur in previous versions when this method was called without sufficient permissions.
    - Prior to version 1.1051, calling this method without the necessary privileges yielded neither an exception nor any effect. The verification flags (isClientVerificationDisabled() / isServerVerificationDisabled()) would remain false, and all verifications would be performed despite calling the disabling methods. This is because these methods also check for hasVerificationDisablingPrivileges() and return false if the user lacks the required permissions.
    Throws:
    
    java.lang.IllegalStateException - if the user does not have privileges to bypass verifications.
  - isServerVerificationDisabled
```
public boolean isServerVerificationDisabled()
```
    Checks if server-side verification is disabled for this transaction and the current user has the privilege to bypass it.
    
    Returns:
    
    true if server-side verification is disabled for the current user, false otherwise.
  - disableBORecalc
```
public void disableBORecalc()
```
    Disables recalc of BO properties when calling set/add/remove
    This setting bypasses all recalculation of BO properties which might be necessary to do delicate data repairs without having the usual 'BO mechanics' in the way.
    
    Please use with utmost caution because you might introduce states with BOs which render them unusable
    
    Doing so is only allowed for users of the 'Admins Datenkorrektur' group.
  - isBORecalcsDisabled
```
public boolean isBORecalcsDisabled()
```
    Checks if the recalc of BO properties is disabled within this transaction and the current user may do so.
  - markForSkipClientVerifiesForAdmins
```
@Deprecated
public void markForSkipClientVerifiesForAdmins()
```
    Deprecated. Use disableClientVerification() instead.
  - isSkipClientVerifiesForAdmins
```
@Deprecated
public boolean isSkipClientVerifiesForAdmins()
```
    Deprecated. Use isClientVerificationDisabled() instead.
  - markForSkipServerVerifiesForAdmins
```
@Deprecated
public void markForSkipServerVerifiesForAdmins()
```
    Deprecated. Use disableServerVerification() instead.
  - isSkipServerVerifiesForAdmins
```
@Deprecated
public boolean isSkipServerVerifiesForAdmins()
```
    Deprecated. Use isServerVerificationDisabled() instead.
  - markForORMScript
```
public void markForORMScript()
```
    Marks this Transaction as being used in the context of an ORM update script, so some checks may react upon that and be less strict.
  - isForORMScript
```
public boolean isForORMScript()
```
    Returns true if this Transaction was marked as being used in the context of an ORM update script.
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader)
```
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader,
                                      java.lang.String _desc)
```
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader,
                                      java.lang.String _desc,
                                      TemporaryIdSupplierI _temporaryIdSupplier)
```
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader,
                                      SchemaI _schema)
```
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader,
                                      SchemaI _schema,
                                      java.lang.String _desc)
```
  - getInstance
```
public static Transaction getInstance(BOLoaderI _loader,
                                      SchemaI _schema,
                                      java.lang.String _desc,
                                      TemporaryIdSupplierI _temporaryIdSupplier)
```
  - getTemporaryIdSupplier
```
public TemporaryIdSupplierI getTemporaryIdSupplier()
```
  - setTemporaryIdSupplier
```
public void setTemporaryIdSupplier(TemporaryIdSupplierI _temporaryIdSupplier)
```
  - setBOLoader
```
public void setBOLoader(BOLoaderI l)
```
  - getBOLoader
```
public BOLoaderI getBOLoader()
```
  - getPersistenceHandlerInSavePhase
```
public PersistenceHandlerI getPersistenceHandlerInSavePhase()
```
  - getFeatureManager
```
public FeatureManagerI getFeatureManager()
```
    Specified by:
    
    getFeatureManager in interface BOLoaderI
  - getSchema
```
public SchemaI getSchema()
```
    Implements BOLoaderI#getSchema() by returning the schema of this transaction's BOLoaderI getBOLoader()
    
    Specified by:
    
    getSchema in interface BOLoaderI
    
    Specified by:
    
    getSchema in interface SchemaProviderI
    
    Returns:
    
    the schema of this BOLoader instance.
  - getCryptoHandler
```
public CryptoHandlerI getCryptoHandler()
```
    Description copied from interface: BOLoaderI
    
    get a reference to the CryptoHandler used. On the server side, this will be a a ServerCryptoHandler, on the client side a ClientCryptoHandler. The main difference between these two is that the server side can calculate hashes, whereas the client side cannot.
    
    Specified by:
    
    getCryptoHandler in interface BOLoaderI
    
    Returns:
    
    the cryptohandler used by this BOLoader instance.
  - getFileVault
```
public FileVaultI getFileVault()
```
    Specified by:
    
    getFileVault in interface BOLoaderI
  - getBOT
```
public BOT getBOT(java.lang.Class<? extends BOI> clazz)
```
    Specified by:
    
    getBOT in interface BOLoaderI
  - getClientSideId
```
public java.lang.Long getClientSideId(BO bo)
```
    Returns the client-side Id for the specified business object (BO). If the BO has a temporary Id that was generated on the client-side and the save is still unfinished on the server, that temporary Id is returned. Otherwise, the "real" Id that was assigned to the BO by the server is returned.
    
    Parameters:
    
    bo - the business object to get the client-side Id for.
    
    Returns:
    
    the client-side Id for the specified BO, which might be a temporary negative Id or the server-assigned Id.
  - getBO
```
public BO getBO(BO bo)
```
    Returns the passed Business Object (BO) in the context of this Transaction, if it is involved in the Transaction, otherwise it is returned as is. If the passed BO is null or has no Id set yet, the passed BO is returned as is. If the passed BO is new (according to BO.isNew()), this method checks if it has a Transaction with the same TemporaryIdSupplier as this Transaction. If it does, the method looks up the BO in the cache of this Transaction (which might return a cloned instance if a ::mergeIn took place before). If it does not have a Transaction with the same TemporaryIdSupplier, the passed BO is returned as is. Otherwise, this method returns the result of calling getBO(Long, Class). Please note that this method shall always be preferred over getBO(Long, Class) if you already have a BO at hand, for the special checks this method does on new BOs, as explained above. It's important to note that this method always returns a freshly loaded instance if no BO with that Id has been encountered and thus not been cached before. In contrast, the method frapFromCache(BO) has a slightly different behaviour, as such BOs are deep-cloned and the copy is put into the cache, unless alwaysReloadOnFrap is set to true (which causes BOs to be reloaded through ph/castor, so that instance tracking of castor doesn't break when frapping on server-side).
    
    Parameters:
    
    bo - the BO to return in the context of this Transaction
    
    Returns:
    
    the passed BO in the context of this Transaction, if it is involved in the Transaction, otherwise it is returned as is
  - exists
```
public boolean exists(java.lang.Long id)
```
    Returns true if a BO with the passed Id and class exists in the cache of this Transaction or in the database, false if no such BO exists or the passed Id is null or negative.
    
    Specified by:
    
    exists in interface BOLoaderI
    
    Parameters:
    
    id - the Id of the BO to look for
    
    classtip - the class of the BO to look for (optional; defaults to BO.class)
    
    Returns:
    
    true if a BO with the passed Id and class exists in the cache of this Transaction or in the database, false if no such BO exists or the passed Id is null or negative.
    
    See Also:
    
    BOLoaderI.exists(Long, Class)
  - exists
```
public boolean exists(java.lang.Long id,
                      java.lang.Class<? extends BOI> classtip)
```
    Description copied from interface: BOLoaderI
    
    Returns true if a BO with the given id exists. The class tip is just what the name suggests, just a tip and will only have performance consequences if wrong or null.
    
    Specified by:
    
    exists in interface BOLoaderI
    
    Parameters:
    
    id - the id of the BO
    
    classtip - a guess which class the object has. May be null.
    
    Returns:
    
    true if a BO with the given id exists
  - getBO
```
public BO getBO(java.lang.Long id)
```
    Returns the Business Object (BO) with the passed Id and class in the context of this Transaction. If the cache of this Transaction contains an entry for the passed Id, the cached BO instance is returned. Otherwise the BO will be fetched by the loader of this Transaction and the resulting BO is then frapped via frapBO(BO) before it is returned, unless the parameter "noFetch" is passed as "true" - in that case, the loader is not asked, and null is returned for a cache-miss. This method should not be used if you already have a BO at hand, instead the getBO(BO) variant should be preferred, as that one avoids returning a wrong new BO from the cache, having has the same temporary Id as the passed Long that was possibly taken from that BO that shall be re-fetched via this method. It's important to note that this method always returns a freshly loaded instance if no BO with that Id has been encountered and thus not been cached before. In contrast, the method frapFromCache(BO) has a slightly different behaviour, as such BOs are deep-cloned and the copy is put into the cache, unless alwaysReloadOnFrap is set to true (which causes BOs to be reloaded through ph/castor, so that instance tracking of castor doesn't break when frapping on server-side).
    
    Specified by:
    
    getBO in interface BOLoaderI
    
    Parameters:
    
    id - the Id of the BO to look for
    
    classtip - the class of the BO to look for (optional; defaults to BO.class)
    
    noFetch - a boolean for configuring if on cache-miss the BO shall be loaded via the loader of this Transaction; if false is passed, null will be returned upon a cache-miss.
    
    Returns:
    
    the BO with the passed Id and class in the context of this Transaction, or null if no such BO exists and noFetch is true.
    
    See Also:
    
    BOLoaderI.getBO(Long, Class)
  - getBO
```
public BO getBO(java.lang.Long id,
                java.lang.Class<? extends BOI> classtip)
```
    Description copied from interface: BOLoaderI
    
    Returns the BO with the given id. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method with the same id will return the exact same object, which means getBO(id,...)==getBO(id,...). The class tip is just what the name suggests, just a tip and will only have performance consequences if a wrong or null value is passed. FIXME!! TT 2023-05-11: This method can probably return null in a few cases but I have no information what exactly these might be and it also depends on the actual implementing class. Also some implementations (DBMan for example) will throw ObjectNotPersistentException if no matching BO is found, while other implementations will not. Some classes - for example Mandant from crm-accounts module - will rely in ObjectNotPersistentException being thrown.
    
    Specified by:
    
    getBO in interface BOLoaderI
    
    Parameters:
    
    id - the id of the BO
    
    classtip - a guess which class the object has. May be null.
    
    Returns:
    
    BO with the given id.
  - getBO
```
public BO getBO(java.lang.Long id,
                java.lang.Class<? extends BOI> classtip,
                boolean noFetch)
```
  - getBOUncached
```
public BO getBOUncached(BO _bo)
```
    Retrieves a Business Object (BO) without using the cache.
    
    Parameters:
    
    _bo - The BO to retrieve.
    
    Returns:
    
    The retrieved BO, or null if the input is null.
  - getBOUncached
```
public BO getBOUncached(java.lang.Long id)
```
    Specified by:
    
    getBOUncached in interface BOLoaderI
  - getBOUncached
```
public BO getBOUncached(java.lang.Long id,
                        java.lang.Class<? extends BOI> classtip)
```
    Description copied from interface: BOLoaderI
    
    Loads and returns the BO with this Id with a non caching BOLoader. The BOLoader of the returned BO can (but doesn't have to) be different than the BOLoader this method was called on, e.g. BOLoaderI.isCaching() BOLoaderI instances.
    
    Specified by:
    
    getBOUncached in interface BOLoaderI
  - getBOs
```
public BO[] getBOs(java.lang.Long[] ids)
```
    Wrapper method for the method getBOs( Object, Class ), such that we can call getBOs direct with an array of Ids of type Long.
    
    Specified by:
    
    getBOs in interface BOLoaderI
    
    Parameters:
    
    ids - An array of ids, which are from the data type Long, for which we want to retrieve the specific BOs.
    
    classtip - The class of the BOs which we want to retrieve.
    
    Returns:
    
    Returns an array of BOs regarding the given Ids and class.
    
    See Also:
    
    BOLoaderI.getBOs(Long[],Class)
  - getBOs
```
public BO[] getBOs(java.lang.Long[] ids,
                   java.lang.Class<? extends BOI> classtip)
```
    Description copied from interface: BOLoaderI
    
    returns the BOs with the given ids. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method will return an array with the exact same objects. The class tip is common for all objects within this call and may be null.
    
    Specified by:
    
    getBOs in interface BOLoaderI
    
    Parameters:
    
    ids - array of Longs with ids for the requested BOs.
    
    classtip - guess for classes which the BOs belong to, may be null.
    
    Returns:
    
    BO[] with the requested BOs.
    
    See Also:
    
    Transaction
  - getBOs
```
public BO[] getBOs(long[] ids)
```
    Wrapper method for the method getBOs( Object, Class ), such that we can call getBOs direct with an of array of Ids of the primitive type 'long'.
    
    Specified by:
    
    getBOs in interface BOLoaderI
    
    Parameters:
    
    ids - An array of ids, which are from the primitive data type long, for which we want to retrieve the specific BOs.
    
    classtip - The class of the BOs which we want to retrieve.
    
    Returns:
    
    Returns an array of BOs regarding the given Ids and class.
    
    See Also:
    
    BOLoaderI.getBOs(long[],Class)
  - getBOs
```
public BO[] getBOs(long[] ids,
                   java.lang.Class<? extends BOI> classtip)
```
    Description copied from interface: BOLoaderI
    
    returns the BOs with the given ids. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method will return an array with the exact same objects. The class tip is common for all objects within this call and may be null.
    
    Specified by:
    
    getBOs in interface BOLoaderI
    
    Parameters:
    
    ids - array of longs with ids for the requested BOs.
    
    classtip - guess for classes which the BOs belong to, may be null.
    
    Returns:
    
    BO[] with the requested BOs.
    
    See Also:
    
    Transaction
  - getRelationBOs
```
public BO[] getRelationBOs(java.lang.Long id,
                           java.lang.Class<? extends BOI> classtip,
                           java.lang.String attName)
```
    Description copied from interface: BOLoaderI
    
    this method is used by the lazy loading map/list implementation to load related objects when needed. It's not thought for day to day use.
    
    Specified by:
    
    getRelationBOs in interface BOLoaderI
    
    Parameters:
    
    id - id of the BO which the requested BOs has a relation to
    
    classtip - common superclass of the requested bos
    
    attName - name of the relation from the BO to the requested ones
    
    Returns:
    
    bo[id].attributeName as array.
  - query
```
public de.ipcon.db.core.QueryResultsI query(java.lang.String t)
```
    Description copied from interface: BOLoaderI
    
    wrapper for query(t, Object[0])
    
    Specified by:
    
    query in interface BOLoaderI
    
    Specified by:
    
    query in interface BOQueryLoaderI
    
    See Also:
    
    BOLoaderI.query(String, Object[])
  - query
```
public de.ipcon.db.core.QueryResultsI query(java.lang.String t,
                                            java.lang.Object[] pvals)
```
    Description copied from interface: BOLoaderI
    
    query objects in an iterative way to hide backend processing time. The QueryResults interface "feels" like the standard iterator interface from the collections framework and it's thought to be used like this: This sample shows how to query bla BOs though this method do it = bol.query("bla from pack.bo bla where not Ldel limit 2") loop while it.hasNext() bo = BO it.getCurrentObject() -- hopefully this IS a BO, depends on the query. -- do whatever you have to do with the bo finally it.close() end The finally clause is very important to free up database and backend resources, so please don't forget this step!
    
    Specified by:
    
    query in interface BOLoaderI
    
    Specified by:
    
    query in interface BOQueryLoaderI
    
    Specified by:
    
    query in interface GrooqlBOLoaderI
    
    Parameters:
    
    t - the query to fetch, written in OQL
    
    pvals - an object array corresponding with $n entries, $1 is pvals[0] and so forth. Must not be null.
    
    Returns:
    
    QueryResults iterator through the query results.
  - query
```
public de.ipcon.db.core.QueryResultsI query(BOQuery _eq)
```
    Description copied from interface: BOLoaderI
    
    query objects in an iterative way to hide backend processing time.
    
    Specified by:
    
    query in interface BOLoaderI
    
    Parameters:
    
    _eq - the query to fetch, written in OQL
    
    Returns:
    
    QueryResults iterator through the query results.
  - queryRelation
```
public de.ipcon.db.core.QueryResultsI queryRelation(long id,
                                                    java.lang.Class<? extends BOI> classtip,
                                                    java.lang.String attributeName)
```
    Description copied from interface: BOLoaderI
    
    does the same as @see #getRelationBOs, but returns a QueryResultsI like @see #query.
    
    Specified by:
    
    queryRelation in interface BOLoaderI
  - queryBO
```
public java.util.List queryBO(java.lang.String query)
                       throws java.lang.IllegalArgumentException
```
    wrapper for queryBO(String, Object[0]) If a limit clause is given in the query, will return the first [limit] results in the requested order, if query includes an "order by" clause and [limit] results in undefined order but starting with the known BOs if "order by" is not given.
    
    Specified by:
    
    queryBO in interface BOLoaderI
    
    Specified by:
    
    queryBO in interface BOQueryLoaderI
    
    Parameters:
    
    query - the query to fetch, written in OQL
    
    pvals - an object array corresponding with $n entries, $1 is pvals[0] and so forth. Must not be null
    
    includeKnownBOs - flag that tells if new BOs not yet in the database but already known to the transaction should also be included in the result. Please note that if this flag is given the full set of OQL queries is not yet supported; an IllegalArgumentException will be thrown if an unsupported query is encountered
    
    Returns:
    
    List with the requested objects.
    
    Throws:
    
    java.lang.IllegalArgumentException - if includeKnownBOs is given as 1/true and an unsupported query is encountered
    
    See Also:
    
    BOLoaderI.queryBO(String, Object[])
  - queryBO
```
public java.util.List queryBO(java.lang.String query,
                              java.lang.Object[] pvals)
                       throws java.lang.IllegalArgumentException
```
    Description copied from interface: BOLoaderI
    
    query objects and block until all objects are transferred, returns Objects as a List. If at all possible, use query() instead of this, as it's a resource hogger and rather slow - except if you need a complete and rather small set of objects in this or an equivalent form and no further processing.
    
    Specified by:
    
    queryBO in interface BOLoaderI
    
    Specified by:
    
    queryBO in interface BOQueryLoaderI
    
    Specified by:
    
    queryBO in interface GrooqlBOLoaderI
    
    Parameters:
    
    query - the query to fetch, written in OQL
    
    pvals - an object array corresponding with $n entries, $1 is pvals[0] and so forth. Must not be null.
    
    Returns:
    
    List with the requested objects.
    
    Throws:
    
    java.lang.IllegalArgumentException
    
    See Also:
    
    BOLoaderI.query(String, Object[])
  - queryBO
```
public java.util.List queryBO(java.lang.String query,
                              java.lang.Object[] pvals,
                              boolean includeKnownBOs)
                       throws java.lang.IllegalArgumentException
```
    Throws:
    
    java.lang.IllegalArgumentException
  - queryBO
```
public java.util.List queryBO(BOQuery _eq)
```
    Description copied from interface: BOLoaderI
    
    query objects and block until all objects are transferred, returns Objects as a List.
    
    Specified by:
    
    queryBO in interface BOLoaderI
    
    Parameters:
    
    _eq - the query to fetch, written in OQL
    
    Returns:
    
    List with the requested objects.
  - queryBO
```
public java.util.List queryBO(BOQuery _eq,
                              boolean includeKnownBOs)
```
  - getBLOB
```
public byte[] getBLOB(java.lang.Long id)
```
    Description copied from interface: BLOBLoaderI
    
    get the BLOB belonging to BO[id]. Gives back a byte array of the BLOB.
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to.
    
    Returns:
    
    a byte array containing the data of the BLOB.
  - getBLOB
```
public byte[] getBLOB(java.lang.Long id,
                      java.lang.Long backuppingBPId)
```
    Description copied from interface: BLOBLoaderI
    
    get the BLOB belonging to BO[id]. Gives back a byte array of the BLOB.
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to.
    
    backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir
    
    Returns:
    
    a byte array containing the data of the BLOB.
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the OutputStream to write the BLOB-bytes to
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os,
                    boolean closeOS)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the OutputStream to write the BLOB-bytes to
    
    closeOS - a boolean designating if the OutputStream shall be closed afterwards or not.
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os,
                    boolean closeOS,
                    java.lang.Long backuppingBPId)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the OutputStream to write the BLOB-bytes to
    
    closeOS - a boolean designating if the OutputStream shall be closed afterwards or not.
    
    backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the DataOutput to write the BLOB-bytes to
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os,
                    boolean closeOS)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the DataOutput to write the BLOB-bytes to
    
    closeOS - a boolean designating if the DataOutput shall be closed afterwards or not.
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOB
```
public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os,
                    boolean closeOS,
                    java.lang.Long backuppingBPId)
```
    Description copied from interface: BLOBLoaderI
    
    Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput
    
    Specified by:
    
    getBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB belongs to
    
    os - the DataOutput to write the BLOB-bytes to
    
    closeOS - a boolean designating if the DataOutput shall be closed afterwards or not.
    
    backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir
    
    Returns:
    
    the written bytecount / length of BLOB
  - getBLOBInfo
```
public VFile getBLOBInfo(java.lang.Long id)
```
    Description copied from interface: BLOBLoaderI
    
    gathers information about the BLOB belonging to BO[i].
    
    Specified by:
    
    getBLOBInfo in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB-info belongs to.
    
    Returns:
    
    VFile object containing information about lastmodification and size.
  - getBLOBInfo
```
public VFile getBLOBInfo(java.lang.Long id,
                         java.lang.Long backuppingBPId)
```
    Description copied from interface: BLOBLoaderI
    
    gathers information about the BLOB belonging to BO[i].
    
    Specified by:
    
    getBLOBInfo in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the BLOB-info belongs to.
    
    backuppingBPId - instead of the current BLOB get the VFile for the backup-BLOB that was stored because of this BP-Id from the backup-dir
    
    Returns:
    
    VFile object containing information about lastmodification and size.
  - hasBLOB
```
public boolean hasBLOB(java.lang.Long id)
```
    Specified by:
    
    hasBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the check for existence of a BLOB on the server.
    
    Returns:
    
    true if a BLOB for the BO with the passed Id exists on the server.
  - hasBLOB
```
public boolean hasBLOB(java.lang.Long id,
                       java.lang.Long backuppingBPId)
```
    Specified by:
    
    hasBLOB in interface BLOBLoaderI
    
    Parameters:
    
    id - the id of the BO the check for existence of a BLOB on the server.
    
    backuppingBPId - instead of the current BLOB get the VFile for the backup-BLOB that was stored because of this BP-Id from the backup-dir
    
    Returns:
    
    true if a BLOB for the BO with the passed Id exists on the server.
  - haveBLOB
```
public java.util.BitSet haveBLOB(long[] ids)
```
    Specified by:
    
    haveBLOB in interface BLOBLoaderI
    
    Parameters:
    
    ids - an array of ids of BOs the check for existence of a BLOB on the server.
    
    Returns:
    
    a BitSet with the bit at the corresponding index set to true if a BLOB for the BO with the Id at that index of the passed array exists on the server, false if no BO or no BLOB for that BO exists on the server.
  - 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
    
    Returns:
    
    Long id which is guaranteed to be unique within the whole cluster.
  - testAuth
```
public java.lang.Long testAuth(Anmeldung a)
```
    Description copied from interface: BOLoaderI
    
    Tests wether given credentials can be verified. Returns long denoting the internal BO object in case the verification succeeded.
    
    Specified by:
    
    testAuth in interface BOLoaderI
    
    Returns:
    
    Long id of the Benutzer object in case the verification succeeded, null otherwise (aside a server-dependent lag).
  - testAuth
```
public boolean testAuth(de.ipcon.db.core.PasswortUeberpruefung a)
```
    Description copied from interface: BOLoaderI
    
    Tests wether given credentials can be verified. Returns true in case the verification succeeded.
    
    Specified by:
    
    testAuth in interface BOLoaderI
    
    Returns:
    
    true in case the verification succeeded, false otherwise.
  - prepareQuery
```
public BatchedBackendRequestI prepareQuery(java.lang.String s)
```
    Specified by:
    
    prepareQuery in interface BOLoaderI
  - prepareQuery
```
public BatchedBackendRequestI prepareQuery(java.lang.String s,
                                           java.lang.Object[] o)
```
    Specified by:
    
    prepareQuery in interface BOLoaderI
  - execute
```
public void execute(BatchedBackendRequestI[] srs)
```
    Specified by:
    
    execute in interface BOLoaderI
  - getParentLoader
```
public BOLoaderI getParentLoader()
```
    Description copied from interface: BOLoaderI
    
    returns the BOLoader which this BOLoader uses to load its objects. If this is a Root BOLoader, then null is returned.
    
    Specified by:
    
    getParentLoader in interface BOLoaderI
  - getRootLoader
```
public BOLoaderI getRootLoader()
```
    Description copied from interface: BOLoaderI
    
    Returns the root BOLoader of this BOLoader or this if there is no more parent loader.
    
    Specified by:
    
    getRootLoader in interface BOLoaderI
  - getEventProvider
```
public DBManEventProviderI getEventProvider()
```
    Description copied from interface: BOLoaderI
    
    Returns the DBManEventProviderI of this BOLoader, if any.
    
    Specified by:
    
    getEventProvider in interface BOLoaderI
  - frapFromCache
```
public 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. 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
    
    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).
  frapBO
  
  public BO frapBO(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. FIXME More explanations why frapping is necessary. The given BO instance itself will be put into the cache and be modified if there is not already a matching instance there. This reduces memory footprint and does not cost performance for the copying among other issues. This method should be used - instead of frapFromCache() - in cases where the Transaction gets BO instances that are not used by/shared with other code unrelated to the code that uses this transaction and that therefore can be directly put into the cache themselves because no modifications from "outside" will be done on them and no modification will affect anything "outside". FIXME! I think it may prove rather tricky sometimes to actually be sure that the above condition holds and thus frapBO() instead of frapFromCache() can be used. Simply changing the type of the BOLoader with which BOs that are later used in the Transaction from a "normal" to a caching one may produce the need to change this - but the two pieces of code may be totally unrelated and so nobody knows that the frap-call needs to be changed (already happened...).
  
  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 returns the given instance (after having put it in the cache).
  
  frapBOAndHandleNonPersistentAttributes
  
  public BO frapBOAndHandleNonPersistentAttributes(BO bo)
  
  Fraps the passed BO and additionally sets any set npattr values in the BO to frap (or any BOs connected to it) which are not yet set in a possibly cached local copy, so server-side calculated npattr values are not lost but taken over into the BO from our cache.
  
  getMiniDesc
  
  public java.lang.String getMiniDesc(BO bo)
  
  assureBotClass
  
  public BO assureBotClass(BO bo)
  
  Assures that the actual class of the given BO instance is consistent with (that is the same as) the class the BOT of the instance represents. Might need to reload the BO instance from the database to effectuate that.
  
  Parameters:
  
  bo - the BO whose class consistency should be checked
  
  Returns:
  
  an instance of the BO where the class of the instance is the same as the representing class of its BOT; may either be the instance passed in or a reloaded new instance from the database
  
  getOrigNodeNN
  
  public long getOrigNodeNN()
  
  getProcs
  
  public BOProc[] getProcs()
  
  Returns:
  
  a nonnull Array of all procs that are recorded in this transaction of size getProcCount()
  
  hasProcs
  
  public boolean hasProcs()
  
  Description copied from interface: BOProcHolderI
  
  Checks if this holder has recorded any changes (procedures).
  
  Specified by:
  
  hasProcs in interface BOProcHolderI
  
  Returns:
  
  true if at least one change has been recorded, false otherwise.
  
  getProcCount
  
  public int getProcCount()
  
  Gets the number of changes recorded in this transaction.
  
  Returns:
  
  the number of recorded changes.
  
  hasBLOBProcs
  
  public boolean hasBLOBProcs()
  
  Returns:
  
  true if this Transaction has any procs which modify a BLOB.
  
  hasNewBOs
  
  public boolean hasNewBOs()
  
  Checks if new BOs have been created with this transaction.
  
  Returns:
  
  true, if this transaction contains BOs that are new (i.e., have not been persisted yet), false otherwise.
  
  getNewBOs
  
  public BO[] getNewBOs()
  
  Returns:
  
  a nonnull Array containing all newly created BOs of size getNewBOCount().
  
  hasPurges
  
  public boolean hasPurges()
  
  Checks if BOs were marked for removal (purging) from the database within this transaction.
  
  Returns:
  
  true, if BOs were marked for removal (purging) from the database within this transaction, false otherwise.
  
  getNewBOCount
  
  public int getNewBOCount()
  
  Returns the number of new BOs created within this Transaction.
  
  Specified by:
  
  getNewBOCount in interface BOProcHolderI
  
  Returns:
  
  The number of new BOs.
  
  getPurgedBOCount
  
  public int getPurgedBOCount()
  
  Returns the number of Business Objects (BOs) purged from the database within this transaction.
  This count reflects the number of BOs permanently removed from the database as a result of this transaction's operations. It may be useful for tracking the impact of the transaction or for auditing purposes.
  
  Parameters:
  
  offset - An optional offset to apply to the procedures within this transaction when counting purged BOs.
  
  Returns:
  
  The number of purged BOs, potentially adjusted by the offset.
  
  getPurgedBOCount
  
  public int getPurgedBOCount(int offset)
  
  getDeletedBOCount
  
  public int getDeletedBOCount()
  
  Returns the number of Business Objects (BOs) that are effectively marked as (soft) deleted within this transaction, taking into account any subsequent (soft) undeletions of a BO.
  This count reflects the number of BOs effectively marked as (soft) deleted in the database as a result of this transaction's operations. It may be useful for tracking the impact of the transaction or for auditing purposes.
  
  Specified by:
  
  getDeletedBOCount in interface BOProcHolderI
  
  Returns:
  
  The number of deleted BOs.
  
  getDeletedBOCount
  
  public int getDeletedBOCount(int offset)
  
  Returns the number of Business Objects (BOs) that are effectively marked as (soft) deleted within this transaction, taking into account any subsequent (soft) undeletions of a BO.
  This count reflects the number of BOs effectively marked as (soft) deleted in the database as a result of this transaction's operations. It may be useful for tracking the impact of the transaction or for auditing purposes.
  
  Parameters:
  
  offset - An offset to apply to the procedures within this transaction when counting deleted BOs.
  
  Returns:
  
  The number of deleted BOs, potentially adjusted by the offset.
  
  getDeletedBOIds
  
  public java.lang.Long[] getDeletedBOIds()
  
  getDeletedBOIds
  
  public java.lang.Long[] getDeletedBOIds(java.lang.Class<? extends BOI> _onlyForClass)
  
  getDeletedBOIds
  
  public java.lang.Long[] getDeletedBOIds(java.lang.Class<? extends BOI> _onlyForClass, boolean _newBOs)
  
  getProcs
  
  public java.util.List<BOProc> getProcs(BO bo)
  
  Gets all recorded Procs for a bo and the provided attribute.
  
  Parameters:
  
  bo - the bo to get procs for.
  
  attributeName - the attribute of the bo that the returned procs should represent a change of; null means any change to the bo is relevant.
  
  Returns:
  
  a nonnull list of all recorded changes for (possibly a certain attribute) of the bo in this transaction
  
  getProcs
  
  public java.util.List<BOProc> getProcs(BO bo, java.lang.String attributeName)
  
  getBLOBProcs
  
  public java.util.List<BOProc> getBLOBProcs()
  
  Checks the existing BOProcs of THIS if they are relevant to BLOB changes and if so put them in a List
  
  Parameters:
  
  bo - the bo to get BLOB procs for (optional parameter).
  
  Returns:
  
  List A List containing BLOB changing BOProcs; List might be empty (but never NULL)
  
  getBLOBProcs
  
  public java.util.List<BOProc> getBLOBProcs(BO bo)
  
  getBLOBProcsBOIds
  
  public java.lang.Long[] getBLOBProcsBOIds()
  
  Returns the Ids of all BOs that get their BLOB changed within this Transaction.
  
  getBLOBProcsBOIds
  
  public java.lang.Long[] getBLOBProcsBOIds(boolean skipNewBOs)
  
  getBOs
  
  public BO[] getBOs()
  
  Deprecated. @see #getIncludedBOs
  
  getIncludedBOs
  
  public BO[] getIncludedBOs()
  
  getIncludedBOsFiltered
  
  public BO[] getIncludedBOsFiltered()
  
  Returns an array with all included BOs, but only of the passed class or subclasses of that. If parameter alsoNewBOs is passed as true, new BOs are also put to the array.
  
  getIncludedBOsFiltered
  
  public BO[] getIncludedBOsFiltered(java.lang.Class<? extends BOI> onlyForClass)
  
  getIncludedBOsFiltered
  
  public BO[] getIncludedBOsFiltered(java.lang.Class<? extends BOI> onlyForClass, boolean alsoNewBOs)
  
  getIncludedBOCount
  
  public int getIncludedBOCount()
  
  getIncludedBOIds
  
  public java.lang.Long[] getIncludedBOIds()
  
  getIncludedBOIds
  
  public java.lang.Long[] getIncludedBOIds(java.lang.Class<? extends BOI> _onlyForClass)
  
  getIncludedBOIds
  
  public java.lang.Long[] getIncludedBOIds(java.lang.Class<? extends BOI> _onlyForClass, boolean _newBOs)
  
  isKnown
  
  public boolean isKnown(java.lang.Long id)
  
  Checks if the transaction cache contains the provided id
  
  Specified by:
  
  isKnown in interface BOLoaderWithCacheI
  
  Parameters:
  
  id - the id of a bo which should be checked
  
  Returns:
  
  true, if this id exists in the transaction cache, false otherwise
  
  getKnown
  
  public BO getKnown(java.lang.Long id)
  
  Returns the cached BO with this id.
  
  Specified by:
  
  getKnown in interface BOLoaderWithCacheI
  
  Parameters:
  
  id - the id of the bo to lookup.
  
  Returns:
  
  the BO that is cached under this id (assert id == bo.getId()) or null, if no BO with this id is currently cached.
  
  isKnown
  
  public boolean isKnown(BO bo)
  
  Checks if a BO already exists within this transaction. BOs with a temporary id are checked against the set of newly created bos. Otherwise, the return value of isKnown( Long ) is returned. This method ignores any version a bo might have for not new BOs, e.g. ignores a stale cache in the transaction.
  
  Specified by:
  
  isKnown in interface BOLoaderWithCacheI
  
  Parameters:
  
  bo - the bo that should be checked against internal caches, nonnull
  
  Returns:
  
  true if the bo is new and in the tx cache for new BOs or it's id is known, false otherwise
  
  getKnown
  
  public java.util.Collection<BO> getKnown(java.lang.Class<? extends BOI> clazz)
  
  Specified by:
  
  getKnown in interface BOLoaderWithCacheI
  
  Returns:
  
  all known instances of clazz inside the cache. Might not be very performant
  
  getKnownBOs
  
  public java.util.Map<java.lang.Long,BO> getKnownBOs()
  
  Returns an unmodifiable map with all known BOs.
  
  Parameters:
  
  clazz - the Class to filter the known BOs to (optional)
  
  limit - the maximum number of filtered BOs of a certain class to return (non-negative, optional) FIXME? Including new BOs. FIXME 2023-02-21 ps: clazz=null -> deleted BOs are included, clazz<>null -> not included. Optimize getBOsByAttrs if this changes.
  
  getKnownBOs
  
  public java.util.Map<java.lang.Long,BO> getKnownBOs(java.lang.Class<? extends BOI> clazz)
  
  getKnownBOs
  
  public java.util.Map<java.lang.Long,BO> getKnownBOs(java.lang.Class<? extends BOI> clazz, int limit)
  
  getBOByStringAttrs
  
  @Deprecated public BO getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s)
  
  Deprecated.
  
  FIXME: nullIfNotFound: default 0, will signal Exception ignoreNotUnique: default 0 onlyKnown: default 0
  
  getBOByStringAttrs
  
  public BO getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound)
  
  getBOByStringAttrs
  
  public BO getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound, boolean ignoreNotUnique)
  
  getBOByStringAttrs
  
  public BO getBOByStringAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.String[] s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)
  
  getBOByAttrs
  
  public BO getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s)
  
  Calls getBOsByAttrs and does a uniqueness check by default.
  
  Specified by:
  
  getBOByAttrs in interface BOQueryLoaderI
  
  Parameters:
  
  class - the clazz of the BO to get
  
  attributeNames - a list of attribute names to check, nonnull.
  
  s - a list of attribute values to check, paired by index with attrs-list, nonnull.
  
  nullIfNotFound - if false (default), then an ObjectForCoditionNotFoundException is thrown if no BO matches the provided filter. If true, then this method simply returns null in this case.
  
  ignoreNotUnique - if false (default), then an ObjectForConditionNotUniqueException is thrown if two or more objects match the provided filter. Otherwise, any one of these objects are returned. This method makes no guarantees to return the same object on successive calls in this case.
  
  onlyKnown - if false (default), then this method might execute a query to load objects, if true, then only BOs of this transaction are considered. Note: This setting might hide a duplicate BO located in the database.
  
  Returns:
  
  a BO matching the provided filters. Only nullable if nullIfNotFound was set to true. A returned BO is guaranteed to be unique, unless ignoreNotUnique or onlyKnown is set to true.
  
  getBOByAttrs
  
  public BO getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound)
  
  Specified by:
  
  getBOByAttrs in interface BOQueryLoaderI
  
  getBOByAttrs
  
  public BO getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound, boolean ignoreNotUnique)
  
  Specified by:
  
  getBOByAttrs in interface BOQueryLoaderI
  
  getBOByAttrs
  
  public BO getBOByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)
  
  getBOByStringAttr
  
  @Deprecated public BO getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s)
  
  Deprecated.
  
  getBOByStringAttr
  
  public BO getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound)
  
  getBOByStringAttr
  
  public BO getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound, boolean ignoreNotUnique)
  
  getBOByStringAttr
  
  public BO getBOByStringAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.String s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)
  
  getBOByAttr
  
  public BO getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s)
  
  FIXME: nullIfNotFound: default 0, will signal Exception ignoreNotUnique: default 0 onlyKnown: default 0
  
  Specified by:
  
  getBOByAttr in interface BOQueryLoaderI
  
  See Also:
  
  BOQueryLoaderI.getBOByAttrs(java.lang.Class, java.lang.String[], java.lang.Object[], boolean, boolean)
  
  getBOByAttr
  
  public BO getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound)
  
  Specified by:
  
  getBOByAttr in interface BOQueryLoaderI
  
  getBOByAttr
  
  public BO getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound, boolean ignoreNotUnique)
  
  Specified by:
  
  getBOByAttr in interface BOQueryLoaderI
  
  getBOByAttr
  
  public BO getBOByAttr(java.lang.Class<? extends BOI> clazz, java.lang.String attributeName, java.lang.Object s, boolean nullIfNotFound, boolean ignoreNotUnique, boolean onlyKnown)
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue)
  
  Specified by:
  
  getBOsByAttrs in interface BOQueryLoaderI
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue, int limit)
  
  Specified by:
  
  getBOsByAttrs in interface BOQueryLoaderI
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValue, int limit, java.util.Set<java.lang.Long> excludeBOIds)
  
  Specified by:
  
  getBOsByAttrs in interface BOQueryLoaderI
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values)
  
  Retrieves Business Objects (BOs) by the specified attributes within this transaction and persistent storage. The returned BOs are in an undefined order. If the limit parameter is set to a value greater than 0, the returned values represent an unspecified subset of all matching BOs present in the transaction and the database. Attribute chains, such as 'Elter.Elter', are allowed. If an attribute chain cannot be completely resolved due to null values and the 'nots' parameter is set to 'true' for this index, the attribute match is ignored for this transaction. If the limit is greater than 0, subsequent calls to this method with identical parameters may return a different set of values each time. Note: Using null as a value differs from using 'null' as a String.
  
  Specified by:
  
  getBOsByAttrs in interface BOQueryLoaderI
  
  Parameters:
  
  clazz - The class of the desired BO.
  
  attributeNames - An array of attribute names to filter by.
  
  values - An array of attribute values to compare against. The values should correspond to the attributes specified in the 'attrs' parameter.
  
  onlyKnown - If set to true, limits the lookup to this transaction and does not query for additional BOs. (Default: false. When using testBOLoader, it is always true)
  
  limit - The maximum number of matching BOs to be returned. Use '0' for unlimited. (Default: unlimited)
  
  nots - An array of booleans indicating whether the corresponding attribute-value check should be inverted. If set to true for a given index, it means that the attribute should be unequal to the given value. (Default: null)
  
  excludeBOIds - a nullable Set of Ids to exclude from the results. More efficient that multiple '!Id' entries. Mostly exists here for compability to the Interface variant of this method, to exclude possibly 'outdated' BOs from lower sources.
  
  Returns:
  
  A non-null list of matching BOs of type 'clazz'.
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown)
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit)
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit, boolean[] nots)
  
  getBOsByAttrs
  
  public java.util.List getBOsByAttrs(java.lang.Class<? extends BOI> clazz, java.lang.String[] attributeNames, java.lang.Object[] values, boolean onlyKnown, int limit, boolean[] nots, java.util.Set<java.lang.Long> excludeBOIds)
  
  initProcCache
  
  public void initProcCache()
  
  creates cache(s) for BOProcs for faster analysis
  
  isCreated
  
  public boolean isCreated(BO bo)
  
  Returns true/1 if the given BO was created in this transaction
  
  isPurged
  
  public boolean isPurged(BO bo)
  
  Returns:
  
  true if the given BO was marked for removal (purging) from the database within this transaction.
  
  isIncluded
  
  public boolean isIncluded(BO bo)
  
  Returns true/1 if the given BO is included in this transaction
  
  isInvolved
  
  public boolean isInvolved(BO bo)
  
  Returns true/1 if the given BO is involved in this transaction (means the BO has changed or it has been newly created).
  
  Parameters:
  
  bo - the BO to check
  
  Returns:
  
  true if the given BO is involved in this transaction.
  
  isBOOrAnyToOneReachableBOInvolved
  
  public boolean isBOOrAnyToOneReachableBOInvolved(BO bo)
  
  Returns true/1 if the given BO or any via n-1 relations connected BO is involved in this transaction (means the passed or any such related BO has changed or it has been newly created).
  
  Parameters:
  
  bo - the BO to check
  
  Returns:
  
  true if the given BO or any of the via single relations reachable BOs is involved in this transaction.
  
  isDeletedOrNotInvolved
  
  public boolean isDeletedOrNotInvolved(BO bo)
  
  Returns true/1 if the given BO is not involved in this transaction or marked for deletion or is already deleted
  
  wasDeleted
  
  public boolean wasDeleted(BO bo)
  
  Returns true/1 if the given BO was marked for deletion in this transaction
  
  wasBLOBChanged
  
  public boolean wasBLOBChanged(BO bo)
  
  Returns true/1 if the given BO had a BLOB-change in this transaction
  
  wasBLOBCreated
  
  public boolean wasBLOBCreated(BO bo)
  
  Returns true/1 if the given BO had a BLOB-creation in this transaction
  
  wasBLOBDeleted
  
  public boolean wasBLOBDeleted(BO bo)
  
  Returns true/1 if the given BO had a BLOB-deletion in this transaction
  
  isUnderAdminControl
  
  public final boolean isUnderAdminControl()
  
  Determines if this transaction is executed by an administrator user.
  
  Returns:
  
  true if a user is associated with this transaction and she has administrator privileges, false otherwise.
  
  See Also:
  
  BenutzerGroupAspects.isAdministratorUser()
  
  isUnderBackendControl
  
  public final boolean isUnderBackendControl()
  
  Determines if this transaction is executed by the backend.
  A transaction is considered under backend control if it does not have a current user associated with it.
  
  Returns:
  
  true if the transaction is under backend control (i.e., has no user associated with it), false otherwise.
  
  isUnderSystemUserControl
  
  public final boolean isUnderSystemUserControl()
  
  Determines if this transaction is executed by a system user.
  Checks if the current user associated with the transaction is a KernelModule system user, such as the alarm or notification system.
  
  Returns:
  
  true if a user is associated with this transaction and she is a system user, false otherwise.
  
  See Also:
  
  BenutzerGroupAspects.isSystemUser(), Benutzer.SYSTEM_USER_NAMES
  
  isUnderServiceControl
  
  public final boolean isUnderServiceControl()
  
  Determines if this transaction is executed by a service user.
  
  Returns:
  
  true if a user is associated with this transaction and she is a service user, false otherwise.
  
  See Also:
  
  BenutzerGroupAspects.isServiceUser(), Gruppe.RG_Services
  
  isAttributeInitialized
  
  public boolean isAttributeInitialized(BO bo, java.lang.String attributeName)
  
  Returns true if the given attribute of the given BO was changed from null to a non-null value in this transaction.
  
  Parameters:
  
  bo - the Object on which the change shall be detected
  
  attributeName - the attribute that shall be tested for changes
  
  Returns:
  
  true if the given attribute of the given BO was changed from null to a non-null value in this transaction
  
  isAttributeNulled
  
  public boolean isAttributeNulled(BO bo, java.lang.String attributeName)
  
  Returns true if the given attribute of the given BO was changed from a non-null value to null in this transaction.
  
  Parameters:
  
  bo - the Object on which the change shall be detected
  
  attributeName - the attribute that shall be tested for changes
  
  Returns:
  
  true if the given attribute of the given BO was changed from a non-null value to null in this transaction
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames)
  
  See Also:
  
  Convenience method to allow usage of a nonnull String Array for the names of excluded attributes to allow a more similar usage compared to similar methods.
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames, boolean evenIfValueUnchanged)
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.lang.String[] excludeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames)
  
  Checks if any attribute for a BO has been changed except a list of allowed ones. Please prefer isInvolved( BO ) to check against any changes. Creates a list of the Attrs that exist on this bo that should be checked, excluding the names from the parameter, and checks for changes via isOneOfAttributesChanged(BO, String[], boolean, boolean) because this allows usage of the proccache and result in faster evaluation for large transactions.
  
  Parameters:
  
  bo - the Object on which changes shall be detected
  
  excludeNames - a nonnull Set with all attribute names that are excempt from this test.
  
  ignoreBooleanTriState - whether changes from false to null or null to false in boolean attributes shall be ignored, defaults to no
  
  evenIfValueUnchanged - whether changes which do not actually change the original value of the attribute shall be reported as changes, defaults to no
  
  Returns:
  
  true if at least one attribute not in excludeNames was changed in this transaction for exacly this bo.
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames, boolean evenIfValueUnchanged)
  
  isAnyAttributeChangedExcept
  
  public boolean isAnyAttributeChangedExcept(BO bo, java.util.Set<java.lang.String> excludeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)
  
  isAttributeChanged
  
  public boolean isAttributeChanged(BO bo, java.lang.String attributeName)
  
  Returns true if the given attribute of the given BO was changed in this transaction
  
  Parameters:
  
  bo - the Object on which the change shall be detected
  
  attributeName - the attribute that shall be tested for changes
  
  ignoreBooleanTriState - whether changes from false to null or null to false in boolean attributes shall be ignored, defaults to no
  
  evenIfValueUnchanged - whether changes which do not actually change the original value of the attribute shall be reported as changes, defaults to no
  
  Returns:
  
  true if the given attribute of the given BO was changed in this transaction
  
  isAttributeChanged
  
  public boolean isAttributeChanged(BO bo, java.lang.String attributeName, boolean evenIfValueUnchanged)
  
  isAttributeChanged
  
  public boolean isAttributeChanged(BO bo, java.lang.String attributeName, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)
  
  isOneOfAttributesChanged
  
  public boolean isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames)
  
  Returns true if at least one of the given attributes of the given BO were changed in this transaction
  
  Parameters:
  
  bo - the Object on which the change shall be detected
  
  attributeNames - a String-array with all attribute that shall be tested for changes
  
  ignoreBooleanTriState - whether changes from false to null or null to false in boolean attributes shall be ignored, defaults to no
  
  evenIfValueUnchanged - whether changes which do not actually change the original value of the attribute shall be reported as changes, defaults to no
  
  Returns:
  
  true if at least one of the given attributes of the given BO were changed in this transaction
  
  isOneOfAttributesChanged
  
  public boolean isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames, boolean evenIfValueUnchanged)
  
  isOneOfAttributesChanged
  
  public boolean isOneOfAttributesChanged(BO bo, java.lang.String[] attributeNames, boolean evenIfValueUnchanged, boolean ignoreBooleanTriState)
  
  getOldValue
  
  public java.lang.Object getOldValue(BO bo, java.lang.String attributeName)
  
  Calculated the old value of the attribute att of the given BO bo. If there was no change of this attribute during this transaction, the value from the object self is given back.
  
  getNewValue
  
  public java.lang.Object getNewValue(BO bo, java.lang.String attributeName)
  
  Calculated the new value of the attribute att of the given BO bo. If there was no change of this attribute during this transaction, the value from the object self is given back.
  
  getMessageBus
  
  public TransactionMessageBusI getMessageBus()
  
  Returns:
  
  the MessageBus to use for changes related to this transaction
  
  addProc
  
  public void addProc(BOProc bp)
  
  Adds the given BOProc to the list of recorded changes by this transaction. Referenced BOs are automatically frapped and stubs loaded. The recording needs references (refs) and BOProc recording
  
  addFixingProc
  
  public void addFixingProc(BOProc bp)
  
  Adds a BOProc to this Transaction that contains future local changes to fix data-inconsistencies during sync. Also adjusts the Lmod of the affected BO, so it is not dated back to the Lmod of the synced in BO containing outdated data.
  
  refBO
  
  public BO refBO(BO bo)
  
  refBO
  
  public BO refBO(BO bo, java.lang.String _whatMsg)
  
  refBO
  
  public BO refBO(BO bo, java.lang.String _whatMsg, BO debugBO)
  
  refBO
  
  public BO refBO(BO bo, java.lang.String _whatMsg, BO debugBO, java.lang.String debugAttr)
  
  refBO
  
  public BO refBO(BO bo, java.lang.String _whatMsg, BO debugBO, java.lang.String debugAttr, BOProc debugProc)
  
  refParm
  
  public java.lang.Object refParm(java.lang.Object o)
  
  refParm
  
  public java.lang.Object refParm(java.lang.Object o, java.lang.String what)
  
  refParm
  
  public java.lang.Object refParm(java.lang.Object o, java.lang.String what, BO debugBO)
  
  refParm
  
  public java.lang.Object refParm(java.lang.Object o, java.lang.String what, BO debugBO, java.lang.String debugAttr)
  
  refParm
  
  public java.lang.Object refParm(java.lang.Object o, java.lang.String what, BO debugBO, java.lang.String debugAttr, BOProc debugProc)
  
  isNotPersistentParm
  
  public boolean isNotPersistentParm(java.lang.Object o, java.lang.String attrName, java.lang.String attrUsage)
  
  Checks if parameter o is a temporary BO that found its way into a transaction. Returns false if o is either a scalar, not new or it is new but also known. Returns true if o is a new BO (temporary Id) that is not known in this tx. Also outputs a warning in the true case, as adding temporary objects to the backrelation - where they can live on - leads to serious memory leaks. True is most of the time returned, because a temporary BO has been created and at least one of its relation-attributes is set to an included object, which in return tries to add the temp-object to its back relation. Added 2005-11-11 in commit 1.118.2.10
  
  recordSet
  
  public void recordSet(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object old, java.lang.Object $new)
  
  Records the modification of an attribute's value in a Business Object (BO) within this transaction.
  This method tracks the change of an attribute's value within a BO during the transaction. It ensures the validity of the operation and maintains references to the affected BO. An `IllegalStateException` is thrown if the transaction is locked or if the BO is not part of the transaction (except in `diffingMode`).
  
  Parameters:
  
  bo - The BO whose attribute is being modified.
  
  attributeName - The name of the attribute being modified.
  
  ptyp - The class of the new attribute value.
  
  old - The original value of the attribute.
  
  newValue - The new value being assigned to the attribute.
  
  Throws:
  
  java.lang.IllegalStateException - If the transaction is locked or the BO is not included in the transaction (in non-diffing mode).
  
  recordAdd
  
  public void recordAdd(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm)
  
  Records the addition of a related object to a Business Object (BO) within this transaction.
  This method registers the association of a new related object with a BO during the transaction. It validates the operation and maintains references to the involved BOs. An `IllegalStateException` is thrown if the transaction is locked or if the BO is not part of the transaction (except in `diffingMode`).
  
  Parameters:
  
  bo - The BO to which the related object is being added.
  
  attributeName - The name of the attribute representing the relationship.
  
  ptyp - The class of the added related object.
  
  parm - The value of the added related object.
  
  oldParm - The previous value of the attribute (an optional BO).
  
  Throws:
  
  java.lang.IllegalStateException - If the transaction is locked or the BO is not included in the transaction (in non-diffing mode).
  
  recordAdd
  
  public void recordAdd(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm, BO oldParm)
  
  recordRemove
  
  public void recordRemove(BO bo, java.lang.String attributeName, java.lang.Class ptyp, java.lang.Object parm)
  
  Records the removal of a related object from a Business Object (BO) within this transaction.
  This method tracks the disassociation of a related object from a BO during the transaction. It ensures the validity of the operation and maintains references to the affected BOs. An `IllegalStateException` is thrown if the transaction is locked or if the BO is not part of the transaction (except in `diffingMode`).
  
  Parameters:
  
  bo - The BO from which the related object is being removed.
  
  attributeName - The name of the attribute representing the relationship.
  
  ptyp - The class of the removed related object.
  
  parm - The value of the removed related object.
  
  Throws:
  
  java.lang.IllegalStateException - If the transaction is locked or the BO is not included in the transaction (in non-diffing mode).
  
  recordPurge
  
  public void recordPurge(BO bo)
  
  Records a purge operation for the specified BO (Business Object) in this transaction.
  This method registers the intent to permanently delete the given BO from the database. It performs necessary checks to ensure the operation is valid and consistent with the transaction's state. This method should only be called by the backend. An IllegalStateException is thrown if the transaction is not called by the backend, the transaction is locked, or if the BO is not part of the transaction (except in diffingMode).
  
  Parameters:
  
  bo - The BO to be purged from the database.
  
  Throws:
  
  java.lang.IllegalStateException - If the method is not called by the backend, the transaction is locked, or the BO is not included in the transaction (in non-diffing mode).
  
  storeBLOB
  
  public ManagedFileI storeBLOB(BO bo, java.io.InputStream is) throws java.io.IOException
  
  Reads binary data from an InputStream and stores it as BLOB of the passed BO.
  
  Parameters:
  
  is - the InputStream to retrieve the BLOB data from; will be closed after the data was read from it.
  
  Throws:
  
  java.io.IOException
  
  removeBLOB
  
  public ManagedFileI removeBLOB(BO bo)
  
  precommitBLOBs
  
  public void precommitBLOBs() throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  commitBLOBs
  
  public void commitBLOBs() throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  rollbackBLOBs
  
  public void rollbackBLOBs() throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  finishBLOBs
  
  public void finishBLOBs() throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  enterSavePhase
  
  public void enterSavePhase()
  
  include
  
  public BO include(BO bo)
  
  include
  
  public BO include(BO bo, boolean forceNew)
  
  finalizeSaveProcedure
  
  public void finalizeSaveProcedure(TransactionAnswer ta, SaveBOListenerI sbl)
  
  Calls #replayAdditionalProcs(Collection) for replaying and incorporating "relevant" additional server-side changes (BOProcs) locally as well. The additional server-side changes are taken from the passed TransactionAnswer by replacing the "stubbed" BOs within the additional BOProcs of the TransactionAnswer by their "real" instances which are taken from this Transaction. Additionally the passed SaveBOListenerI is notified via the transactionSaveSuccess-callback about the successful save-process. Finally this Transaction is "commit()"ted locally. This only happens on the client-side, as additional BOProcs are only generated server-side and transmitted back to the client in the TransactionAnswer. Called by BOSaver.saveBO(Transaction, SaveBOImplementationI, SaveBOListenerI, boolean, int, int, Benutzer) to do these common tasks after saving has been completed one way or the other.
  
  commit
  
  public void commit()
  
  checkpoint
  
  public void checkpoint()
  
  flushLocals
  
  public void flushLocals()
  
  reFrapAfterSave
  
  public void reFrapAfterSave(TransactionConflictReport report, boolean stubs)
  
  Does maintenance to keep the internal object references in this Transaction intact after saving. Adjusts Id, Bot, Crea and Lmod for all included BOs of this Transaction by taking the correct values out of the TransactionAnswers being stored in the passed TransactionConflictReport, that was received from the server after save. Called by de.ipcon.db.BOSaver#saveBO() to do this common task after saving has been completed one way or the other, unless only existing BOs were modified and no conflicts arose during saving, in which case this maintenance is not necessary.
  
  close
  
  public void close()
  
  Closes this Transaction. It should not be used anymore after that.
  
  Finishes BLOB handling, i.e. removes any temporary BLOB handles.
  
  Activates the previous loader again in every included BO and removes its intenal reference to this tx.
  
  Flushes the schema's caches if it is an instrumented instance to ensure caching scripted attributes lose their current value.
  
  Clears the included BOs set.
  
  Clears the new BOs set.
  
  Clears the referenced BOs set.
  
  Clears the Map containing all BOs that were "seen".
  
  Removes all listeneres that are registered at the message bus.
  
  Flushes all TransactionLocal vars.
  
  Releases all save points.
  
  Clears all BO procs.
  
  Resets the last fired new BO proc index.
  
  closeAndClearLazyData
  
  public void closeAndClearLazyData()
  
  Closes this Transaction. It should not be used anymore after that. Additionally nulls the LazyData stored in all included and referenced BOs.
  
  Finishes BLOB handling, i.e. removes any temporary BLOB handles.
  
  Activates the previous loader again in every included BO and removes its intenal reference to this tx. Additionally nulls its LazyData.
  
  Flushes the schema's caches if it is an instrumented instance to ensure caching scripted attributes lose their current value.
  
  Clears the included BOs set.
  
  Clears the new BOs set.
  
  Clears the referenced BOs set. Additionally nulls the LazyData of all those referenced BOs.
  
  Clears the Map containing all BOs that were "seen".
  
  Removes all listeneres that are registered at the message bus.
  
  Flushes all TransactionLocal vars.
  
  Releases all save points.
  
  Clears all BO procs.
  
  Resets the last fired new BO proc index.
  
  disconnectBOs
  
  @Deprecated public void disconnectBOs()
  
  Deprecated.
  
  Just an alias for close(), as the Transaction will be closed and thus defunct after performing a disconnectBOs/close.
  
  disconnectBOs
  
  public void disconnectBOs(boolean clearLazyData)
  
  flush
  
  public void flush()
  
  Just like close, except that the cache remains intact and the transaction can continue.
  
  simulateSave
  
  public long simulateSave(boolean doVerify)
  
  Use ONLY in test environments. Simulates the saving of the included BOs in this transaction, setting their IDs to a nonnegative number.
  
  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()
  
  simulateSave
  
  public long simulateSave(long sid)
  
  simulateSave
  
  public long simulateSave(long sid, boolean doVerify)
  
  rehashCache
  
  public void rehashCache()
  
  drain
  
  public void drain()
  
  Completely empties the current BOLoaderWithCacheI. Not implemented in Transaction yet.
  
  Specified by:
  
  drain in interface BOLoaderI
  
  Specified by:
  
  drain in interface BOLoaderWithCacheI
  
  isCaching
  
  public boolean isCaching()
  
  Description copied from interface: BOLoaderI
  
  If true, then this BOLoaderI uses an internal cache, holding all BOs hat were loaded or frapped into it. In this case, the BOLoader should not be expected to handle automatic cache eviction (some might). A BOLoader that is caching can be expected to deduplicate BOs with the same Id from different sources to create a stable, self contained BO graph. Caching BOLoaders should not be expected to always hold the most up to date version of a BO, even after frapping a newer BO with it, i.e. an already cached BO is might always be preferred. If false, then this BOLoader will not hold references to loaded BOs, allowing them to be garbage collected as soon as they're no longer referenced outside of this class. As a result, this Interface makes no guarantees regarding deduplication of BOs in the returned graph.
  
  Specified by:
  
  isCaching in interface BOLoaderI
  
  Returns:
  
  true if this BOLoaderI uses a cache, false if loaded BOs aren't cached.
  
  isRecording
  
  public boolean isRecording()
  
  Description copied from interface: BOLoaderI
  
  Returns true if this BOLoaderI records changes.
  
  Specified by:
  
  isRecording in interface BOLoaderI
  
  getBOs
  
  public java.util.TreeMap<java.lang.Long,BO> getBOs(java.lang.Class<? extends BOI> _classTip)
  
  Method to retrieve all the included BOs with a specific class. Note that this method will only check the BOs which are included.
  
  Parameters:
  
  _classTip - The class of the BOs which we want to retrieve
  
  Returns:
  
  Returns a Treemap of the included BOs with the specific class.
  
  isActive
  
  public boolean isActive()
  
  Returns true if any proc(edure)s / changes were recorded in this transaction. Caution: Does not return true if only new BOs have been created (without any further changes to them) within this transaction.
  
  rollback
  
  public void rollback()
  
  playReverse
  
  public void playReverse()
  
  canonize
  
  public TransactionCanonification canonize(boolean modifyCurrent)
  
  This calculates a canonification of this transaction. Contrary to normal transaction logs, a canonification does not save the intermediate values for an attribute. Only the initial and (currently) final values are recorded. e.g. the originally recorded changes: 1->8, 8->2 are canonized (or shortened) to 1->2. If the parameter modifyCurrent is true and this transaction has uncommitted savepoints, then an exception is thrown, as canonization of the original tx ignores them, removing any intermediate values. This method does not enable 'auto canonization' for following changes.
  
  Parameters:
  
  modifyCurrent - if true, then the TransactionCanonification modifies this Transaction, if false, only a TransactionCanonification is returned for a what-if information
  
  Returns:
  
  a TransactionCanonification of this transaction
  
  canonize
  
  public TransactionCanonification canonize(boolean modifyCurrent, int from)
  
  canonize
  
  public TransactionCanonification canonize(boolean modifyCurrent, int from, int till)
  
  getCanonizedProcs
  
  public java.util.List<BOProc> getCanonizedProcs()
  
  Returns a list representing the procs after a TransactionCanonification of this Transaction.
  
  See Also:
  
  canonize(boolean modifyCurrent)
  
  getCanonizedProcs
  
  public java.util.List<BOProc> getCanonizedProcs(BO bo)
  
  Filters the canonized BOProc-s of this Transaction to the ones affecting the passed BO and possibly the provided attribute.
  
  Parameters:
  
  bo - the BO to get BOProc-s for.
  
  attributeName - the attribute of the BO that the returned BOProc-s should represent a change of; null means any change to the BO is relevant
  
  Returns:
  
  a non-null list of all recorded changes (possibly only regarding a certain attribute) to the passed BO within this Transaction (canonized)
  
  getCanonizedProcs
  
  public java.util.List<BOProc> getCanonizedProcs(BO bo, java.lang.String attributeName)
  
  getCanonizedProcs
  
  public java.util.List<BOProc> getCanonizedProcs(BO bo, java.util.Set<java.lang.String> attrs)
  
  Filters the canonized BOProc-s of this Transaction to the ones affecting the passed BO and the provided attributes.
  
  Parameters:
  
  bo - the BO to get BOProc-s for.
  
  attrs - a Set of attributes of the BO that the returned BOProc-s should represent a change of; empty means any change to the BO is relevant
  
  Returns:
  
  a non-null list of all recorded changes (possibly only regarding the passed attributes) to the passed BO within this Transaction (canonized)
  
  readInstance
  
  public void readInstance(SecureObjectInputI s, boolean stubClone) throws java.lang.ClassNotFoundException, java.io.IOException
  
  Throws:
  
  java.lang.ClassNotFoundException
  
  java.io.IOException
  
  readInstance
  
  public void readInstance(SecureObjectInputI s, boolean stubClone, boolean checkIntegrity) throws java.lang.ClassNotFoundException, java.io.IOException
  
  Throws:
  
  java.lang.ClassNotFoundException
  
  java.io.IOException
  
  readInstance
  
  public void readInstance(SecureObjectInputI s, boolean stubClone, boolean checkIntegrity, boolean forDeepClone) throws java.lang.ClassNotFoundException, java.io.IOException
  
  Throws:
  
  java.lang.ClassNotFoundException
  
  java.io.IOException
  
  writeProcInstance
  
  public void writeProcInstance(SecureObjectOutputI s, java.util.HashMap<BO,java.lang.Integer> indexMap, BOProc proc, boolean stubClone, boolean forDeepClone) throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  readProcInstance
  
  public BOProc readProcInstance(SecureObjectInputI s, java.util.ArrayList<BO> boList, boolean stubClone, boolean forDeepClone) throws java.lang.ClassNotFoundException, java.io.IOException
  
  Throws:
  
  java.lang.ClassNotFoundException
  
  java.io.IOException
  
  writeBOInstance
  
  public void writeBOInstance(SecureObjectOutputI s, BO bo) throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  readBOInstance
  
  public BO readBOInstance(SecureObjectInputI s) throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  writeInstanceWithoutBLOBTransfer
  
  public void writeInstanceWithoutBLOBTransfer(SecureObjectOutputI s) throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  writeInstanceToServer
  
  public void writeInstanceToServer(SecureObjectOutputI s, java.lang.Thread savingThread) throws java.io.IOException
  
  Throws:
  
  java.io.IOException
  
  checkIntegrity
  
  public void checkIntegrity(boolean addRemarkForUndeletedNewBOsWithoutProcs)
  
  Checks the integrity of this transaction in regard to its recorded BOs. Throws an IllegalArgumentException (FIXME why not IllegalStateException?) if the integrity check failed and an invalid structure is detected, to prevent further processing.
  
  prependBTs
  
  public void prependBTs(BT[] bts)
  
  Applies changes from the provided BTs to make them appear to happen before any direct change of this transaction. i.e. undo all changes from this tx, apply changes from the provided bts and reapply this tx's changes again. FIXME extend javadoc about the situation this is used for, why it doesn't clash with the other replay methods, etc.
  
  applyOtherTransactionsSaveSuccess
  
  public void applyOtherTransactionsSaveSuccess(Transaction otx)
  
  Iterates through the procs of the provided transaction and applies all modifications relevant to this transaction to the cached BOs. This method is used for transactions that originated on the same client after the changes in it were successfully persisted. Will also be called with a clone of this transaction, which will include possible verifyOnServer changes, when saving. It is called from the DefaultFormContext to update the state of the current form and prevent conflicts if the same user modifies the same BO in two forms concurrently.
  
  upgradeLocks
  
  public void upgradeLocks()
  
  createOrTouchAdditional
  
  public java.util.Set createOrTouchAdditional(java.util.Date transactionDate, Transaction.Additional addtx)
  
  Memorizes BOs that were created in addtx in the "new" list of the PersistenceHandlerI and updates the Lmod of changed BOs from addtx. Nothing is actually persisted here yet.
  
  Returns:
  
  a Set containing the created and modified BOs from addtx
  
  serverLocalTransactionStorePrepare
  
  public TransactionConflictReport serverLocalTransactionStorePrepare(SchemaI schema)
  
  Prepares this server-local transaction for storage, optimizing for the scenario where objects are already loaded server-side.
  This method handles server-local transactions differently from regular transactions, as it avoids reloading objects that are already present on the server. Instead, it focuses on updating the `lmod` (last modified) date for these objects.
  
  Parameters:
  
  schema - The schema to use within the returned TransactionConflictReport.
  
  Returns:
  
  A `TransactionConflictReport` detailing any conflicts or issues encountered during saving.
  
  replayInStorePrepare
  
  public TransactionConflictReport replayInStorePrepare(SchemaI schema, Benutzer user)
  
  Prepares this transaction for storage by reloading all associated objects through the persistence handler.
  This method is crucial for detecting changes made to objects during transaction replay. By reloading the objects, the system can accurately identify modifications and ensure data consistency when committing the transaction.
  
  Parameters:
  
  schema - The schema to use within the returned TransactionConflictReport.
  
  user - The user initiating the saving of the transaction, to use within the returned TransactionConflictReport.
  
  Returns:
  
  A `TransactionConflictReport` detailing any conflicts or issues encountered during reloading and thus the intended saving of existing objects.
  
  serverLocalTransactionStoreFinish
  
  public void serverLocalTransactionStoreFinish(java.util.Date serverLocalTransactionDate, boolean isChangeByBenutzer, PersistenceHandlerI ph)
  
  replayInStoreFinish
  
  public void replayInStoreFinish(TransactionConflictReport report, boolean isChangeByBenutzer)
  
  replayInStoreLog
  
  public void replayInStoreLog(TransactionConflictReport report, Benutzer user)
  
  replayInStoreWithoutLog
  
  public void replayInStoreWithoutLog(TransactionConflictReport report, Benutzer user)
  
  getSavesCountNN
  
  public int getSavesCountNN()
  
  increaseSavesCount
  
  public void increaseSavesCount()
  
  getDescription
  
  public java.lang.String getDescription()
  
  Returns the currently set description of this Transaction. If we are not in sync mode and the transaction has already been saved at least once, the save count text "[Save #...]" is automatically appended.
  
  Returns:
  
  the text set via setDescription() possible postfixed by a save count text.
  
  appendDescription
  
  public void appendDescription(java.lang.String _desc)
  
  Appends the given String to an already existing description of this Transaction or sets the description to the passed String, if none was set before. Uses a plus symbol, surrounded by a whitespace, as delimiter between the original and appended description.
  
  setDescription
  
  public void setDescription(java.lang.String _desc)
  
  Sets the description (something like a commit message) of this Transaction. The set String will be persisted to the "Description" attribute of the BT.
  
  getBT
  
  public BT getBT()
  
  replay
  
  public void replay()
  
  Replays the BOProcs of this Transaction, applying the recorded changes again.
  
  Parameters:
  
  conflictingTX - disable recording on the conflictingTX as well while replaying all changes on this. See Solstice's Client.nrx for nonnull case, i.e. when reapplying and merging transaction conflicts. Null in other cases.
  
  replay
  
  public void replay(Transaction conflictingTX)
  
  incorporateDiffOfConflictingBO
  
  public void incorporateDiffOfConflictingBO(BO localBO, BO conflictingBO, SchemaI schema)
  
  Incorporates into this Transactions the diff between the first passed (old) BO and the second passed (new and conflicting) BO, i.e. all necessary changes that are needed to transform changedBO into conflictingBO. Covered are all changes: deletion / undeletion, setting of scalar or relation-attributes as well as adding or removing objects to or from a relation. Needed during BOSaver.saveBO(de.ipcon.db.core.Transaction, de.ipcon.db.SaveBOImplementationI) in case of a conflict during save. changedBO and conflictingBO must essentially be the same BO, that is must be of the same class and have the same Id, only as different in-memory instances.
  
  Parameters:
  
  changedBO - the instance of the BO on which changes were performed by the user
  
  conflictingBO - the instance of the BO which was modified concurrently by/in another client
  
  schema - a SchemaI for getting entities, attributes, etc.
  
  getLogPrefixForProgress
  
  public java.lang.String getLogPrefixForProgress()
  
  evaluateVerifyOnServer
  
  public Transaction.Additional evaluateVerifyOnServer(java.lang.Long nodeNumber, Benutzer user)
  
  This may generate and return new BOProcs; will be called shortly before commit if no conflicts have occurred.
  
  evaluateVerifyOnServer
  
  public Transaction.Additional evaluateVerifyOnServer(java.lang.Long nodeNumber, Benutzer user, java.util.Set explicitTouchedBOs)
  
  fireAfterSave
  
  public void fireAfterSave(java.lang.Long nodeNumber, Benutzer user, SaveException se)
  
  Called by DBMan after the save process finished, either successfully (se = null) or due to an "application level" error (se <> null). Not called when some internal error during saving occurred.
  
  Parameters:
  
  nodeNumber - the node number of the server on which the saving is performed
  
  user - the Benutzer in whose context the transaction was saved
  
  se - if not null the SaveException that was thrown during saving, for example because of some failed verifyOnServer() checks; if null the saving was finished successfully
  
  filterAdditionals
  
  public Transaction.Additional filterAdditionals(Transaction.Additional adds)
  
  getDumper
  
  public TransactionDumper getDumper()
  
  dumpProcs
  
  public void dumpProcs()
  
  dumpProcs
  
  public void dumpProcs(java.util.ArrayList _procs)
  
  dumpProcs
  
  public void dumpProcs(int _from, int _to)
  
  dumpProcs
  
  public void dumpProcs(int _from, int _to, java.util.List _procs)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger l, org.apache.log4j.Level _level)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger l)
  
  Description copied from interface: BOProcHolderI
  
  Dumps the procedures in a human-readable format to the specified logger.
  
  Specified by:
  
  dumpProcs in interface BOProcHolderI
  
  Parameters:
  
  l - The logger to which the procedures should be dumped.
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger l, java.util.List _procs)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger l, java.util.List _procs, org.apache.log4j.Level _level)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger _log, int _from, int _to)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger _log, int _from, int _to, java.util.List _procs)
  
  dumpProcs
  
  public void dumpProcs(org.apache.log4j.Logger _log, int _from, int _to, java.util.List _procs, org.apache.log4j.Level _level)
  
  getSummary
  
  public java.lang.String getSummary()
  
  Prints a summary of this transaction (procs in a summarized, simplified form), e.g.:
  10 Kunde-s were changed.
  3 Kontakt-s were created.
  1 AbstraktePerson was deleted.
  
  This may be enough just to see if a script has modified the expected number of objects, and whether stuff was unexpectedly changed, created or deleted. Especially useful for transactions involving a large number of objects.
  
  procsToString
  
  public java.lang.String procsToString(int from, int till)
  
  Converts the procedures of this transaction to a human-readable string representation.
  
  Parameters:
  
  from - Start index(inclusive) of the procs inside this Transaction that are to be printed.
  
  till - End index(inclusive) of the procs inside this Transaction that are to be printed. A value of -1 is equivalent to (getProcs().size() - 1)
  
  html - Whether to format the output as HTML or plain text.
  
  onlyThisBO - If not null, only BOProcs affecting this BO will be included in the output.
  
  limitToExplicitBO - If false, all procs are being printed even when the onlyThisBO is not null.
  
  maxProcs - Number of procs that are to be printed (exclusive). A value of -1 is equivalent to getProcs().size().
  
  grouped - Whether the procs should be formatted to be grouped by the BO they are concerning or not.
  
  canonize - Whether the procs of this transaction are to be canonized canonize(boolean).
  
  skipBackProcs - Whether to skip "redundant" procs setting only back relations from the output. Only makes sense if canonize is passed as true as well.
  
  Returns:
  
  A string representation of the procedures within this transaction.
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped, boolean canonize)
  
  procsToString
  
  public java.lang.String procsToString(int from, int till, boolean html, BO onlyThisBO, boolean limitToExplicitBO, int maxProcs, boolean grouped, boolean canonize, boolean skipBackProcs)
  
  procsToString
  
  public java.lang.String procsToString(boolean html, boolean skipBackProcs, BO onlyThisBO)
  
  Converts the procedures affecting a specific BO to a human-readable string representation.
  A wrapper for #procsToString(int, int, boolean, BO, boolean, int, boolen, boolean) that automatically collects all available procs and formats the output to be grouped.
  
  Specified by:
  
  procsToString in interface BOProcHolderI
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  skipBackProcs - Whether to skip "redundant" procs setting only back relations from the output.
  
  onlyThisBO - If not null, only BOProcs affecting this BO will be included in the output.
  
  Returns:
  
  A string representation of the procedures within this transaction.
  
  procsToString
  
  public java.lang.String procsToString()
  
  Converts the procedures of this transaction to a human-readable string representation.
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  onlyThisBO - If not null, only BOProcs affecting this BO will be included in the output.
  
  canonize - Whether the procs of this transaction are to be canonized canonize(boolean).
  
  limitToExplicitBO - If false, all procs are being printed even when the onlyThisBO is not null.
  
  maxProcs - Number of procs that are to be printed (exclusive). A value of -1 is equivalent to getProcs().size().
  
  skipBackProcs - Whether to skip "redundant" procs setting only back relations from the output. Only makes sense if canonize is passed as true as well.
  
  Returns:
  
  A string representation of the procedures within this transaction.
  
  procsToString
  
  public java.lang.String procsToString(boolean html)
  
  Description copied from interface: BOProcHolderI
  
  Converts the procedures to a human-readable string representation.
  
  Specified by:
  
  procsToString in interface BOProcHolderI
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  Returns:
  
  A string representation of the procedures.
  
  procsToString
  
  public java.lang.String procsToString(boolean html, BO onlyThisBO)
  
  Description copied from interface: BOProcHolderI
  
  Converts the procedures affecting a specific BO to a human-readable string representation.
  
  Specified by:
  
  procsToString in interface BOProcHolderI
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  onlyThisBO - If not null, only BOProcs affecting this BO will be included in the output.
  
  Returns:
  
  A string representation of the procedures affecting the specified BO.
  
  procsToString
  
  public java.lang.String procsToString(boolean html, BO onlyThisBO, boolean canonize)
  
  procsToString
  
  public java.lang.String procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO)
  
  procsToString
  
  public java.lang.String procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, int maxProcs)
  
  procsToString
  
  public java.lang.String procsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, int maxProcs, boolean skipBackProcs)
  
  allProcsToString
  
  public java.lang.String allProcsToString()
  
  wrapper for #procsToString(int, int, boolean, BO, boolean, int, boolen, boolean) that automatically collects and prints all available procs and formats the output to be grouped
  
  Returns:
  
  A string representation of the procedures within this transaction.
  
  allProcsToString
  
  public java.lang.String allProcsToString(boolean html)
  
  allProcsToString
  
  public java.lang.String allProcsToString(boolean html, BO onlyThisBO)
  
  allProcsToString
  
  public java.lang.String allProcsToString(boolean html, BO onlyThisBO, boolean canonize)
  
  allProcsToString
  
  public java.lang.String allProcsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO)
  
  allProcsToString
  
  public java.lang.String allProcsToString(boolean html, BO onlyThisBO, boolean canonize, boolean limitToExplicitBO, boolean skipBackProcs)
  
  allLocalsToString
  
  public java.lang.String allLocalsToString()
  
  Returns a String containing all keys and values of the current txLocals.
  
  Returns:
  
  a String containing all keys and values of the current txLocals
  
  currentSavepointToString
  
  public java.lang.String currentSavepointToString()
  
  Returns a String containing the name of the current savepoint or null if there is none.
  
  Returns:
  
  a String containing the name of the current savepoint or null if there is none
  
  getDepMaps
  
  public java.util.List<java.util.Map> getDepMaps(BO bo)
  
  newBOsToString
  
  public java.lang.String newBOsToString()
  
  Converts the new BOs to a human-readable string representation.
  
  Returns:
  
  A string representation of the new BOs.
  
  newBOsToString
  
  public java.lang.String newBOsToString(boolean html)
  
  Description copied from interface: BOProcHolderI
  
  Converts the new BOs to a human-readable string representation.
  
  Specified by:
  
  newBOsToString in interface BOProcHolderI
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  Returns:
  
  A string representation of the new BOs.
  
  newBOsToString
  
  public java.lang.String newBOsToString(boolean html, int offset)
  
  Converts the new BOs to a human-readable string representation.
  
  Parameters:
  
  html - Whether to format the output as HTML or plain text.
  
  offset - An offset to apply to the procedures within this transaction when converting new BOs to a string representation.
  
  Returns:
  
  A string representation of the new BOs.
  
  dumpCache
  
  public void dumpCache(org.apache.log4j.Logger l)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.lang.String[] skipAtts)
  
  Method to copy the attribute values from the given BO of the given Entity. It returns the new BO object with the copied values. Attention: Any attribute of the given BO marked in the schema with "omitOnCopy" is excluded even if not specified as skipped attribute
  
  Returns:
  
  The new BO with copied attributes
  
  See Also:
  
  de.ipcon.db.core.BO#copyFrom(), BO.createCopy()
  
  includeCopy
  
  public BO includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.lang.String[] skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)
  
  includeCopy
  
  public BO includeCopy(BO bo)
  
  Copies attribute values and references from the given BO to a new BO.
  Relations are either only linked or copied, depending on the copy policy of that attribute or its 'new'-state. Many-Relations marked as dependent are copied, otherwise linked.
  Attention: Any attribute of the given BO marked in the schema with "omitOnCopy" is excluded even if not specified as skipped attribute
  
  Parameters:
  
  bo - the nonnull BO to copy.
  
  skipAtts - a nullable Set of attribute names to explicitly exclude from being copied.
  
  ignoreManyRelation - if true, then many relations to other BOs are skipped completely. Otherwise they're handled according to the copy policy for this attribute.
  
  subentityToCreate - If null, then the returned value has the same class/Entity as BO. If not null, then the returned "copy" is an instance of the provided EntityI and a subclass of the provided BO. Needs to be a subclass/subentity of the bo parameter.
  
  alreadyCreated - nonnull but possibly empty Map to explicitly prevent creation of relation BOs, use the BO linked to this key instead.
  
  ignoreErrors - if true, then errors while copying attributes are ignored. If false, a FillBOException is thrown. Has no effect on exceptions unrelated to filling BO.
  
  Returns:
  
  The new BO with copied attributes
  
  See Also:
  
  de.ipcon.db.core.BO#copyFrom(), BO.createCopy()
  
  includeCopy
  
  public BO includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated)
  
  includeCopy
  
  public BO includeCopy(BO bo, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI subentityToCreate, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)
  
  fillBO
  
  public BO fillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors, boolean recursiveCall)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors)
  
  prepareFillBO
  
  public Transaction.FillBOResult prepareFillBO(BO bo, BO copyIntoBO, java.util.Set<java.lang.String> skipAtts, boolean ignoreManyRelations, EntityI ent, java.util.Map<java.lang.Long,BO> alreadyCreated, boolean ignoreErrors, boolean recursiveCall)
  
  isLoggedIn
  
  public java.lang.Boolean isLoggedIn(Benutzer _ben)
  
  Description copied from interface: BOLoaderI
  
  Tells if the given Benutzer is currently logged in.
  
  Specified by:
  
  isLoggedIn in interface BOLoaderI
  
  Parameters:
  
  _ben - the Benutzer for which the logged in state should be checked
  
  Returns:
  
  Boolean.TRUE if Benutzer is currently logged in, Boolean.FALSE if not and null if this info is not available
  
  isLoggedInNN
  
  public boolean isLoggedInNN(Benutzer _ben)
  
  Description copied from interface: BOLoaderI
  
  Tells if the given Benutzer is currently logged in.
  
  Specified by:
  
  isLoggedInNN in interface BOLoaderI
  
  Parameters:
  
  _ben - the Benutzer for which the logged in state should be checked
  
  Returns:
  
  true if Benutzer is currently logged in, false if not or if this info is not available
  
  mergeIn
  
  public void mergeIn(Transaction otherTx)
  
  Merges in another Transaction into this Transaction under certain circumstances and invalidates the merged in Transaction after that. This enables us to save the result of multiple transactions using only one transaction and one turnaround to the server. Please note that this is an experimental feature for now! This only works if - both Transactions have the same modes set - both Transactions have not yet been saved, ever - the temporary Ids of the Transaction are mutually exclusive, i.e. they need to share the same TemporaryIdSupplierI. After calling this method the Transaction will contain all new values and procs of the passed Transaction by "hijacking" the new BOs and BOProcs of the passed Transaction. Additionally the cache will contain all objects from the passed Transaction and the next temp Id will be consistent with the Ids of the already existing new BOs. Be aware that the notification backlog will be cleaned, so the message bus will not report anything happening during this merge or not yet having been notified about in any of the two Transactions involved.
  
  mergeIn
  
  public void mergeIn(Transaction otherTx, boolean appendOtherDescriptions)
  
  mergeIn
  
  public void mergeIn(Transaction otherTx, boolean appendOtherDescriptions, boolean addOtherRemarks)
  
  stubClone
  
  public Transaction stubClone(BOLoaderI bol)
  
  stubClone
  
  public Transaction stubClone(BOLoaderI bol, boolean doCanonize)
  
  serialize
  
  public SerializedTransaction serialize() throws IRuntimeException
  
  Throws:
  
  IRuntimeException
  
  deserialize
  
  public static Transaction deserialize(SerializedTransaction stx, BOLoaderI bol, SchemaI schema, TemporaryIdSupplierI tempIdSupplier) throws IRuntimeException
  
  Throws:
  
  IRuntimeException
  
  deepClone
  
  public Transaction deepClone(BOLoaderI bol, SchemaI schema)
  
  Creates a new Transaction from this Transaction having all BOs reloaded with the passed BOLoaderI Also sets the passed schema as explicit schema, if it is not null, otherwise carries over the explicit schema of this Transaction to the new one, if any.
  
  Parameters:
  
  bol - the BOLoaderI to use for reloading the BOs of this Transaction; falls back to BOLoader of this Transaction, if null is passed
  
  schema - the explicit schema to set in the clone; falls back to the Schema of this Transaction, if null is passed
  
  preserveBLOBHandles - if true, the BLOBHandles of this Transaction are also set in the clone
  
  preserverTxLocals - if true, the txLocals of this Transaction are copied to the clone
  
  preserverCurrentUser - if true, the current user of this Transaction is also set in the clone, after it has been frapped
  
  Returns:
  
  a clone of this Transaction
  
  deepClone
  
  public Transaction deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles)
  
  deepClone
  
  public Transaction deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles, boolean preserveTxLocals)
  
  deepClone
  
  public Transaction deepClone(BOLoaderI bol, SchemaI schema, boolean preserveBLOBHandles, boolean preserveTxLocals, boolean preserveCurrentUser)
  
  copyLocalsFrom
  
  public void copyLocalsFrom(Transaction tx)
  
  copyLocalsFrom
  
  public void copyLocalsFrom(Transaction tx, boolean excludeCurrentUser)
  
  copyLocalsFrom
  
  public void copyLocalsFrom(Transaction tx, boolean excludeCurrentUser, boolean skipExisting)
  
  restoreBLOBHandlesFrom
  
  public void restoreBLOBHandlesFrom(Transaction tx)
  
  hasProperty
  
  public boolean hasProperty(java.lang.String key)
  
  Returns true if a transaction property with the passed key exists.
  
  getProperty
  
  public java.lang.Object getProperty(java.lang.String name)
  
  Returns object represented by name or null, if no property with the passed name is found. If a Savepoint is active at the moment, then the value will be fetched from the Savepoint context.
  
  Parameters:
  
  name - String with name of property
  
  Returns:
  
  object or null if nothing found
  
  setProperty
  
  public void setProperty(java.lang.String name, java.lang.Object value, byte scope)
  
  sets property value in current transaction context to specified value with the specified scope. Scoping a property means to specify its holdability, whether it will survive a commit, be transferred to the server or live forever in this particular transaction object (but is not transferred). If a Savepoint is active at the moment, then the value will be set in the Savepoint, so rolling back the Savepoint will either unset the value or make the old value visible again, depending on whether there was a property set before or not.
  
  Parameters:
  
  name - String with the name of the property
  
  value - Object value of the property
  
  scope - Scope of this variable
  
  isFinal - If this variable shall be "final", i.e. unmodifiable
  
  See Also:
  
  PROPERTY_SCOPE_COMMIT, PROPERTY_SCOPE_TRANSACTION, PROPERTY_SCOPE_SERVER, PROPERTY_SCOPE_PERSISTENT, savepoint(String)
  
  setProperty
  
  public void setProperty(java.lang.String name, java.lang.Object value, byte scope, boolean isFinal)
  
  getPersistentPropertyKey
  
  public static java.lang.String getPersistentPropertyKey(EntityI namespaceEntity, java.lang.String name)
  
  hasPersistentProperty
  
  public boolean hasPersistentProperty(EntityI namespaceEntity, java.lang.String name)
  
  getPersistentStringProperty
  
  public java.lang.String getPersistentStringProperty(EntityI namespaceEntity, java.lang.String name)
  
  setPersistentStringProperty
  
  public void setPersistentStringProperty(EntityI namespaceEntity, java.lang.String name, java.lang.String value)
  
  getPersistentLongProperty
  
  public java.lang.Long getPersistentLongProperty(EntityI namespaceEntity, java.lang.String name)
  
  setPersistentLongProperty
  
  public void setPersistentLongProperty(EntityI namespaceEntity, java.lang.String name, java.lang.Long value)
  
  getPersistentDecimalProperty
  
  public java.math.BigDecimal getPersistentDecimalProperty(EntityI namespaceEntity, java.lang.String name)
  
  setPersistentDecimalProperty
  
  public void setPersistentDecimalProperty(EntityI namespaceEntity, java.lang.String name, java.math.BigDecimal value)
  
  getPersistentBooleanProperty
  
  public java.lang.Boolean getPersistentBooleanProperty(EntityI namespaceEntity, java.lang.String name)
  
  setPersistentBooleanProperty
  
  public void setPersistentBooleanProperty(EntityI namespaceEntity, java.lang.String name, java.lang.Boolean value)
  
  savepoint
  
  public Transaction.Savepoint savepoint(java.lang.String name)
  
  Creates and returns a savepoint with the given name in this transaction.
  
  savepoint
  
  public Transaction.Savepoint savepoint(java.lang.String name, java.lang.Object owner)
  
  Creates and returns a savepoint with the given name and owner in this transaction
  
  Parameters:
  
  name - name of the savepoint
  
  owner - owner of the savepoint, needed for owner-oriented API calls, see below
  
  Returns:
  
  the freshly created savepoint
  
  See Also:
  
  getSavepoints(Object), getLatestSavepoint(Object), rollbackLatestSavepoint(Object)
  
  getSavepoints
  
  public Transaction.Savepoint[] getSavepoints(java.lang.Object owner)
  
  Get all valid savepoints filed under the given owner in a list, the latest snapshot at index 0.
  
  Parameters:
  
  owner - owner object given previously to savepoint(String,Object)
  
  Returns:
  
  valid savepoints, latest first
  
  See Also:
  
  savepoint(String,Object), getLatestSavepoint(Object), rollbackLatestSavepoint(Object)
  
  hasSavepoint
  
  public boolean hasSavepoint(java.lang.String name, java.lang.Object owner)
  
  Returns true if there is an active savepoint with the given name and owner.
  
  Parameters:
  
  name - desired String possibly given previously as name to savepoint(String,Object)
  
  owner - desired owner object possibly given previously to savepoint(String,Object)
  
  Returns:
  
  true if there is an active savepoint with the given name and owner
  
  See Also:
  
  savepoint(String,Object)
  
  getLatestSavepoint
  
  public Transaction.Savepoint getLatestSavepoint(java.lang.Object owner)
  
  Get the latest valid (read:youngest) savepoint filed under the given owner
  
  Parameters:
  
  owner - owner object given previously to savepoint(String,Object)
  
  Returns:
  
  latest valid savepoint
  
  See Also:
  
  savepoint(String,Object), getSavepoints(Object), rollbackLatestSavepoint(Object)
  
  hasSavepoints
  
  public boolean hasSavepoints()
  
  Returns:
  
  true, if at least one savepoint with any owner exists in the Transaction, false otherwise
  
  rollbackLatestSavepoint
  
  public boolean rollbackLatestSavepoint(java.lang.Object owner)
  
  Roll back to the latest valid (read:youngest) savepoint filed under the given owner, if there is one, and return true. Otherwise does nothing and returns false.
  
  Parameters:
  
  owner - owner object given previously to savepoint(String,Object)
  
  Returns:
  
  True, if rollback was done. False otherwise.
  
  See Also:
  
  savepoint(String,Object), getSavepoints(Object), getLatestSavepoint(Object)
  
  savepointBelongsHere
  
  public boolean savepointBelongsHere(Transaction.Savepoint _sp)
  
  Tells if the given Savepoint belongs to this Transaction.
  
  Parameters:
  
  _sp - the Savepoint to check
  
  Returns:
  
  true if the Savepoint belongs to this Transaction; false otherwise
  
  flagAsUserChoseToOverrideSaveVetoExceptions
  
  public void flagAsUserChoseToOverrideSaveVetoExceptions(java.lang.String message)
  
  Marks this transaction as user chose to override (all) SaveVetoExceptions. Additionally a remark about that is added to this transaction.
  
  isUserChoseToOverrideSaveVetoExceptions
  
  public boolean isUserChoseToOverrideSaveVetoExceptions()
  
  Returns true if this Transaction was marked as user chose to override (all) SaveVetoExceptions.
  
  flagAsMassChange
  
  public void flagAsMassChange()
  
  Marks this transaction as mass change. This information is not transmitted to the server-side.
  
  isMassChange
  
  public boolean isMassChange()
  
  Returns true if this Transaction was marked as mass change. Not available on server-side.
  
  addRemark
  
  public void addRemark(java.lang.String _str)
  
  Convenience method that adds the given String to this Transactions "Remarks" string with a newline prepended (if "Remarks" wasn't null or empty before). The resulting whole remarks String will be saved to attribute "Remarks" of the BT.
  
  initRemarks
  
  public void initRemarks(java.lang.String _str)
  
  Initializes the remarks to the given String. Only the sync is allowed to do that, as replacing and thus removing previously added transaction remarks is a serious change that not everybody should be allowed to do.
  
  getRemarks
  
  public java.lang.String getRemarks()
  
  Returns a String containing all remarks that were set for this transaction.
  
  Returns:
  
  the current remarks for this Transaction
  
  toString
  
  public java.lang.String toString()
  
  Overrides:
  
  toString in class java.lang.Object
  
  toString
  
  public java.lang.String toString(boolean _showRuntimeInfo)
  
  logDebug
  
  public void logDebug(java.lang.String _logmessage)
  
  Adds the message to the remarks if the specified loglevel is equal/above Debug
  
  logInfo
  
  public void logInfo(java.lang.String _logmessage)
  
  Adds the message to the remarks if the specified loglevel is equal/above Info
  
  logWarn
  
  public void logWarn(java.lang.String _logmessage)
  
  Adds the message to the remarks if the specified loglevel is equal/above Warn
  
  logError
  
  public void logError(java.lang.String _logmessage)
  
  Adds the message to the remarks if the specified loglevel is equal/above Error
  
  isSyncMode
  
  public boolean isSyncMode()
  
  Represents a savepoint within a transaction, enabling selective rollback of changes.
  This class provides a mechanism to create a snapshot of the transaction's state at a given point. If subsequent operations within the transaction encounter errors or need to be undone, you can roll back to this savepoint, discarding any changes made after its creation.
  
  **Usage:**
  
  Transaction.Savepoint sp = tx.savepoint("foo"); // Create a savepoint named "foo" try { // Perform operations that might need to be rolled back sp.commit(); // Mark the savepoint as successful; **MUST BE THE LAST STATEMENT IN THE TRY BLOCK** } finally { if (sp.isValid()) { sp.rollback(); // Roll back to the savepoint if it hasn't been committed or already rolled back } }
  
  **Important:**
  
  The `sp.commit()` call **must** be the final statement within the `try` block. Any exceptions occurring after this point will result in a falsely committed savepoint, rendering it useless for rollback.
  
  Always check `sp.isValid()` before calling `sp.rollback()` to ensure the savepoint is still active and hasn't been committed or already rolled back yet.
  
  setSyncMode
  
  public void setSyncMode(boolean $338)
  
  isRepairMode
  
  public boolean isRepairMode()
  
  setRepairMode
  
  public void setRepairMode(boolean $339)
  
  isDiffingMode
  
  public boolean isDiffingMode()
  
  setDiffingMode
  
  public void setDiffingMode(boolean $340)
  
  isInitEnvironmentMode
  
  public boolean isInitEnvironmentMode()
  
  setInitEnvironmentMode
  
  public void setInitEnvironmentMode(boolean $341)
  
  getOrigNode
  
  public java.lang.Long getOrigNode()
  
  setOrigNode
  
  public void setOrigNode(java.lang.Long $342)
  
  getOrigBTId
  
  public java.lang.Long getOrigBTId()
  
  setOrigBTId
  
  public void setOrigBTId(java.lang.Long $343)
  
  getOrigUser
  
  public java.lang.Long getOrigUser()
  
  setOrigUser
  
  public void setOrigUser(java.lang.Long $344)
  
  getOrigTime
  
  public java.util.Date getOrigTime()
  
  setOrigTime
  
  public void setOrigTime(java.util.Date $345)
  
  getLocalLastModifiedBOs
  
  public long getLocalLastModifiedBOs()
  
  setLocalLastModifiedBOs
  
  public void setLocalLastModifiedBOs(long $346)
  
  getBTId
  
  public java.lang.Long getBTId()
  
  setBTId
  
  public void setBTId(java.lang.Long $347)
  
  getLogLevel
  
  public int getLogLevel()
  
  setLogLevel
  
  public void setLogLevel(int $348)
  
  isIgnoreBotCoherency
  
  public boolean isIgnoreBotCoherency()
  
  setIgnoreBotCoherency
  
  public void setIgnoreBotCoherency(boolean $349)
  
  isRecordNonPersistent
  
  public boolean isRecordNonPersistent()
  
  setRecordNonPersistent
  
  public void setRecordNonPersistent(boolean $350)
  
  isAlwaysReloadOnFrap
  
  public boolean isAlwaysReloadOnFrap()
  
  setAlwaysReloadOnFrap
  
  public void setAlwaysReloadOnFrap(boolean $351)
  
  getProvider
  
  public TransactionProviderI getProvider()
  
  setProvider
  
  public void setProvider(TransactionProviderI $352)
  
  isExplicitActive
  
  public boolean isExplicitActive()
  
  setExplicitActive
  
  public void setExplicitActive(boolean $353)
  
  isInhibitDefaults
  
  public boolean isInhibitDefaults()
  
  setInhibitDefaults
  
  public void setInhibitDefaults(boolean $354)
  
  getOrigin
  
  public java.lang.RuntimeException getOrigin()
  
  setOrigin
  
  public void setOrigin(java.lang.RuntimeException $355)
  
  getSavesCount
  
  public java.lang.Integer getSavesCount()
  
  setSavesCount
  
  public void setSavesCount(java.lang.Integer $356)
  
  getRootPaneToLockOnConnectionInterrupt
  
  public javax.swing.JRootPane getRootPaneToLockOnConnectionInterrupt()
  
  setRootPaneToLockOnConnectionInterrupt
  
  public void setRootPaneToLockOnConnectionInterrupt(javax.swing.JRootPane $357)

Class Transaction

Nested Class Summary

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

Field Summary

Method Summary

Methods inherited from class java.lang.Object

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

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

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

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

Field Detail

LOG_LEVEL_DEBUG

LOG_LEVEL_INFO

LOG_LEVEL_WARN

LOG_LEVEL_ERROR

LOG_LEVEL_DISABLE

GET_ORIGNODE_DEFAULT_VALUE

PROPERTY_SCOPE_SAVEPOINT

PROPERTY_SCOPE_COMMIT

PROPERTY_SCOPE_SERVER

PROPERTY_SCOPE_TRANSACTION

PROPERTY_SCOPE_PERSISTENT

SKIP_CLIENT_VERIFIES_FOR_ADMINS

SKIP_SERVER_VERIFIES_FOR_ADMINS

SKIP_RECALCS_FOR_DATA_REPAIR

procs

newbos

purges

bos

refs

remarks

description

clientSaveLock

savePhase

Method Detail

killNewProcsRunner

getHumanReadablePropertyScope

isScopeValid

isScopeCommit

isScopeTransaction

isScopeServer

isScopePersistent

isScopeSavepoint

isPropertyFinal

getFinalScope

isInstance

acquireReadLock

tryAcquireReadLock

weHaveReadLock

releaseReadLock

acquireWriteLock

releaseWriteLock

assertWriteLock

resetReversedMode

setCurrentUser

getCurrentUser

continueWithTempIdsFrom

isOnAuthoritativeSyncServer

recalcOfBOsShouldBeCanceled

isInOTRMode

isLocked

isClosing

isClosed

isUndo

isUndoWithTimeTravel

isUndoWithoutTimeTravel

disableClientVerification

isClientVerificationDisabled

disableServerVerification

isServerVerificationDisabled

disableBORecalc

isBORecalcsDisabled

markForSkipClientVerifiesForAdmins

isSkipClientVerifiesForAdmins

markForSkipServerVerifiesForAdmins

isSkipServerVerifiesForAdmins

markForORMScript

isForORMScript

getInstance

getInstance