de.must.wuic

Class DataComboBox

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JComboBox<java.lang.Object>

de.must.wuic.MustComboBox

de.must.wuic.HalfDataComboBox

de.must.wuic.DataComboBox

All Implemented Interfaces:

DataChangeListener, Exemptible, ModifiedInformer, ContextHelp, DataComponent, java.awt.event.ActionListener, java.awt.event.ItemListener, java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ListDataListener

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

See Also:

Serialized Form

Nested Class Summary

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

HalfDataComboBox.Variant

Nested classes/interfaces inherited from class javax.swing.JComboBox

javax.swing.JComboBox.AccessibleJComboBox, javax.swing.JComboBox.KeySelectionManager

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class de.must.wuic.HalfDataComboBox

containsNoSpecification, contentDataObject, 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.wuic.MustComboBox

programmaticChange

Fields inherited from class javax.swing.JComboBox

actionCommand, dataModel, isEditable, keySelectionManager, lightWeightPopupEnabled, maximumRowCount, renderer, selectedItemReminder

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
DataComboBox(DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject) Constructs a new combo box for unencoded assignment.
DataComboBox(DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName) Constructs a new combo box for encoded assignment.
DataComboBox(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(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	addComponentModificationListener(ComponentModificationListener l) Adds a component modification listener to this component.
void	dataChangePerformed(DataChangedEvent e)
protected void	finalize()
void	free() Frees external resources.
DataObject	getAssignedDataObject()
boolean	isContentValid() Indicates whether the component's value is valid.
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() Indicates whether the component's value differs from its value at load time.
void	itemStateChanged(java.awt.event.ItemEvent e) Invoked when an item state has been released.
void	keyReleased(java.awt.event.KeyEvent e) Invoked when a key 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	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).
void	setToSaveEvenIfNotModified(boolean toSaveEvenIfNotModified) Sets the flag to save component's value (transfer to data object) even user didn't modify its value.

Methods inherited from class de.must.wuic.HalfDataComboBox

addItem, fill, fill, getEditBeginValue, getSelectedIdentifier, getSelectedItemWithoutNameForNoChoice, getTranslation, isFilled, isSpecialChoice, removeItem, setFilterCondition, setFilterCondition, setHelpContext, setInactiveColumnName, setNoSpecialChoice, setSelectedIdentifier, setSelectedIdentifierAsBeginValue, setSpecialChoices

Methods inherited from class de.must.wuic.MustComboBox

getBackground, getHelpTarget, getHelpTopic, getIndexIfUnique, resetEditBeginValue, setEditable, setEditableForUserTyping, setEditableForUserTyping, setEditableForUserTyping, setHelpContext, setSelectedIndex, setSelectedIndexAsEditBeginValue, setSelectedItem, setSelectedItemAsEditBeginValue

Methods inherited from class javax.swing.JComboBox

actionPerformed, actionPropertyChanged, addActionListener, addItem, addItemListener, addPopupMenuListener, configureEditor, configurePropertiesFromAction, contentsChanged, createActionPropertyChangeListener, createDefaultKeySelectionManager, fireActionEvent, fireItemStateChanged, firePopupMenuCanceled, firePopupMenuWillBecomeInvisible, firePopupMenuWillBecomeVisible, getAccessibleContext, getAction, getActionCommand, getActionListeners, getEditor, getItemAt, getItemCount, getItemListeners, getKeySelectionManager, getMaximumRowCount, getModel, getPopupMenuListeners, getPrototypeDisplayValue, getRenderer, getSelectedIndex, getSelectedItem, getSelectedObjects, getUI, getUIClassID, hidePopup, insertItemAt, installAncestorListener, intervalAdded, intervalRemoved, isEditable, isLightWeightPopupEnabled, isPopupVisible, paramString, processKeyBinding, processKeyEvent, removeActionListener, removeAllItems, removeItem, removeItemAt, removeItemListener, removePopupMenuListener, selectedItemChanged, selectWithKeyChar, setAction, setActionCommand, setEditor, setEnabled, setKeySelectionManager, setLightWeightPopupEnabled, setMaximumRowCount, setModel, setPopupVisible, setPrototypeDisplayValue, setRenderer, setUI, showPopup, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.wuic.DataComponent

isFilled, requestFocusInWindow, setEditable, setToolTipText

Constructor Detail

DataComboBox

public DataComboBox(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(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(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(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 DataComponent

Returns:

the assigned data object

setRequired

public void setRequired(boolean required)

Determines whether input is required (mandatory).

Specified by:

setRequired in interface DataComponent

Parameters:

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

isContentValid

public boolean isContentValid()

Indicates whether the component's value is valid.

Specified by:

isContentValid in interface DataComponent

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 DataComponent

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 DataComponent

Overrides:

selectAll in class HalfDataComboBox

loadValue

public void loadValue()

Loads the component's database stored value.

Specified by:

loadValue in interface DataComponent

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.

setToSaveEvenIfNotModified

public void setToSaveEvenIfNotModified(boolean toSaveEvenIfNotModified)

Sets the flag to save component's value (transfer to data object) even user didn't modify its value.

Parameters:

toSaveEvenIfNotModified - whether or not component's value is to save even even user didn't modify its value

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

isModified

public boolean isModified()

Description copied from interface: ModifiedInformer

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

Specified by:

isModified in interface ModifiedInformer

Overrides:

isModified in class HalfDataComboBox

Returns:

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

isToSave

public boolean isToSave()

Description copied from interface: DataComponent

Indicates whether the component's value differs from its value at load time.

Specified by:

isToSave in interface DataComponent

Returns:

true if the component's value differs from its value at load time

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

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Invoked when a key has been released. Used to fire a component modified event.

Parameters:

e - the key event

addComponentModificationListener

public void addComponentModificationListener(ComponentModificationListener l)

Description copied from interface: DataComponent

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

Specified by:

addComponentModificationListener in interface DataComponent

Parameters:

l - component modification listener to add

removeComponentModificationListener

public void removeComponentModificationListener(ComponentModificationListener l)

Description copied from interface: DataComponent

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

Specified by:

removeComponentModificationListener in interface DataComponent

Parameters:

l - component modification listener to add

See Also:

DataList

saveValue

public void saveValue()

Description copied from interface: DataComponent

Stores the component's value.

Specified by:

saveValue in interface DataComponent

dataChangePerformed

public void dataChangePerformed(DataChangedEvent e)

Specified by:

dataChangePerformed in interface DataChangeListener

Overrides:

dataChangePerformed in class HalfDataComboBox

free

public void free()

Description copied from class: HalfDataComboBox

Frees external resources. May be called manually without waiting for the garbage collector.

Specified by:

free in interface Exemptible

Overrides:

free in class HalfDataComboBox

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class HalfDataComboBox

Throws:

java.lang.Throwable