de.ipcon.form

Interface FormContextI

All Known Implementing Classes:

DefaultFormContext

public interface FormContextI

FormContextI ist ein Interface zum Verbinden von Formularen (welcher Art auch immer) mit den zugehoerigen Datenobjekten. Diese Kontexte koennen hierarchisch miteinander verbunden werden, um komplexe Datenverbindung darstellen zu koennen (fuer echte Subformulare in eigenen Fenstern zum Beispiel).

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	$0

Method Summary

Modifier and Type	Method and Description
void	addFormContextListener(FormContextListenerI l)
void	addSubContext(FormContextI a)
void	afterSave()
void	appendThisAndAllSubContexts(java.util.List l)
void	beforeSave()
boolean	boWasChangedExternally()
VisibilityI	cacheVisibility(VisibilityI v)
void	clearCachedVisibility()
void	clearTransaction()
void	close()
FormContextI	createSubFormContext()
void	disableConflictCheckDuringSave() Don't ignore conflicts during saving anymore if previously enabled.
void	enableConflictCheckDuringSave() Registers a default FormContextSaveHandlerI that doesn't ignore conflicts during saving.
java.util.LinkedHashMap	getAllActionsOfKind(int kind)
FormElementI	getAt(java.lang.String n)
Transaction.Savepoint	getBeforeUserChangesSavepoint()
BO	getBO()
BO	getBO(boolean _synchronized)
BOLoaderI	getBOLoader()
BO[]	getBOs()
ClientContextI	getCtx()
DBManEventProviderI	getEventProvider()
FormElementI	getFormElement()
default javax.swing.ImageIcon	getIcon(java.lang.String name)
default javax.swing.ImageIcon	getIcon(java.lang.String name, java.awt.Color color)
default javax.swing.ImageIcon	getIcon(java.lang.String name, java.awt.Color color, boolean allowUnderlay)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context, java.awt.Color color)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context, java.awt.Color color, boolean allowUnderlay)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context, java.lang.String configuration)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context, java.lang.String configuration, java.awt.Color color)
default javax.swing.ImageIcon	getIcon(java.lang.String name, de.ipcon.swing.IconDisplayContext context, java.lang.String configuration, java.awt.Color color, boolean allowUnderlay)
default javax.swing.ImageIcon	getIcon(java.lang.String name, java.lang.String configuration)
default javax.swing.ImageIcon	getIcon(java.lang.String name, java.lang.String configuration, java.awt.Color color)
default javax.swing.ImageIcon	getIcon(java.lang.String name, java.lang.String configuration, java.awt.Color color, boolean allowUnderlay)
java.awt.Component	getIconContextObject()
javax.swing.JRootPane	getJRootPane()
EntityI	getLowestCommonDenominateEntity()
FormElementI	getNamedElement(java.lang.String n)
FormContextI	getParent()
java.lang.String	getPath()
void	getPath(java.lang.StringBuilder s)
FormContextI	getRoot()
javax.swing.RootPaneContainer	getRootPaneContainer()
FormContextSaveHandlerI	getSaveHandler()
BeanShellScript	getScript()
java.util.Map	getScriptParameters()
java.util.List	getSubContexts()
java.util.Iterator	getSubContextsIterator()
FormContextI[]	getThisAndAllSubContextsAsArray()
Transaction	getTransaction()
VisibilityI	getVisibility()
boolean	hasCachedVisibility()
boolean	hasScript()
boolean	hasUnsavedFormData()
boolean	hasUnsavedUserData()
void	initScript()
void	invalidateAllSubContextsCache()
boolean	isClosed()
boolean	isRoot()
boolean	isSyncEventHandlingPaused() If true, then {link #sync()} calls for this element should be ignored, e.g. because the form is currently saving.
void	mdiActivate(MDIElementI me)
void	mdiClose(MDIElementI me)
void	mdiDeactivate(MDIElementI me)
void	mdiOpen(MDIElementI me)
boolean	pauseFiringNewProcs() Creates a token to pause updating the GUI with changes in the Transaction for a while.
void	refreshBO(FormContextI _realFtx, java.lang.String _propertyname, boolean _transactionControl, boolean _autoCreate, electric.xml.Element _confRoot)
void	refreshForms() Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.
void	refreshForms(boolean forceRefreshRelation) Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.
void	refreshForms(boolean forceRefreshRelation, int from) Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.
void	refreshForms(boolean forceRefreshRelation, int from, long onlyBOId) Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.
void	refreshForms(boolean forceRefreshRelation, int from, long onlyBOId, long ifNotSince) Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.
void	refreshView() Only refreshes the window titles and other 'outside' stuff, not the form itself or parts of it.
void	removeAllFormContextListeners()
void	removeFormContextListener(FormContextListenerI l)
void	removeSubContext(FormContextI a)
void	resetBOWasChangedExternally()
boolean	resumeFiringNewProcs() Resumes updates to the GUI after a previous call of pauseFiringNewProcs(), unless updates are inh, due to changes in the Transaction for a while.
boolean	saveFormData()
boolean	saveFormData(boolean willCloseRightAfter)
void	setBeforeUserChangesSavepoint(Transaction.Savepoint _sp)
boolean	setBO(BO bo)
void	setBOLoader(BOLoaderI bol)
void	setEditable(boolean b)
void	setEditable(boolean b, boolean dontRefresh)
void	setFormElement(FormElementI j)
void	setJRootPane(javax.swing.JRootPane rp)
void	setLowestCommonDenominateEntity(EntityI ent)
void	setNamedElement(java.lang.String n, FormElementI e)
void	setParent(FormContextI a)
void	setRootPaneContainer(javax.swing.RootPaneContainer rpc)
void	setSaveHandler(FormContextSaveHandlerI sh)
void	setScript(BeanShellScript b)
void	setScriptParameters(java.util.Map m)
void	setTransaction(Transaction tx)
void	setVisibilityTransient()
void	startListeningNewProcs() internal
void	sync() Synchronize the data of the form and the model
void	toast(java.lang.String text)
void	toast(java.lang.String text, int delay)
void	toastError(java.lang.String text)
void	toastError(java.lang.String text, int delay)
boolean	tryFocus()

Field Detail

$0

static final java.lang.String $0

See Also:

Constant Field Values

Method Detail

getCtx

ClientContextI getCtx()

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      java.awt.Color color)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      java.awt.Color color,
                                      boolean allowUnderlay)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context,
                                      java.awt.Color color)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context,
                                      java.awt.Color color,
                                      boolean allowUnderlay)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      java.lang.String configuration)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      java.lang.String configuration,
                                      java.awt.Color color)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      java.lang.String configuration,
                                      java.awt.Color color,
                                      boolean allowUnderlay)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context,
                                      java.lang.String configuration)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context,
                                      java.lang.String configuration,
                                      java.awt.Color color)

getIcon

default javax.swing.ImageIcon getIcon(java.lang.String name,
                                      de.ipcon.swing.IconDisplayContext context,
                                      java.lang.String configuration,
                                      java.awt.Color color,
                                      boolean allowUnderlay)

getIconContextObject

java.awt.Component getIconContextObject()

getParent

FormContextI getParent()

setParent

void setParent(FormContextI a)

isRoot

boolean isRoot()

getRoot

FormContextI getRoot()

getPath

java.lang.String getPath()

getPath

void getPath(java.lang.StringBuilder s)

getNamedElement

FormElementI getNamedElement(java.lang.String n)

setNamedElement

void setNamedElement(java.lang.String n,
                     FormElementI e)

getAt

FormElementI getAt(java.lang.String n)

createSubFormContext

FormContextI createSubFormContext()

addSubContext

void addSubContext(FormContextI a)

removeSubContext

void removeSubContext(FormContextI a)

getSubContexts

java.util.List getSubContexts()

getSubContextsIterator

java.util.Iterator getSubContextsIterator()

getThisAndAllSubContextsAsArray

FormContextI[] getThisAndAllSubContextsAsArray()

appendThisAndAllSubContexts

void appendThisAndAllSubContexts(java.util.List l)

invalidateAllSubContextsCache

void invalidateAllSubContextsCache()

getLowestCommonDenominateEntity

EntityI getLowestCommonDenominateEntity()

setLowestCommonDenominateEntity

void setLowestCommonDenominateEntity(EntityI ent)

getBO

BO getBO()

getBO

BO getBO(boolean _synchronized)

setBO

boolean setBO(BO bo)

getBOs

BO[] getBOs()

setEditable

void setEditable(boolean b)

setEditable

void setEditable(boolean b,
                 boolean dontRefresh)

getJRootPane

javax.swing.JRootPane getJRootPane()

setJRootPane

void setJRootPane(javax.swing.JRootPane rp)

setRootPaneContainer

void setRootPaneContainer(javax.swing.RootPaneContainer rpc)

getRootPaneContainer

javax.swing.RootPaneContainer getRootPaneContainer()

setFormElement

void setFormElement(FormElementI j)

getFormElement

FormElementI getFormElement()

cacheVisibility

VisibilityI cacheVisibility(VisibilityI v)

setVisibilityTransient

void setVisibilityTransient()

hasCachedVisibility

boolean hasCachedVisibility()

getVisibility

VisibilityI getVisibility()

clearCachedVisibility

void clearCachedVisibility()

mdiOpen

void mdiOpen(MDIElementI me)

mdiClose

void mdiClose(MDIElementI me)

mdiActivate

void mdiActivate(MDIElementI me)

mdiDeactivate

void mdiDeactivate(MDIElementI me)

getAllActionsOfKind

java.util.LinkedHashMap getAllActionsOfKind(int kind)

initScript

void initScript()

setScript

void setScript(BeanShellScript b)

getScript

BeanShellScript getScript()

hasScript

boolean hasScript()

setScriptParameters

void setScriptParameters(java.util.Map m)

getScriptParameters

java.util.Map getScriptParameters()

setTransaction

void setTransaction(Transaction tx)

getTransaction

Transaction getTransaction()

clearTransaction

void clearTransaction()

setBOLoader

void setBOLoader(BOLoaderI bol)

getBOLoader

BOLoaderI getBOLoader()

pauseFiringNewProcs

boolean pauseFiringNewProcs()

Creates a token to pause updating the GUI with changes in the Transaction for a while. If returned true, then a later call of resumeFiringNewProcs() is necessary.

Returns:

true if a transaction was available and the call to this method had any effect.

resumeFiringNewProcs

boolean resumeFiringNewProcs()

Resumes updates to the GUI after a previous call of pauseFiringNewProcs(), unless updates are inh, due to changes in the Transaction for a while. Preceeded by a previous call to pauseFireNewProcs()

Returns:

true if a transaction was available and the call to this method had any effect.

startListeningNewProcs

void startListeningNewProcs()

internal

getSaveHandler

FormContextSaveHandlerI getSaveHandler()

setSaveHandler

void setSaveHandler(FormContextSaveHandlerI sh)

hasUnsavedFormData

boolean hasUnsavedFormData()

hasUnsavedUserData

boolean hasUnsavedUserData()

boWasChangedExternally

boolean boWasChangedExternally()

resetBOWasChangedExternally

void resetBOWasChangedExternally()

sync

void sync()

Synchronize the data of the form and the model

isSyncEventHandlingPaused

boolean isSyncEventHandlingPaused()

If true, then {link #sync()} calls for this element should be ignored, e.g. because the form is currently saving. Can be disabled for all elements on the root context

beforeSave

void beforeSave()

afterSave

void afterSave()

saveFormData

boolean saveFormData(boolean willCloseRightAfter)

Returns:

true if save proceeded normally, false if there was a conflict and automatic retries should be prevented, even if the transaction is still active.

saveFormData

boolean saveFormData()

See Also:

with parameter false

enableConflictCheckDuringSave

void enableConflictCheckDuringSave()

Registers a default FormContextSaveHandlerI that doesn't ignore conflicts during saving. Activate ins forms with

[Tabbed]View conflictPolicy="ASK"

disableConflictCheckDuringSave

void disableConflictCheckDuringSave()

Don't ignore conflicts during saving anymore if previously enabled. Throws exception if the current savehandler is not the expected one.

refreshView

void refreshView()

Only refreshes the window titles and other 'outside' stuff, not the form itself or parts of it. Basically only part of the API because of internal reasons (the MDIManager needs access).

refreshForms

void refreshForms()

Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.

refreshForms

void refreshForms(boolean forceRefreshRelation)

Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.

Parameters:

forceRefreshRelation - a boolean which if passed as true forces tables representing a relation to be refreshed if the displayed values do not match the current contents of the displayed relation anymore. Defaults to false.

refreshForms

void refreshForms(boolean forceRefreshRelation,
                  int from)

Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.

Parameters:

forceRefreshRelation - a boolean which if passed as true forces tables representing a relation to be refreshed if the displayed values do not match the current contents of the displayed relation anymore. Defaults to false.

from - an int representing the source of the refreshForms request; may be one of FormElementI.REFRESH_FROM_USER or FormElementI.REFRESH_FROM_TRANSACTION; defaults to FormElementI.REFRESH_FROM_USER

refreshForms

void refreshForms(boolean forceRefreshRelation,
                  int from,
                  long onlyBOId)

Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.

Parameters:

forceRefreshRelation - a boolean which if passed as true forces tables representing a relation to be refreshed if the displayed values do not match the current contents of the displayed relation anymore. Defaults to false.

from - an int representing the source of the refreshForms request; may be one of FormElementI.REFRESH_FROM_USER or FormElementI.REFRESH_FROM_TRANSACTION; defaults to FormElementI.REFRESH_FROM_USER

onlyBOId - a long, if specified and positive, the refresh will only be done for the BO having the given Id

refreshForms

void refreshForms(boolean forceRefreshRelation,
                  int from,
                  long onlyBOId,
                  long ifNotSince)

Refreshes the form-parts that belong to this FormContextI and all subforms that belong to any subcontext of this FormContextI.

Parameters:

forceRefreshRelation - a boolean which if passed as true forces tables representing a relation to be refreshed if the displayed values do not match the current contents of the displayed relation anymore. Defaults to false.

from - an int representing the source of the refreshForms request; may be one of FormElementI.REFRESH_FROM_USER or FormElementI.REFRESH_FROM_TRANSACTION; defaults to FormElementI.REFRESH_FROM_USER

onlyBOId - a long, if specified and positive, the refresh will only be done for the BO having the given Id; defaults to 0

ifNotSince - a long specifying a point in time (in millis since epoch) that is taken into account for deciding if a refresh should take place or not: a refresh will only be done if the internally stored last refresh time is earlier/smaller than the given time; defaults to System.currentTimeMillis()

tryFocus

boolean tryFocus()

close

void close()

isClosed

boolean isClosed()

addFormContextListener

void addFormContextListener(FormContextListenerI l)

removeFormContextListener

void removeFormContextListener(FormContextListenerI l)

removeAllFormContextListeners

void removeAllFormContextListeners()

getEventProvider

DBManEventProviderI getEventProvider()

getBeforeUserChangesSavepoint

Transaction.Savepoint getBeforeUserChangesSavepoint()

setBeforeUserChangesSavepoint

void setBeforeUserChangesSavepoint(Transaction.Savepoint _sp)

refreshBO

void refreshBO(FormContextI _realFtx,
               java.lang.String _propertyname,
               boolean _transactionControl,
               boolean _autoCreate,
               electric.xml.Element _confRoot)

toastError

void toastError(java.lang.String text,
                int delay)

toastError

void toastError(java.lang.String text)

toast

void toast(java.lang.String text,
           int delay)

toast

void toast(java.lang.String text)