de.must.appletserver

Class DataComboBox

java.lang.Object

de.must.appletserver.RemoteElement

de.must.appletserver.MustComboBox

de.must.appletserver.HalfDataComboBox

de.must.appletserver.DataComboBox

All Implemented Interfaces:

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

public class DataComboBox
extends HalfDataComboBox
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.

Nested Class Summary

Nested classes/interfaces inherited from class de.must.appletserver.HalfDataComboBox

HalfDataComboBox.Variant

Field Summary

Fields inherited from class de.must.appletserver.HalfDataComboBox

callbackIfTableChanged, containsNoSpecification, contentDataObject, contentIsToRenew, editBeginValue, filterCondition, identifierTable, inactiveColumnName, nameForNoChoice, orderByColumnNames, SPECIAL_NAME_FOR_NO_CHOICE_WHICH_MEANS_NOT_APPLICABLE, specialChoices, visibleColumnNames, weakItems, WIDTH_FITTING_TO_CONTENT

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
DataComboBox(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject) Constructs a new combo box for unencoded assignment.
DataComboBox(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName) Constructs a new combo box for encoded assignment.
DataComboBox(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName, java.lang.String orderByColumnName, java.lang.String nameForNoChoice) Constructs a new combo box for encoded assignment.
DataComboBox(SessionData sessionData, DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName, java.lang.String orderByColumnName, java.lang.String nameForNoChoice, int width) Constructs a new combo box for encoded assignment.

Method Summary

Modifier and Type	Method and Description
void	dataChangePerformed(DataChangedEvent e) Invoked when data have been changed.
protected void	fill() Fills or refills the content of the data combo box by reading the source data object.
DataObject	getAssignedDataObject()
boolean	isContentValid() Indicates whether the component's value is valid.
boolean	isFilled() Returns true if 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	saveValue() Stores the component's value.
void	selectAll() Selects all input of the component, if it is supported - e.g. in JTextField.
void	setEditBeginValue(Identifier specialEditBeginValue) Sets the default value (if no date could be loaded from database).
void	setNoSpecialChoiceAsEditBeginValue() Selects the item to be used to indicate "no special choice" and indicates that this is the begin of editing so that isModified returns false.
void	setRequired(boolean required) Determines whether input is required (mandatory).

Methods inherited from class de.must.appletserver.HalfDataComboBox

addItem, destroy, fill, finalize, free, getSelectedIdentifier, getSelectedItemWithoutNameForNoChoice, getTranslation, isSpecialChoice, reloadContentIfIsToRenew, removeAllItems, setFilterCondition, setFilterCondition, setInactiveColumnName, setNoSpecialChoice, setSelectedIdentifier, setSelectedIdentifierAsBeginValue, setSpecialChoices, setValues

Methods inherited from class de.must.appletserver.MustComboBox

addItem, addItemListener, buildRemoteView, fetchValuesFromRequest, getItemAt, getItemCount, getSelectedItem, perform, requestFocusInWindow, resetEditBeginValue, setSelectedIndex, setSelectedIndexAsEditBeginValue, setSelectedItem, updateRemoteView

Methods inherited from class de.must.appletserver.RemoteElement

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

Methods inherited from class java.lang.Object

clone, equals, 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

DataComboBox

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

Constructs a new combo box for unencoded assignment. The value you see is what is stored in the database. This is the simple value assignment like pure MS Access applications. Not really relational but nevertheless popular.

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

DataComboBox

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

Constructs a new combo box for encoded assignment. Not the value you see is stored in the database, but its identifier.

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 name of the column to be displayed

DataComboBox

public DataComboBox(SessionData sessionData,
                    DataObject assignedDataObject,
                    java.lang.String assignedColumnName,
                    DataObject sourceDataObject,
                    java.lang.String visibleColumnName,
                    java.lang.String orderByColumnName,
                    java.lang.String nameForNoChoice)

Constructs a new combo box for encoded assignment.

Parameters:

assignedDataObject - the data object to assign to

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

sourceDataObject - the source data object

visibleColumnName - the name of the column to be displayed

orderByColumnName - the sorting column name of the content data object

nameForNoChoice - the expression to be used to indicate "no choice"

DataComboBox

public DataComboBox(SessionData sessionData,
                    DataObject assignedDataObject,
                    java.lang.String assignedColumnName,
                    DataObject sourceDataObject,
                    java.lang.String visibleColumnName,
                    java.lang.String orderByColumnName,
                    java.lang.String nameForNoChoice,
                    int width)

Constructs a new combo box for encoded assignment.

Parameters:

assignedDataObject - the data object to assign to

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

sourceDataObject - the data object to fill the content

visibleColumnName - the name of the column to be displayed

orderByColumnName - the sorting column name of the content data object

nameForNoChoice - the expression to be used to indicate "no choice"

width - the width of the component - if 0 it's automatically sized

Method Detail

getAssignedDataObject

public DataObject getAssignedDataObject()

Specified by:

getAssignedDataObject in interface Storable

Returns:

the assigned data object

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 HalfDataComboBox

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface Storable

setNoSpecialChoiceAsEditBeginValue

public void setNoSpecialChoiceAsEditBeginValue()

Selects the item to be used to indicate "no special choice" and indicates that this is the begin of editing so that isModified returns false.

setEditBeginValue

public void setEditBeginValue(Identifier specialEditBeginValue)

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

Parameters:

specialEditBeginValue - the new initial value of the date field

isFilled

public boolean isFilled()

Description copied from class: HalfDataComboBox

Returns true if the component has a value.

Specified by:

isFilled in interface Storable

Overrides:

isFilled in class HalfDataComboBox

Returns:

true if the component has a value

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 HalfDataComboBox

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

saveValue

public void saveValue()

Stores the component's value.

Specified by:

saveValue in interface Storable

dataChangePerformed

public void dataChangePerformed(DataChangedEvent e)

Invoked when data have been changed. Used to fire a component modified event.

Specified by:

dataChangePerformed in interface DataChangeListener

Overrides:

dataChangePerformed in class HalfDataComboBox

Parameters:

e - the key event

fill

protected void fill()

Description copied from class: HalfDataComboBox

Fills or refills the content of the data combo box by reading the source data object.

Overrides:

fill in class HalfDataComboBox