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/ch/vaproman/cauldron/start.groovy (and the other instances like lu/fiveguys etc.) /nrx/ch/vaproman/cauldron/stop.groovy (and the other instances like lu/fiveguys etc.)

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Transaction	getNewTransaction() Creates and initializes a new empty Transaction bound to this persistence provider.
Transaction	getNewTransaction(java.lang.String desc) Creates and initializes a new empty Transaction with a descriptive label.
SchemaI	getSchema() Returns the active database schema definition associated with this persistence provider.
boolean	isStubCloneOnSave()
TransactionAnswer	saveBO(Transaction tx) Saves (the BOs of) a Transaction.
TransactionAnswer	saveBO(Transaction tx, boolean ignoreConflicts) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, boolean ignoreConflicts)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, boolean ignoreConflicts, Benutzer onBehalfOf)
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, de.ipcon.db.core.SaveBOListenerI saveBOListener) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, de.ipcon.db.core.SaveBOListenerI saveBOListener, boolean ignoreConflicts) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, de.ipcon.db.core.SaveBOListenerI saveBOListener, boolean ignoreConflicts, int lockTimeout) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, de.ipcon.db.core.SaveBOListenerI saveBOListener, boolean ignoreConflicts, int lockTimeout, int retries) Saves (the BOs of) a Transaction.
static TransactionAnswer	saveBO(Transaction tx, SaveBOImplementationI saveBOImpl, de.ipcon.db.core.SaveBOListenerI saveBOListener, boolean ignoreConflicts, int lockTimeout, int retries, Benutzer onBehalfOf) Saves (the BOs of) a Transaction.
TransactionAnswer	saveBOImpl(Transaction tx) Persists all modifications recorded within the specified transaction using default lock timeouts and retry policies.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout) Persists all modifications recorded within the specified transaction using default retry policies.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout, int retries) Persists all modifications recorded within the specified transaction, using default user credentials.
TransactionAnswer	saveBOImpl(Transaction tx, int lockTimeout, int retries, Benutzer onBehalfOf) Persists all modifications recorded within the specified transaction to the database, executing on behalf of an explicit user.
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 saveBOImpl)
                                throws TransactionConflictException

Throws:

TransactionConflictException

saveBO

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

Throws:

TransactionConflictException

saveBO

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

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI saveBOImpl,
                                       de.ipcon.db.core.SaveBOListenerI saveBOListener)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI saveBOImpl,
                                       de.ipcon.db.core.SaveBOListenerI saveBOListener,
                                       boolean ignoreConflicts)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI saveBOImpl,
                                       de.ipcon.db.core.SaveBOListenerI saveBOListener,
                                       boolean ignoreConflicts,
                                       int lockTimeout)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI saveBOImpl,
                                       de.ipcon.db.core.SaveBOListenerI saveBOListener,
                                       boolean ignoreConflicts,
                                       int lockTimeout,
                                       int retries)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

saveBO

public static TransactionAnswer saveBO(Transaction tx,
                                       SaveBOImplementationI saveBOImpl,
                                       de.ipcon.db.core.SaveBOListenerI saveBOListener,
                                       boolean ignoreConflicts,
                                       int lockTimeout,
                                       int retries,
                                       Benutzer onBehalfOf)
                                throws TransactionConflictException

Saves (the BOs of) a Transaction.

Throws:

TransactionConflictException

getNewTransaction

public Transaction getNewTransaction()

Description copied from interface: SaveBOImplementationI

Creates and initializes a new empty Transaction bound to this persistence provider.

Specified by:

getNewTransaction in interface SaveBOImplementationI

Returns:

a new active Transaction instance

getNewTransaction

public Transaction getNewTransaction(java.lang.String desc)

Description copied from interface: SaveBOImplementationI

Creates and initializes a new empty Transaction with a descriptive label.

Specified by:

getNewTransaction in interface SaveBOImplementationI

Parameters:

desc - an optional diagnostic label or audit description for the transaction

Returns:

a new active Transaction instance

getSchema

public SchemaI getSchema()

Description copied from interface: SaveBOImplementationI

Returns the active database schema definition associated with this persistence provider.

Specified by:

getSchema in interface SaveBOImplementationI

Returns:

the current SchemaI metadata instance

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

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

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx)

Description copied from interface: SaveBOImplementationI

Persists all modifications recorded within the specified transaction using default lock timeouts and retry policies.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction containing modified, inserted, or deleted business objects

Returns:

the TransactionAnswer containing execution results, or null if bypassed

See Also:

SaveBOImplementationI.saveBOImpl(Transaction, int, int, Benutzer)

saveBOImpl

public TransactionAnswer saveBOImpl(Transaction tx,
                                    int lockTimeout)

Description copied from interface: SaveBOImplementationI

Persists all modifications recorded within the specified transaction using default retry policies.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction containing modified, inserted, or deleted business objects

lockTimeout - timeout duration in seconds when waiting for locked database records; 0 indicates no timeout (wait indefinitely), values > 0 specify an explicit duration in seconds, and values < 0 retain the underlying persistence layer's default timeout (30 seconds)

Returns:

the TransactionAnswer containing execution results, or null if bypassed

See Also:

SaveBOImplementationI.saveBOImpl(Transaction, int, int, Benutzer)

saveBOImpl

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

Description copied from interface: SaveBOImplementationI

Persists all modifications recorded within the specified transaction, using default user credentials.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction containing modified, inserted, or deleted business objects

lockTimeout - timeout duration in seconds when waiting for locked database records; 0 indicates no timeout (wait indefinitely), values > 0 specify an explicit duration in seconds, and values < 0 retain the underlying persistence layer's default timeout (30 seconds)

retries - the maximum number of retry attempts before aborting

Returns:

the TransactionAnswer containing execution results, or null if bypassed

See Also:

SaveBOImplementationI.saveBOImpl(Transaction, int, int, Benutzer)

saveBOImpl

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

Description copied from interface: SaveBOImplementationI

Persists all modifications recorded within the specified transaction to the database, executing on behalf of an explicit user.

Specified by:

saveBOImpl in interface SaveBOImplementationI

Parameters:

tx - the Transaction containing modified, inserted, or deleted business objects

lockTimeout - timeout duration in seconds when waiting for locked database records; 0 indicates no timeout (wait indefinitely), values > 0 specify an explicit duration in seconds, and values < 0 retain the underlying persistence layer's default timeout (30 seconds)

retries - the maximum number of retry attempts upon transient lock contention or serialization failures before aborting

onBehalfOf - the Benutzer whose authorization and audit identity govern this commit operation, or null to use the default session user

Returns:

the TransactionAnswer containing execution results, conflict details, and ID mappings; or null if persistence was bypassed

isStubCloneOnSave

public boolean isStubCloneOnSave()

setStubCloneOnSave

public void setStubCloneOnSave(boolean $13)