de.ipcon.gui

Class ClientPersistenceHelper

java.lang.Object

de.ipcon.gui.AbstractClientHelper

de.ipcon.gui.ClientPersistenceHelper

All Implemented Interfaces:

de.ipcon.db.core.SaveBOListenerI, de.ipcon.db.core.TransactionBuilderI, de.ipcon.db.core.TransactionProviderI, FormTransactionBuilderI, java.io.Serializable

public class ClientPersistenceHelper
extends AbstractClientHelper
implements FormTransactionBuilderI, de.ipcon.db.core.TransactionProviderI, de.ipcon.db.core.SaveBOListenerI

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ClientPersistenceHelper(Client _client)

Method Summary

Modifier and Type	Method and Description
void	addSaveBOListener(de.ipcon.db.core.SaveBOListenerI l) Adds the passed SaveBOListenerI to the list of listeners, wrapped in a WeakReference.
void	flushCaches()
BO	getBO(java.lang.Long id, java.lang.Class classTip)
de.ipcon.db.core.CodebausteinStorageI	getCodebausteinStorage() Returns the lazily initialized storage provider for Codebausteine.
FulltextSearcherI	getFulltextSearcher()
Transaction	getNewFormTransaction() Creates an interactive form transaction initialized with the current user.
Transaction	getNewFormTransaction(java.lang.String desc) Creates an interactive form transaction initialized with the current user and an identifying description for auditing and debugging.
Transaction	getNewTransaction()
Transaction	getNewTransaction(BOLoaderI loader, SchemaI txSchema, java.lang.String desc, de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier) Central internal factory method to create and fully initialize a new database transaction.
Transaction	getNewTransaction(java.lang.String desc)
Transaction	getNewTransaction(java.lang.String desc, de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)
Transaction	getNewTransaction(de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)
Transaction	getNewTransactionWithInstrumentedSchema()
Transaction	getNewTransactionWithInstrumentedSchema(java.lang.String desc)
Transaction	getNewTransactionWithInstrumentedSchema(java.lang.String desc, de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)
Transaction	getNewTransactionWithInstrumentedSchema(de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)
StrukturCache	getStrukturCache()
boolean	isMemoryTightClient() Checks non-blockingly whether the client's local persistence and caching layer is operating under memory constraints.
boolean	isNotificationSystemActivated()
java.util.List	queryBO(groovy.lang.GString gs) Executes a database query dynamically constructed via Groovy GString interpolation.
java.util.List	queryBO(java.lang.String query)
java.util.List	queryBO(java.lang.String query, java.lang.Object[] params)
void	removeSaveBOListener(de.ipcon.db.core.SaveBOListenerI l) Removes the passed SaveBOListenerI from the list of listeners.
TransactionAnswer	saveBO(Transaction tx) Convenience overload delegating to saveBO(Transaction, boolean) with ignoreConflicts set to true (last-write-wins) for backwards compatibility.
TransactionAnswer	saveBO(Transaction tx, boolean ignoreConflicts) Coordinates the client-side persistence pipeline: Synchronizes pending EDT events and pauses the transaction message bus.
void	transactionSaveSuccess(Transaction stubTx, java.util.Map<java.lang.Long,java.lang.Long> tempIdToDbIdMap, java.util.function.Predicate<Transaction> isSavedTransactionInstancePredicate) Notifies all registered SaveBOListenerI-s about a successfully saved Transaction via the transactionSaveSuccess-callback.

Methods inherited from class de.ipcon.gui.AbstractClientHelper

client

Methods inherited from class java.lang.Object

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

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

saveWithRetries, saveWithRetries

Constructor Detail

ClientPersistenceHelper

public ClientPersistenceHelper(Client _client)

Method Detail

saveBO

public TransactionAnswer saveBO(Transaction tx)

Convenience overload delegating to saveBO(Transaction, boolean) with ignoreConflicts set to true (last-write-wins) for backwards compatibility.

Specified by:

saveBO in interface de.ipcon.db.core.TransactionProviderI

Parameters:

tx - the transaction to persist; must not be null

Returns:

the TransactionAnswer, or null if tx contained no changes

saveBO

public TransactionAnswer saveBO(Transaction tx,
                                boolean ignoreConflicts)

Coordinates the client-side persistence pipeline:

• Synchronizes pending EDT events and pauses the transaction message bus.
• Acquires an exclusive write lock on tx.
• Executes three-phase client verification hooks (beforeVerifyOnClient, verifyOnClient, afterVerifyOnClient) unless explicitly bypassed or restoring undo state without time-travel.
• Dispatches persistence via BOSaver with up to 5 automatic retries on RepeatableSaveException.
• If ignoreConflicts is false and an optimistic concurrency conflict occurs (mismatched lmod), prompts the user interactively via an EDT dialog to reload, re-apply, or abort changes.

Upon successful persistence, the transaction is committed and deactivated. If persistence fails or conflicts remain unresolved, the transaction remains active and may contain updated lmod timestamps or replayed modifications for subsequent attempts.

Specified by:

saveBO in interface de.ipcon.db.core.TransactionProviderI

Parameters:

tx - transaction to persist; must not be null

ignoreConflicts - if true, server-side optimistic locking conflict detection is bypassed

Returns:

the server TransactionAnswer, or null if no changes were pending

Throws:

TransactionConflictException - if conflicts cannot be resolved interactively

SaveException - if client verification vetoes saving or a fatal storage error occurs

getNewFormTransaction

public Transaction getNewFormTransaction()

Description copied from interface: FormTransactionBuilderI

Creates an interactive form transaction initialized with the current user.

Specified by:

getNewFormTransaction in interface FormTransactionBuilderI

Returns:

a new transaction configured for form execution

getNewFormTransaction

public Transaction getNewFormTransaction(java.lang.String desc)

Description copied from interface: FormTransactionBuilderI

Creates an interactive form transaction initialized with the current user and an identifying description for auditing and debugging.

Specified by:

getNewFormTransaction in interface FormTransactionBuilderI

Parameters:

desc - transaction description; may be null

Returns:

a new transaction configured for form execution

getNewTransaction

public Transaction getNewTransaction()

Specified by:

getNewTransaction in interface de.ipcon.db.core.TransactionBuilderI

getNewTransaction

public Transaction getNewTransaction(java.lang.String desc)

Specified by:

getNewTransaction in interface de.ipcon.db.core.TransactionBuilderI

getNewTransaction

public Transaction getNewTransaction(de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)

Specified by:

getNewTransaction in interface de.ipcon.db.core.TransactionBuilderI

getNewTransaction

public Transaction getNewTransaction(java.lang.String desc,
                                     de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)

Specified by:

getNewTransaction in interface de.ipcon.db.core.TransactionBuilderI

getNewTransactionWithInstrumentedSchema

public Transaction getNewTransactionWithInstrumentedSchema()

Specified by:

getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderI

getNewTransactionWithInstrumentedSchema

public Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc)

Specified by:

getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderI

getNewTransactionWithInstrumentedSchema

public Transaction getNewTransactionWithInstrumentedSchema(de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)

Specified by:

getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderI

getNewTransactionWithInstrumentedSchema

public Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc,
                                                           de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)

Specified by:

getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderI

getNewTransaction

public Transaction getNewTransaction(BOLoaderI loader,
                                     SchemaI txSchema,
                                     java.lang.String desc,
                                     de.ipcon.db.core.TemporaryIdSupplierI tempIdSupplier)

Central internal factory method to create and fully initialize a new database transaction.

Parameters:

loader - The BO loader to use.

txSchema - The schema to use (optional).

desc - A description for the transaction (optional).

tempIdSupplier - A supplier for temporary IDs (optional).

Returns:

The initialized Transaction.

Throws:

java.lang.IllegalStateException - if not connected to a server.

transactionSaveSuccess

public void transactionSaveSuccess(Transaction stubTx,
                                   java.util.Map<java.lang.Long,java.lang.Long> tempIdToDbIdMap,
                                   java.util.function.Predicate<Transaction> isSavedTransactionInstancePredicate)

Notifies all registered SaveBOListenerI-s about a successfully saved Transaction via the transactionSaveSuccess-callback.

Specified by:

transactionSaveSuccess in interface de.ipcon.db.core.SaveBOListenerI

addSaveBOListener

public void addSaveBOListener(de.ipcon.db.core.SaveBOListenerI l)

Adds the passed SaveBOListenerI to the list of listeners, wrapped in a WeakReference.

removeSaveBOListener

public void removeSaveBOListener(de.ipcon.db.core.SaveBOListenerI l)

Removes the passed SaveBOListenerI from the list of listeners.

queryBO

public java.util.List queryBO(groovy.lang.GString gs)

Executes a database query dynamically constructed via Groovy GString interpolation.

Parameters:

gs - The GString query template.

Returns:

A List containing the queried Business Objects (BOs).

queryBO

public java.util.List queryBO(java.lang.String query)

queryBO

public java.util.List queryBO(java.lang.String query,
                              java.lang.Object[] params)

getBO

public BO getBO(java.lang.Long id,
                java.lang.Class classTip)

flushCaches

public void flushCaches()

isMemoryTightClient

public boolean isMemoryTightClient()

Checks non-blockingly whether the client's local persistence and caching layer is operating under memory constraints.

Returns:

true if memory is tight or restricted; false otherwise

isNotificationSystemActivated

public boolean isNotificationSystemActivated()

getFulltextSearcher

public FulltextSearcherI getFulltextSearcher()

getCodebausteinStorage

public de.ipcon.db.core.CodebausteinStorageI getCodebausteinStorage()

Returns the lazily initialized storage provider for Codebausteine.

Returns:

the active CodebausteinStorageI instance

getStrukturCache

public StrukturCache getStrukturCache()