de.must.appletserver

Class DataVariableChoice

java.lang.Object

de.must.appletserver.RemoteElement

de.must.appletserver.MustComboBox

de.must.appletserver.VariableChoice

de.must.appletserver.DataVariableChoice

All Implemented Interfaces:

ActionInterpreter, AppletTalker, Remotable, RemoteContent, Storable, Updatable, Exemptible, ExemptibleManager, java.awt.event.ItemListener, java.util.EventListener

public class DataVariableChoice
extends VariableChoice
implements Storable, java.awt.event.ItemListener

Combo box whose content is filled by a database table and which is linked to another database table which contains the key for the selected entry.

Field Summary

Fields inherited from class de.must.appletserver.MustComboBox

index, items, value

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
DataVariableChoice(SessionData sessionData, KeyValuePair[] content, DataObject dO, java.lang.String columnName) Constructs a new DataVariableChoice.
DataVariableChoice(SessionData sessionData, java.lang.String[][] content, DataObject dO, java.lang.String columnName) Constructs a new DataVariableChoice.
DataVariableChoice(SessionData sessionData, java.lang.String[][] content, DataObject dO, java.lang.String columnName, boolean noChoicePossible) Constructs a new DataVariableChoice.
DataVariableChoice(SessionData sessionData, java.lang.String[][] content, DataObject dO, java.lang.String columnName, boolean noChoicePossible, boolean suppressKey) Constructs a new DataVariableChoice.

Method Summary

Modifier and Type	Method and Description
void	addComponentModificationListener(ComponentModificationListener l) Adds a component modification listener to this component.
void	free() Releases external resources.
DataObject	getAssignedDataObject() Returns the assigned data object.
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	itemStateChanged(java.awt.event.ItemEvent e) Invoked when an item state has been released.
void	loadValue() Loads the component's database stored value.
void	removeComponentModificationListener(ComponentModificationListener l) Removes a component modification listener to this component.
void	saveValue() Stores the component's value.
void	selectAll() Selects all input of the component, if it is supported - e.g. in JTextField.
void	setDefaultValue(java.lang.String newDefaultValue)
void	setEditable(boolean editable) Sets the flag that determines whether or not this component is editable.
void	setEditBeginValue(java.lang.String specialeditBeginValue) Sets the default value (if no date could be loaded from database).
void	setRequired(boolean required) Determines whether input is required (mandatory).
void	setSelectedIndexAsEditBeginValue(int anIndex) Selects the item by index as edit begin value which causes isModified to return false as long as user select another item.
void	setSelectedItemKeyAsEditBeginValue(java.lang.String key) Selects the item by key as edit begin value which causes isModified to return false as long as user select another item.

Methods inherited from class de.must.appletserver.VariableChoice

getSelectedIndex, getSelectedItemKey, getTranslation, isSpecialChoice, setNoSpecialChoice, setSelectedItemKey, setSelectedItemKeyAsBeginValue

Methods inherited from class de.must.appletserver.MustComboBox

addItem, addItemListener, buildRemoteView, destroy, fetchValuesFromRequest, getItemAt, getItemCount, getSelectedItem, perform, removeAllItems, requestFocusInWindow, resetEditBeginValue, setSelectedIndex, setSelectedItem, setValues, updateRemoteView

Methods inherited from class de.must.appletserver.RemoteElement

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.appletserver.RemoteContent

requestFocusInWindow, setValues

Methods inherited from interface de.must.appletserver.Remotable

destroy, fetchValuesFromRequest, setToolTipText

Methods inherited from interface de.must.appletserver.AppletTalker

buildRemoteView

Constructor Detail

DataVariableChoice

public DataVariableChoice(SessionData sessionData,
                          java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

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

DataVariableChoice

public DataVariableChoice(SessionData sessionData,
                          java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName,
                          boolean noChoicePossible)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

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

noChoicePossible - if true, an item is offered which represents the "no choice"

DataVariableChoice

public DataVariableChoice(SessionData sessionData,
                          java.lang.String[][] content,
                          DataObject dO,
                          java.lang.String columnName,
                          boolean noChoicePossible,
                          boolean suppressKey)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

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

noChoicePossible - if true, an item is offered which represents the "no choice"

suppressKey - whether or not keys should be suppressed in ComboBox

DataVariableChoice

public DataVariableChoice(SessionData sessionData,
                          KeyValuePair[] content,
                          DataObject dO,
                          java.lang.String columnName)

Constructs a new DataVariableChoice.

Parameters:

content - the content to assign to

dO - the data object to assign to

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

Method Detail

getAssignedDataObject

public DataObject getAssignedDataObject()

Returns the assigned data object.

Specified by:

getAssignedDataObject in interface Storable

Returns:

the assigned data object

setDefaultValue

public void setDefaultValue(java.lang.String newDefaultValue)

Parameters:

newDefaultValue - sets the default value.

setEditable

public void setEditable(boolean editable)

Sets the flag that determines whether or not this component is editable. This means: value may be changed by user. It does not mean, that user may type in characters. To allow this, use setEditableForUserTyping. 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:

VariableChoice#setEditableForUserTyping(boolean)

setRequired

public void setRequired(boolean required)

Determines whether input is required (mandatory).

Specified by:

setRequired in interface Storable

Parameters:

required - if true, input is mandatory; otherwise, input is not mandatory

isContentValid

public boolean isContentValid()

Indicates whether the component's value is valid.

Returns:

true if the component's value is valid

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

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 MustComboBox

setSelectedIndexAsEditBeginValue

public void setSelectedIndexAsEditBeginValue(int anIndex)

Selects the item by index as edit begin value which causes isModified to return false as long as user select another item.

Overrides:

setSelectedIndexAsEditBeginValue in class MustComboBox

Parameters:

anIndex - the index of the item to select

setSelectedItemKeyAsEditBeginValue

public void setSelectedItemKeyAsEditBeginValue(java.lang.String key)

Selects the item by key as edit begin value which causes isModified to return false as long as user select another item.

Parameters:

key - the key of the item to select

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface Storable

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

setEditBeginValue

public void setEditBeginValue(java.lang.String specialeditBeginValue)

Sets the default value (if no date could be loaded from database).

Parameters:

specialEditBeginValue - the new initial value of the date field

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

isModified

public boolean isModified()

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

Specified by:

isModified in interface Storable

Overrides:

isModified in class MustComboBox

Returns:

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

isToSave

public boolean isToSave()

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent e)

Invoked when an item state has been released. Used to fire a component modified event.

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

Parameters:

e - the key event

addComponentModificationListener

public void addComponentModificationListener(ComponentModificationListener l)

Adds a component modification listener to this component. Needed e.g. for data components depending from a sublist.

Parameters:

l - component modification listener to add

removeComponentModificationListener

public void removeComponentModificationListener(ComponentModificationListener l)

Removes a component modification listener to this component. Needed e.g. for data components depending from a sublist.

Parameters:

l - component modification listener to add

See Also:

DataList

saveValue

public void saveValue()

Stores the component's value.

Specified by:

saveValue in interface Storable

free

public void free()

Releases external resources.

Specified by:

free in interface Exemptible

Specified by:

free in interface ExemptibleManager

Overrides:

free in class RemoteElement