de.must.appletserver

Class DataList

java.lang.Object

de.must.appletserver.RemoteElement

de.must.appletserver.DataList

All Implemented Interfaces:

AppletTalker, Remotable, RemoteContent, Storable, DataChangeListener, Exemptible, ExemptibleManager

public class DataList
extends RemoteElement
implements Storable, DataChangeListener

Component to sub-select sub-items of an entity. Registered data components will be reloaded, when the selection changes.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	buildDone

Fields inherited from class de.must.appletserver.RemoteElement

context, editable, enabled, lastEditability, lastVisibility, name, nonstandardPanel, nonstandardPosition, sessionData, toolTipText, visible

Constructor Summary

Constructors

Constructor and Description
DataList(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName) Constructs a new data list.
DataList(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName, java.lang.String orderBy) Constructs a new data list.

Method Summary

Modifier and Type	Method and Description
void	buildRemoteView(ToAppletWriter out) Build remote view.
void	dataChangePerformed(DataChangedEvent e) Called from data objects when data have been changed.
void	destroy() Don't wait until garbage collector removed weak reference.
void	fetchValuesFromRequest(GeneralizedRequest request)
void	free() Releases external resources.
DataObject	getAssignedDataObject() Returns the assigned data object.
java.util.Vector<Identifier>	getContextMenuIds(GeneralizedRequest request)
Identifier	getIdentifierOfIndex(int index)
int	getIndexOfIdentifier(Identifier identifier)
int	getItemCount()
Identifier	getSelectedIdentifier()
int	getSize()
DataObject	getSourceDataObject() Returns the content data object.
java.lang.String	getVisibleColumnName() Returns the visible column name.
boolean	isContentValid() Indicates whether the component's value is valid.
boolean	isFilled() Indicates whether the component has a value.
boolean	isModified() Indicates whether the component's value differs from its initial value.
boolean	isRequirementUnfulfilled() Indicates whether the component's value is mandatory but not filled.
boolean	isToSave()
boolean	isValid() Returns true if the component's value is valid.
void	loadValue() Loads the component's database stored value.
void	loadValue(Identifier identifierToSelect)
void	requestFocusInWindow() Set focus on the receiving component if isRequestFocusEnabled returns true.
void	saveValue() Stores the component's value.
void	selectAll() Selects all input of the component, if it is supported - e.g. in JTextField.
void	setDataComponents(java.util.Vector<Storable> storables) Assigns the components to be dependent on this data list.
void	setEditable(boolean editable) Sets the flag that determines whether or not this component is editable.
void	setPresentables(LoadableRemoteContent[] newPresentables) Assigns the presentables to be dependent on this data list.
void	setRequired(boolean required) Sets the fact that user input is requested (mandatory)
void	setSelected(Identifier identifier) Called when list selection changes to refresh registered dependent data components to reload themselves.
void	setSelectedIndex(int index)
void	setToolTipText(java.lang.String toolTipText) Sets the component's tool tip text.
void	setValues(ToAppletWriter out)
void	setVisibleColumnName(java.lang.String visibleColumnName) Sets the visible column name.

Methods inherited from class de.must.appletserver.RemoteElement

beginAction, endAction, getContext, getName, getTranslation, isEnabled, isVisible, register, resetLastStatus, setEnabled, setVisible

Methods inherited from class java.lang.Object

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

Field Detail

buildDone

protected boolean buildDone

Constructor Detail

DataList

public DataList(SessionData sessionData,
                DataObject assignedDataObject,
                java.lang.String assignedColumnName,
                DataObject sourceDataObject,
                java.lang.String visibleColumnName)

Constructs a new data list.

Parameters:

assignedDataObject - the data object to trigger the selection

assignedColumnName - the name of the column the text field is to assign to

sourceDataObject - the source data object

visibleColumnName - the visible column name

DataList

public DataList(SessionData sessionData,
                DataObject assignedDataObject,
                java.lang.String assignedColumnName,
                DataObject sourceDataObject,
                java.lang.String visibleColumnName,
                java.lang.String orderBy)

Constructs a new data list.

Parameters:

assignedDataObject - the data object to trigger the selection

assignedColumnName - the name of the column the text field is to assign to

sourceDataObject - the source data object

visibleColumnName - the visible column name

orderBy - the sorting column name of the content data object

Method Detail

getAssignedDataObject

public DataObject getAssignedDataObject()

Returns the assigned data object.

Specified by:

getAssignedDataObject in interface Storable

Returns:

the assigned data object

getSourceDataObject

public DataObject getSourceDataObject()

Returns the content data object.

Returns:

the content data object

setEditable

public void setEditable(boolean editable)

Sets the flag that determines whether or not this component is editable. If the flag is set to true, this component becomes user editable. If the flag is set to false, the cannot change the text of this text component.

Overrides:

setEditable in class RemoteElement

Parameters:

editable - a flag indicating whether this component should be user editable

See Also:

#setEditableForUserTyping

isContentValid

public boolean isContentValid()

Indicates whether the component's value is valid.

Returns:

true if the component's value is valid

selectAll

public void selectAll()

Selects all input of the component, if it is supported - e.g. in JTextField. Allows easy new input, because the previous value is reset when the first key stroke occurs.

Specified by:

selectAll in interface RemoteContent

Overrides:

selectAll in class RemoteElement

setDataComponents

public void setDataComponents(java.util.Vector<Storable> storables)

Assigns the components to be dependent on this data list.

Parameters:

storables - the components to be dependent on this data list

setPresentables

public void setPresentables(LoadableRemoteContent[] newPresentables)

Assigns the presentables to be dependent on this data list. All these presentables will be asked to load their values as soon as the list's selection changes.

Parameters:

newPresentables - the presentables to be dependent on this data list

setVisibleColumnName

public void setVisibleColumnName(java.lang.String visibleColumnName)

Sets the visible column name.

Parameters:

visibleColumnName - the column name to be used to be displayed as content of the combo box

getVisibleColumnName

public java.lang.String getVisibleColumnName()

Returns the visible column name.

Returns:

the visible column name

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface Storable

loadValue

public void loadValue(Identifier identifierToSelect)

getSize

public int getSize()

getIndexOfIdentifier

public int getIndexOfIdentifier(Identifier identifier)

getIdentifierOfIndex

public Identifier getIdentifierOfIndex(int index)

setSelectedIndex

public void setSelectedIndex(int index)

setSelected

public void setSelected(Identifier identifier)

Called when list selection changes to refresh registered dependent data components to reload themselves.

Parameters:

e - the list selection event

getSelectedIdentifier

public Identifier getSelectedIdentifier()

isFilled

public boolean isFilled()

Indicates whether the component has a value.

Specified by:

isFilled in interface Storable

Returns:

true if the component has a value

getItemCount

public int getItemCount()

isModified

public boolean isModified()

Indicates whether the component's value differs from its initial value.

Specified by:

isModified in interface Storable

Returns:

true if the component's value differs from its initial value

isToSave

public boolean isToSave()

saveValue

public void saveValue()

Stores the component's value.

Specified by:

saveValue in interface Storable

setRequired

public void setRequired(boolean required)

Description copied from interface: Storable

Sets the fact that user input is requested (mandatory)

Specified by:

setRequired in interface Storable

Parameters:

required - whether this input is mandatory or not.

isRequirementUnfulfilled

public boolean isRequirementUnfulfilled()

Indicates whether the component's value is mandatory but not filled.

Specified by:

isRequirementUnfulfilled in interface Storable

Returns:

if mandatory input is unfulfilled

free

public void free()

Releases external resources.

Specified by:

free in interface Exemptible

Specified by:

free in interface ExemptibleManager

Overrides:

free in class RemoteElement

dataChangePerformed

public void dataChangePerformed(DataChangedEvent e)

Called from data objects when data have been changed. Used for synchronization of data presentations.

Specified by:

dataChangePerformed in interface DataChangeListener

Parameters:

e - the data change event that happened.

setToolTipText

public void setToolTipText(java.lang.String toolTipText)

Description copied from interface: Remotable

Sets the component's tool tip text.

Specified by:

setToolTipText in interface Remotable

Overrides:

setToolTipText in class RemoteElement

Parameters:

toolTipText - the component's tool tip text

buildRemoteView

public void buildRemoteView(ToAppletWriter out)

Description copied from interface: AppletTalker

Build remote view.

Specified by:

buildRemoteView in interface AppletTalker

Overrides:

buildRemoteView in class RemoteElement

Parameters:

out - the writer which will be read by the applet

setValues

public void setValues(ToAppletWriter out)

Specified by:

setValues in interface RemoteContent

Overrides:

setValues in class RemoteElement

fetchValuesFromRequest

public void fetchValuesFromRequest(GeneralizedRequest request)

Specified by:

fetchValuesFromRequest in interface Remotable

getContextMenuIds

public java.util.Vector<Identifier> getContextMenuIds(GeneralizedRequest request)

destroy

public void destroy()

Description copied from interface: Remotable

Don't wait until garbage collector removed weak reference.

Specified by:

destroy in interface Remotable

isValid

public boolean isValid()

Description copied from interface: Storable

Returns true if the component's value is valid.

Specified by:

isValid in interface Storable

Returns:

true if the component's value is valid

requestFocusInWindow

public void requestFocusInWindow()

Description copied from interface: RemoteContent

Set focus on the receiving component if isRequestFocusEnabled returns true.

Specified by:

requestFocusInWindow in interface RemoteContent

Overrides:

requestFocusInWindow in class RemoteElement