de.must.wuic

Class DataList

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JList<java.lang.String>

de.must.wuic.MustList

de.must.wuic.DataList

All Implemented Interfaces:

DataChangeListener, Exemptible, ModifiedInformer, AnySelectionSpeaker, DataComponent, DataComponentOwner, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ListSelectionListener, javax.swing.Scrollable

public class DataList
extends MustList
implements DataComponent, DataComponentOwner, DataChangeListener

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

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JList.AccessibleJList, javax.swing.JList.DropLocation

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 javax.swing.JList

HORIZONTAL_WRAP, VERTICAL, VERTICAL_WRAP

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
DataList(DataObject assignedDataObject, java.lang.String assignedColumnName, DataObject sourceDataObject, java.lang.String visibleColumnName) Constructs a new data list.
DataList(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	addComponentModificationListener(ComponentModificationListener l) Adds a component modification listener to this component.
void	assignDC(DataComponent dataComponent) Assigns a data component to this owner.
void	dataChangePerformed(DataChangedEvent e)
void	deleteSelectedItems() Deletes selected items and selects the next or previous value if they exist.
void	free() Releases external resources.
DataObject	getAssignedDataObject() Returns the assigned data object.
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() Indicates whether the component's value differs from its value at load time.
void	loadValue() Loads the component's database stored value.
void	refresh()
void	reloadDataObjectByLastRevisionIdentifier() Reloads the source data object by lastRevisionIdentier - may be new row, too.
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	setEditable(boolean editable) Sets the flag that determines whether or not this component is editable.
void	setPresentables(Presentable[] newPresentables) Assigns the presentables to be dependent on this data list.
void	setRequired(boolean required) Determines whether input is required (mandatory).
void	setVisibleColumnName(java.lang.String visibleColumnName) Sets the visible column name.
void	valueChanged(javax.swing.event.ListSelectionEvent e)

Methods inherited from class de.must.wuic.MustList

addAnySelectionListener, addIndexedItem, addItem, applyNewModel, fireSelectionChanged, getBackground, getIdentifier, getIdModel, getItemCount, getSelectedIdentifier, getSelectedIdentifiers, getSelectedItem, getTranslation, keyPressed, keyReleased, keyTyped, mouseClicked, mouseEntered, mouseExited, mousePressed, mouseReleased, prepareModelForExtension, prepareNewModel, remove, removeAll, removeAnySelectionListener, setBackgroundColor, setEnterButton, setPopupReceiver, setSelectedIndex, updateItem

Methods inherited from class javax.swing.JList

addListSelectionListener, addSelectionInterval, clearSelection, createSelectionModel, ensureIndexIsVisible, fireSelectionValueChanged, getAccessibleContext, getAnchorSelectionIndex, getCellBounds, getCellRenderer, getDragEnabled, getDropLocation, getDropMode, getFirstVisibleIndex, getFixedCellHeight, getFixedCellWidth, getLastVisibleIndex, getLayoutOrientation, getLeadSelectionIndex, getListSelectionListeners, getMaxSelectionIndex, getMinSelectionIndex, getModel, getNextMatch, getPreferredScrollableViewportSize, getPrototypeCellValue, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedIndex, getSelectedIndices, getSelectedValue, getSelectedValues, getSelectedValuesList, getSelectionBackground, getSelectionForeground, getSelectionMode, getSelectionModel, getToolTipText, getUI, getUIClassID, getValueIsAdjusting, getVisibleRowCount, indexToLocation, isSelectedIndex, isSelectionEmpty, locationToIndex, paramString, removeListSelectionListener, removeSelectionInterval, setCellRenderer, setDragEnabled, setDropMode, setFixedCellHeight, setFixedCellWidth, setLayoutOrientation, setListData, setListData, setModel, setPrototypeCellValue, setSelectedIndices, setSelectedValue, setSelectionBackground, setSelectionForeground, setSelectionInterval, setSelectionMode, setSelectionModel, setUI, setValueIsAdjusting, setVisibleRowCount, 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, 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, processKeyBinding, processKeyEvent, 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, setEnabled, 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, 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, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.must.wuic.DataComponent

requestFocusInWindow, setToolTipText

Constructor Detail

DataList

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

Returns:

the assigned data object

getSourceDataObject

public DataObject getSourceDataObject()

Returns the content data object.

Returns:

the content data object

assignDC

public void assignDC(DataComponent dataComponent)

Description copied from interface: DataComponentOwner

Assigns a data component to this owner.

Specified by:

assignDC in interface DataComponentOwner

Parameters:

dataComponent - the data component to be assigned

setEditable

public void setEditable(boolean editable)

Description copied from interface: DataComponent

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.

Specified by:

setEditable in interface DataComponent

Parameters:

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

isContentValid

public boolean isContentValid()

Description copied from interface: DataComponent

Indicates whether the component's value is valid.

Specified by:

isContentValid in interface DataComponent

Returns:

true if the component's value is valid

selectAll

public void selectAll()

Description copied from interface: DataComponent

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

setPresentables

public void setPresentables(Presentable[] 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()

Description copied from interface: DataComponent

Loads the component's database stored value.

Specified by:

loadValue in interface DataComponent

deleteSelectedItems

public void deleteSelectedItems()

Deletes selected items and selects the next or previous value if they exist.

refresh

public void refresh()

valueChanged

public void valueChanged(javax.swing.event.ListSelectionEvent e)

Specified by:

valueChanged in interface javax.swing.event.ListSelectionListener

Overrides:

valueChanged in class MustList

reloadDataObjectByLastRevisionIdentifier

public void reloadDataObjectByLastRevisionIdentifier()

Reloads the source data object by lastRevisionIdentier - may be new row, too.

isFilled

public boolean isFilled()

Description copied from interface: DataComponent

Indicates whether the component has a value.

Specified by:

isFilled in interface DataComponent

Returns:

true if the component has a value

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

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

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

setRequired

public void setRequired(boolean required)

Description copied from interface: DataComponent

Determines whether input is required (mandatory).

Specified by:

setRequired in interface DataComponent

Parameters:

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

isRequirementUnfulfilled

public boolean isRequirementUnfulfilled()

Description copied from interface: DataComponent

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

Specified by:

isRequirementUnfulfilled in interface DataComponent

Returns:

if mandatory input is unfulfilled

free

public void free()

Description copied from interface: Exemptible

Releases external resources. May be called manually without waiting for garbage collection to occur.

Specified by:

free in interface Exemptible

dataChangePerformed

public void dataChangePerformed(DataChangedEvent e)

Specified by:

dataChangePerformed in interface DataChangeListener