de.ipcon.db

Interface SaveBOImplementationI

All Known Implementing Classes:

BOSaver, ServerAccessGateway

public interface SaveBOImplementationI

Service Provider Interface (SPI) defining low-level persistence operations for units of work.

Implemented by database coordinators and server gateways (such as ServerAccessGateway or local persistence managers) to execute the physical commit of recorded modifications within a Transaction, handle optimistic/pessimistic lock retries, and provide access to schema metadata and transaction factory methods.

See Also:

Transaction, TransactionAnswer, SaveBOListenerI

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.
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.

Method Detail

saveBOImpl

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.

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

saveBOImpl

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

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

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:

saveBOImpl(Transaction, int, int, Benutzer)

saveBOImpl

TransactionAnswer saveBOImpl(Transaction tx,
                             int lockTimeout)

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

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:

saveBOImpl(Transaction, int, int, Benutzer)

saveBOImpl

TransactionAnswer saveBOImpl(Transaction tx)

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

Parameters:

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

Returns:

the TransactionAnswer containing execution results, or null if bypassed

See Also:

saveBOImpl(Transaction, int, int, Benutzer)

getNewTransaction

Transaction getNewTransaction()

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

Returns:

a new active Transaction instance

getNewTransaction

Transaction getNewTransaction(java.lang.String desc)

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

Parameters:

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

Returns:

a new active Transaction instance

getSchema

SchemaI getSchema()

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

Returns:

the current SchemaI metadata instance