de.must.wuic

Class DataSelectDialog

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

javax.swing.JDialog

de.must.wuic.MustDialog

de.must.wuic.SelectDialog

de.must.wuic.DataSelectDialog

All Implemented Interfaces:

DataChangeListener, AppTextResource, Exemptible, ExemptibleManager, ContextHelp, java.awt.event.ActionListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Runnable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

Direct Known Subclasses:

ColumnDataListDialog, SimpleDataSelectDialog, SimpleDataSelectDialogFew

public abstract class DataSelectDialog
extends SelectDialog
implements DataChangeListener, java.lang.Runnable

Frame for database inquiry, data overview and record selection. In the first step, data for the inquiry is entered. Pressing the list button starts the inquiry and fills the list with the results. After selecting a single entry, function like editing among others are available. It's common to use it via subclasses SimpleDataListFrame and ColumnDataListFrame.

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JDialog.AccessibleJDialog

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

java.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType

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

java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type

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

Modifier and Type	Field and Description
protected DataObject	listDataObject
protected java.lang.Thread	listThread
protected static int	maxListEntries

Fields inherited from class de.must.wuic.SelectDialog

buttonChoose, buttonClose, buttonList, buttonPresent, choosenIdentifier, currentAttributeList, expertSearchTab, expertSearchTextArea, globalSearchTextField, imageResource, isAttributeListToPack, jSplitPane1, lastSelectionIdentifier, LIST_MODIFICATION_APPEND, LIST_MODIFICATION_REMOVE, LIST_MODIFICATION_UPDATE, listModification, mustTabbedPane, panelBottom, panelButtons, panelSelectButtons, panelTop, presentationInstance, printInstance, programmaticChange, statusLabel, tabAttributeList, timeSetVisible

Fields inherited from class de.must.wuic.MustDialog

alreadyMadeInvisible, defaultCursor, ownerDialog, ownerFrame, sd, storedLayout, waitCursor

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPaneCheckingEnabled

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
DataSelectDialog(java.awt.Frame ownerFrame) Constructs a new frame for selecting data.
DataSelectDialog(MustDialog ownerDialog) Constructs a new frame for selecting data.

Method Summary

Modifier and Type	Method and Description
boolean	acceptsClosingDueToInactivity() Returns true if frame accepts closing due to inactivity.
protected abstract void	appendListEntry() Adds an entry at the end of the table.
protected abstract void	beginOfListThread() Called when list thread begins.
protected abstract void	completeListFill() Ending of list fills into a list model which is not currently assigned to the view.
protected void	creationEnding() Conclusion of the construction process.
void	dataChangePerformed(DataChangedEvent e) Called from data objects when data have been changed.
protected abstract void	endOfListThread() Called when list thread ends.
protected void	fillList() Fills the List according to the specified criteria.
java.lang.String	getElaboratedWhereCondition() Returns the where condition.
int	getListThreadPriority() Returns the listThreadPriority.
protected int	getMaxListEntries() Returns the limit of entries to be displayed in the list.
protected abstract java.lang.String	getOrderByFields() Returns the fields to be used for the order by clause, separated by comma as usual in SQL statements.
protected abstract java.lang.String	getSelectionFields() Returns the fields to be selected, separated by comma as usual in SQL statements.
protected abstract java.lang.String	getWhereCondition() Returns the where condition for the select statement to process the inquiry.
protected abstract void	handleDataChangeIndividually(DataChangedEvent e) Called from DataObject when data have been changed.
protected void	listButtonAction() The task to be done associated with the list button.
void	refreshList() Clears and fills the list in separate thread.
void	run()
protected void	setAutoInitialListFill(boolean wanted) Sets the flag for automatic list fill when construction is done.
protected void	setInitialMessage()
protected void	setListDataObject(DataObject listDataObject) Sets the data object to be used to fill the list.
void	setListThreadPriority(int listThreadPriority) Sets the listThreadPriority.
static void	setMaxListEntries(int newMaxListEntries) Sets the limit of entries to be displayed in the list.

Methods inherited from class de.must.wuic.SelectDialog

actionPerformed, beginListFill, chooseButtonAction, clearMessage, clearSelection, closeInstance, constructGUI, createButton, createButton, createComboBox, createComboBox, createComboBox, createIntField, createIntField, createTextField, createTextField, createTextFieldForGlobalSearch, createVariableChoice, createVariableChoice, delayedInititialActions, generalActionBeginnung, generalActionEnding, getChosenIdentifier, getIdentifiers, getListItemCount, getListModification, getNotFoundNotification, getPresentationClass, getPrintClass, getSelectedIdentifier, getSelectedIndex, getSelectedItem, getSelectedTab, isChoosingAllowed, isClosingAllowed, isInputAccepted, isModificationAllowed, isSelectionAccepted, newPanel, newPanel, newPanel, newPanelWithExpertSearchTextArea, packIfNotLaidOut, presentButtonAction, removeAllOfTheList, requestListingFocus, selectListIndex, setLocation, setMessage, setMessageToKeep, setMinHeight, setSelectedIdentifier, setSize, setVisible

Methods inherited from class de.must.wuic.MustDialog

adjustSizeToPlausibleValue, closeAll, closeAllDueToInactivity, free, getAppResStr, getFrame, getHelpTarget, getHelpTopic, getRootPane, getTranslation, isLaidOut, locateInCenter, packAndLocateInCenter, packAndLocateInCenterIfNotLaidOut, popupMessage, prepareForProgrammaticalClosing, register, setDefaultLocation, setDefaultSize, setHelpContext, setHelpContext, setIconImages, setImageIcon, setTitle, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class javax.swing.JDialog

addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Dialog

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setUndecorated, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setType, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

listDataObject

protected DataObject listDataObject

listThread

protected java.lang.Thread listThread

maxListEntries

protected static int maxListEntries

Constructor Detail

DataSelectDialog

public DataSelectDialog(java.awt.Frame ownerFrame)

Constructs a new frame for selecting data.

Parameters:

ownerFrame - the frame form where this frame is called

DataSelectDialog

public DataSelectDialog(MustDialog ownerDialog)

Constructs a new frame for selecting data.

Parameters:

ownerFrame - the frame form where this frame is called

Method Detail

creationEnding

protected void creationEnding()

Description copied from class: SelectDialog

Conclusion of the construction process. Allows to do construction details in the sequence super class - this - super class which is a benefit for easy layout.

Overrides:

creationEnding in class SelectDialog

setInitialMessage

protected void setInitialMessage()

setListDataObject

protected void setListDataObject(DataObject listDataObject)

Sets the data object to be used to fill the list.

Parameters:

listDataObject - the data object to be used to fill the list

setMaxListEntries

public static void setMaxListEntries(int newMaxListEntries)

Sets the limit of entries to be displayed in the list.

Parameters:

newMaxListEntries - the limit of entries to be displayed in the list

getMaxListEntries

protected int getMaxListEntries()

Returns the limit of entries to be displayed in the list.

Returns:

the limit of entries to be displayed in the list

setAutoInitialListFill

protected void setAutoInitialListFill(boolean wanted)

Sets the flag for automatic list fill when construction is done.

Parameters:

wanted - whether automatic list fill after construction is wished

getListThreadPriority

public int getListThreadPriority()

Returns the listThreadPriority.

Returns:

int

setListThreadPriority

public void setListThreadPriority(int listThreadPriority)

Sets the listThreadPriority.

Parameters:

listThreadPriority - The listThreadPriority to set

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.

listButtonAction

protected void listButtonAction()

Description copied from class: SelectDialog

The task to be done associated with the list button.

Overrides:

listButtonAction in class SelectDialog

run

public void run()

Specified by:

run in interface java.lang.Runnable

refreshList

public void refreshList()

Clears and fills the list in separate thread.

getOrderByFields

protected abstract java.lang.String getOrderByFields()

Returns the fields to be used for the order by clause, separated by comma as usual in SQL statements.

Returns:

the fields to be used for the order by clause

fillList

protected void fillList()

Fills the List according to the specified criteria.

completeListFill

protected abstract void completeListFill()

Ending of list fills into a list model which is not currently assigned to the view. The model initialized by beginListFill() becomes active now.

See Also:

SelectDialog.beginListFill()

getElaboratedWhereCondition

public java.lang.String getElaboratedWhereCondition()

Returns the where condition.

Returns:

the where condition

getSelectionFields

protected abstract java.lang.String getSelectionFields()

Returns the fields to be selected, separated by comma as usual in SQL statements. Is to be implemented by the subclass to guarantee availability for later usage. Sample: return DbField1, DbField2, DbField3;

Returns:

the fields to be selected

getWhereCondition

protected abstract java.lang.String getWhereCondition()

Returns the where condition for the select statement to process the inquiry. See the code of subclasses for samples how this may be implemented. In the simplest case it looks like return "DbFieldName like '%" + UIfield.getText() + "%'";

Returns:

the where condition for the select statement

beginOfListThread

protected abstract void beginOfListThread()

Called when list thread begins.

endOfListThread

protected abstract void endOfListThread()

Called when list thread ends.

appendListEntry

protected abstract void appendListEntry()

Adds an entry at the end of the table.

handleDataChangeIndividually

protected abstract void handleDataChangeIndividually(DataChangedEvent e)

Called from DataObject when data have been changed.

Parameters:

e - the data change event

See Also:

DataChangeListener, DataObject

acceptsClosingDueToInactivity

public boolean acceptsClosingDueToInactivity()

Description copied from class: MustDialog

Returns true if frame accepts closing due to inactivity.

Overrides:

acceptsClosingDueToInactivity in class SelectDialog

Returns:

true if frame accepts closing due to inactivity