de.ipcon.db

Class BOSaver

java.lang.Object

de.ipcon.db.BOSaver

All Implemented Interfaces:

SaveBOImplementationI

public class BOSaver
extends java.lang.Object
implements SaveBOImplementationI

This class will be removed at some point, as KernelModule properly uses a ServerLocalTransaction now. FIXME! TH 2022-04-27: instances of this class are created by the following code as of today and should be reworked to use a ServerLocalTransaction instead: /nrx/lu/technofibres/bo/Prozessdokumentversion.nrx /nrx/de/venice/cauldron/start.groovy /nrx/de/venice/cauldron/stop.groovy /nrx/de/venice/instanzen/vapiano/mspos/fstomytism.groovy /nrx/de/venice/instanzen/vapiano/nav/xbkImport.groovy

Constructor Summary

Constructors

Constructor and Description
BOSaver(DBManLocalI _dbm)
BOSaver(DBManLocalI _dbm, Benutzer _user)

Method Summary

Modifier and Type	Method and Description
Transaction	getNewTransaction() Convenience method for getting a new Transaction instance.
Transaction	getNewTransaction(java.lang.String desc) Convenience method for getting a new Transaction instance.
SchemaI	getSchema() Convenience method for getting the current SchemaI.
boolean	isStubCloneOnSave()
TransactionAnswer	saveBO(Transaction tx) Saves (the BOs of) a Transaction.
TransactionAnswer	saveBO(Transaction tx, boolean ignoreConflicts)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, boolean ignoreConflicts)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, boolean ignoreConflicts, Benutzer onBehalfOf)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, SaveBOListenerI sbl) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, SaveBOListenerI sbl, boolean ignoreConflicts)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, SaveBOListenerI sbl, boolean ignoreConflicts, int lockTimeout)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, SaveBOListenerI sbl, boolean ignoreConflicts, int lockTimeout, int retries)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI sbi, SaveBOListenerI sbl, boolean ignoreConflicts, int lockTimeout, int retries, Benutzer onBehalfOf)
TransactionAnswer	saveBOImpl(Transaction tx) Persists the changes recorded in the passed Transaction tx to the database.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout) Persists the changes recorded in the passed Transaction tx to the database.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout, int retries) Persists the changes recorded in the passed Transaction tx to the database.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout, int retries, Benutzer onBehalfOf) Persists the changes recorded in the passed Transaction tx to the database.
void	setStubCloneOnSave(boolean $13)

Methods inherited from class java.lang.Object

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

Constructor Detail

BOSaver

public BOSaver(DBManLocalI _dbm)

BOSaver

public BOSaver(DBManLocalI _dbm,
               Benutzer _user)

Method Detail

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       boolean ignoreConflicts)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       boolean ignoreConflicts,
                                       Benutzer onBehalfOf)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       SaveBOListenerI sbl)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       SaveBOListenerI sbl,
                                       boolean ignoreConflicts)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       SaveBOListenerI sbl,
                                       boolean ignoreConflicts,
                                       int lockTimeout)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       SaveBOListenerI sbl,
                                       boolean ignoreConflicts,
                                       int lockTimeout,
                                       int retries)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI sbi,
                                       SaveBOListenerI sbl,
                                       boolean ignoreConflicts,
                                       int lockTimeout,
                                       int retries,
                                       Benutzer onBehalfOf)
                                throws TransactionConflictException

Throws:

TransactionConflictException

getNewTransaction

public Transaction getNewTransaction()

Description copied from interface: SaveBOImplementationI

Convenience method for getting a new Transaction instance.

Specified by:

getNewTransaction in interface SaveBOImplementationI

Returns:

A new Transaction instance having the DBManLocalI of this BOSaver as loader.

getNewTransaction

public Transaction getNewTransaction(java.lang.String desc)

Description copied from interface: SaveBOImplementationI

Convenience method for getting a new Transaction instance.

Specified by:

getNewTransaction in interface SaveBOImplementationI

Parameters:

desc - the description to use for the new Transaction

Returns:

A new Transaction instance having the DBManLocalI of this BOSaver as loader.

getSchema

public SchemaI getSchema()

Description copied from interface: SaveBOImplementationI

Convenience method for getting the current SchemaI.

Specified by:

getSchema in interface SaveBOImplementationI

Returns:

the current SchemaI.

saveBO

public TransactionAnswer saveBO(Transaction tx)
                         throws TransactionConflictException

Saves (the BOs of) a Transaction.

Does some stuff normally done by the *Clients but we have to do it ourselves because we're using the "low-level" DBManLocalI.

Throws:

TransactionConflictException

saveBO

public TransactionAnswer saveBO(Transaction tx,
                                boolean ignoreConflicts)
                         throws TransactionConflictException

Throws:

TransactionConflictException

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx)

Description copied from interface: SaveBOImplementationI

Persists the changes recorded in the passed Transaction tx to the database.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction to save

Returns:

the TransactionAnswer resulting from the save process, or null if no saving was actually done for some reason

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx,
                                    int lockTimeout)

Description copied from interface: SaveBOImplementationI

Persists the changes recorded in the passed Transaction tx to the database.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction to save

lockTimeout - time to wait in seconds until a locking error is reported in case some object is already locked by another thread; defaults to -1. Zero or less for no waiting, i.e. immediate timeout (or rather the defined lock-timeout of JDO, which defaults to 30s), an infinite value for no timeout.

Returns:

the TransactionAnswer resulting from the save process, or null if no saving was actually done for some reason

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx,
                                    int lockTimeout,
                                    int retries)

Description copied from interface: SaveBOImplementationI

Persists the changes recorded in the passed Transaction tx to the database.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction to save

lockTimeout - time to wait in seconds until a locking error is reported in case some object is already locked by another thread; defaults to -1. Zero or less for no waiting, i.e. immediate timeout (or rather the defined lock-timeout of JDO, which defaults to 30s), an infinite value for no timeout.

retries - an int reflecting the number of retries that shall be attempted before saving is aborted

Returns:

the TransactionAnswer resulting from the save process, or null if no saving was actually done for some reason

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx,
                                    int lockTimeout,
                                    int retries,
                                    Benutzer onBehalfOf)

Description copied from interface: SaveBOImplementationI

Persists the changes recorded in the passed Transaction tx to the database.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction to save

lockTimeout - time to wait in seconds until a locking error is reported in case some object is already locked by another thread; defaults to -1. Zero or less for no waiting, i.e. immediate timeout (or rather the defined lock-timeout of JDO, which defaults to 30s), an infinite value for no timeout.

retries - an int reflecting the number of retries that shall be attempted before saving is aborted

onBehalfOf - the Benutzer on whose behalf to save

Returns:

the TransactionAnswer resulting from the save process, or null if no saving was actually done for some reason

isStubCloneOnSave

public boolean isStubCloneOnSave()

setStubCloneOnSave

public void setStubCloneOnSave(boolean $13)