de.ipcon.form

Class LRUTrackerForTemplate

java.lang.Object

de.ipcon.form.LRUTrackerForTemplate

All Implemented Interfaces:

FormContextListenerI

public class LRUTrackerForTemplate
extends java.lang.Object
implements FormContextListenerI

One-shot lifecycle listener that records Least Recently Used (LRU) access in the client context upon the initial save of a business object (BO) created from a template.

Exclusively used when a form is opened with view type MDIManagerI.VIEWTYPE_SCHABLONE (Schablone). While existing persisted BOs are tracked immediately upon opening, templated BOs defer LRU tracking until their first successful persistence.

This listener automatically unregisters itself from the FormContextI during onAfterSave() to prevent redundant tracking and avoid memory leaks.

Method Summary

Modifier and Type	Method and Description
static LRUTrackerForTemplate	attach(FormContextI ftx, Formular form) Convenience factory method to instantiate and register the tracker on the context.
void	onAfterSave() Records the LRU entry using the committed BO state and unregisters this listener from the context.
void	onBeforeSave() Invoked during FormContextI#beforeSave to prepare the form context prior to persistence.
void	onRefresh() Invoked during FormContextI#refreshForm to update the UI components from the underlying model.
void	onSaveInitiated() Invoked during FormContextI#saveFormData at the initial stage of the persistence workflow.
void	onSync() Invoked during FormContextI#sync to synchronize UI form data with the underlying model.

Methods inherited from class java.lang.Object

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

Method Detail

attach

public static LRUTrackerForTemplate attach(FormContextI ftx,
                                           Formular form)

Convenience factory method to instantiate and register the tracker on the context.

Parameters:

ftx - the form context to listen to

form - the form descriptor being tracked

Returns:

the registered tracker instance

onSync

public void onSync()

Description copied from interface: FormContextListenerI

Invoked during FormContextI#sync to synchronize UI form data with the underlying model.

Called prior to FormElementI#sync, before synchronization cascades to subcontexts, and before any onSync scripts execute.

Specified by:

onSync in interface FormContextListenerI

onRefresh

public void onRefresh()

Description copied from interface: FormContextListenerI

Invoked during FormContextI#refreshForm to update the UI components from the underlying model.

Called before FormElementI#refresh, before an optional call to FormContextI#refreshView, and before any onRefresh scripts execute.

Specified by:

onRefresh in interface FormContextListenerI

onBeforeSave

public void onBeforeSave()

Description copied from interface: FormContextListenerI

Invoked during FormContextI#beforeSave to prepare the form context prior to persistence.

Called before FormElementI#beforeSave, before #beforeSave cascades to subcontexts, and before any onBeforeSave scripts execute.

Specified by:

onBeforeSave in interface FormContextListenerI

onSaveInitiated

public void onSaveInitiated()

Description copied from interface: FormContextListenerI

Invoked during FormContextI#saveFormData at the initial stage of the persistence workflow.

Called before FormContextI#beforeSave executes and before the included business objects are saved via FormContextI#saveBO or FormContextSaveHandler#saveBO.

Specified by:

onSaveInitiated in interface FormContextListenerI

onAfterSave

public void onAfterSave()

Records the LRU entry using the committed BO state and unregisters this listener from the context.

Specified by:

onAfterSave in interface FormContextListenerI