de.must.wuic

Class AbstractDataListFrame

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

de.must.wuic.MustFrame

de.must.wuic.MustFrameWithStatusLabel

de.must.wuic.AbstractDataListFrame

All Implemented Interfaces:

DataChangeListener, AppTextResource, MessageReceiver, ContextHelp, java.awt.event.ActionListener, java.awt.event.ComponentListener, 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:

ColumnDataListFrame, SimpleDataListFrame

public abstract class AbstractDataListFrame
extends MustFrameWithStatusLabel
implements java.awt.event.ActionListener, DataChangeListener, java.lang.Runnable, MessageReceiver

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.JFrame

javax.swing.JFrame.AccessibleJFrame

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

java.awt.Frame.AccessibleAWTFrame

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 DataPropertyAdministration	associatedPropertyAdministration
protected MustButton	buttonChoose
protected MustButton	buttonClose
protected MustButton	buttonCopy
protected MustButton	buttonDelete
protected MustButton	buttonList
protected MustButton	buttonNew
protected MustButton	buttonPresent
protected MustButton	buttonPrint
protected MustButton	buttonProperties
protected AttributeList	currentAttributeList
protected int	currentMaxListEntries
protected MustTextArea	expertSearchTextArea
protected MustTextField	globalSearchTextField
protected int	initialXLocation
protected int	initialYLocation
protected InquiryHistory	inquiryHistory
protected javax.swing.JSplitPane	jSplitPane1
protected Identifier	lastSelectionIdentifier
static int	LIST_MODIFICATION_APPEND
static int	LIST_MODIFICATION_REMOVE
static int	LIST_MODIFICATION_UPDATE
static int	LIST_REFRESH_OFF There is no refresh running
static int	LIST_REFRESH_PROCEEDING The refresh is currently proceeding
static int	LIST_REFRESH_SUSPENDED Current list is suspended (incompletely loaded)
protected int	listIndex
protected boolean	listIsToRefresh
protected int	listModification
protected int	listRefreshState
protected javax.swing.JScrollPane	listScrollPane
protected java.lang.Thread	listThread
protected RadioButtonPanel	logic
protected static int	maxListEntries
protected int	maxListEntriesIndividual
protected MustTabbedPane	mustTabbedPane1
protected javax.swing.JPanel	panelButtons
protected javax.swing.JPanel	panelSelectButtons
protected javax.swing.JPanel	panelTop
protected DataPresentation	presentationInstance
protected DataPropertyPrint	printInstance
protected boolean	refreshCausedByListButton
protected javax.swing.JFrame	rootFrame
protected RadioButtonPanel	searchCombination
protected java.util.Vector<SearchElement>	searchElements
protected AttributeList[]	tabAttributeList
protected int	tabCount
static int	THREAD_MODE_EXTEND The thread runs to extend list
static int	THREAD_MODE_FILL The thread runs for initial fill
static int	THREAD_MODE_RESET The list thread is reset, know rows available
protected int	threadMode

Fields inherited from class de.must.wuic.MustFrameWithStatusLabel

statusLabel

Fields inherited from class de.must.wuic.MustFrame

defaultCursor, ownerFrame, waitCursor

Fields inherited from class javax.swing.JFrame

accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

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, 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
AbstractDataListFrame(java.awt.Frame ownerFrame) 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.
void	actionPerformed(java.awt.event.ActionEvent e) Controls action events like button pressed.
protected void	append(MustButton button) Appends the passed button to the current AttributeList.
protected abstract void	appendListEntry() Adds an entry at the end of the table.
protected abstract void	beginListExtension()
protected abstract void	beginListFill() Beginning of list fills into a list model which is not currently assigned to the view.
protected abstract void	beginOfListThread() Called when list thread begins.
protected void	chooseButtonAction() The task to be done associated with the choose button.
protected abstract void	clearSelection() Clears the selection.
void	closeInstance() Closes the frame and its associated frames and destroys them.
protected abstract void	completeListFill() Ending of list fills into a list model which is not currently assigned to the view.
protected void	copyButtonAction() The task to be done associated with the copy button.
protected MustButton	createButton(java.lang.String imageName, java.lang.String defaultLabel, java.lang.String toolTipText)
protected MustCheckBox	createCheckBox(java.lang.String checkText)
protected MustCheckBox	createCheckBox(java.lang.String label, java.lang.String checkText)
protected CleartextClassification	createCleartextClassification(java.lang.String label, SelfChainingDataObject sourceDataObject, java.lang.String visibleColumnName, int depth)
protected HalfDataComboBox	createComboBox(java.lang.String dataLabel, DataObject sourceDataObject, java.lang.String visibleColumn) Creates a combo box in the same line as previously used.
protected HalfDataComboBox	createComboBox(java.lang.String dataLabel, DataObject sourceDataObject, java.lang.String visibleColumn, java.lang.String orderByColumn) Creates a combo box in the same line as previously used.
protected HalfDataComboBox	createComboBox(java.lang.String dataLabel, DataObject sourceDataObject, java.lang.String visibleColumn, java.lang.String orderByColumn, java.lang.String nameForNoChoice) Creates a combo box in the same line as previously used.
protected MustDateField	createDateField() Creates a date input field in the same line as previously used.
protected MustDateField	createDateField(java.lang.String label) Creates a date input field in a new line.
protected RadioButtonPanel	createFragmentExactChoice()
protected MustIntField	createIntField(int length) Creates a int input field in the same line as previously used.
protected MustIntField	createIntField(java.lang.String label, int length) Creates a int field in a new line with its describing label.
protected void	createListDataObjectIfNull()
protected DataObject	createListDataObjects(DataObjectConstructionDetails docd) Creates the main list data objects and other data object while list thread is executing and returns the main list data object.
protected void	createOrRecoverPropertyAdministration() Creates or recovers the associated property administration frame
protected RadioButtonPanel	createRadioButtons(java.lang.String label, KeyValuePair[] content) Creates a radio button group in a new line.
protected MustTextField	createTextField(int length) Creates a text input field in the same line as previously used.
protected MustTextField	createTextField(java.lang.String label, int length) Creates a new text field.
protected MustTextField	createTextField(java.lang.String label, int length, DataObjectHolder.Creator choiceContentCreator, java.lang.String columnName) Creates a new text field.
protected void	createTextFieldForGlobalSearch(java.lang.String label, int length) Creates a new text field for global search.
protected void	createTextFieldForGlobalSearch(java.lang.String label, int length, boolean chooseAndOr) Creates a new text field for global search.
protected VariableChoice	createVariableChoice(java.lang.String dataLabel, KeyValuePair[] keyValuePairs) Constructs an new variable choice with the specified content.
protected VariableChoice	createVariableChoice(java.lang.String dataLabel, KeyValuePair[] keyValuePairs, java.lang.String nameForNoChoice) Constructs an new variable choice with the specified content.
protected VariableChoice	createVariableChoice(java.lang.String dataLabel, java.lang.String[][] content) Creates a new variable choice with static content.
protected VariableChoice	createVariableChoice(java.lang.String dataLabel, java.lang.String[][] content, boolean noChoicePossible) Creates a new variable choice with static content.
protected VariableChoice	createVariableChoice(java.lang.String dataLabel, java.lang.String[][] content, boolean noChoicePossible, boolean suppressKey) Creates a new variable choice with static content.
protected WhereCondition	createWhereCondition() Returns a new where condition object ready to apply specific SQL dialect aspects - available after list button has been pressed first time, which is at least the case in method getWhereCondition().
protected void	creationEnding() Conclusion of the construction process.
void	dataChangePerformed(DataChangedEvent e) Called from data objects when data have been changed.
protected void	delayedInititialActions() Workaround: called a little bit later than the initial time.
protected boolean	delete(Identifier identifier)
protected void	deleteButtonAction() The task to be done associated with the delete button.
protected abstract void	endOfListThread() Called when list thread ends.
void	extendList() Extends the list dynamically in thread.
protected void	extendListAsThread() Extends list.
protected void	fillList() Fills the List according to the specified criteria.
protected void	free() Frees (releases) references caused by this frame, particularly static register entries.
protected java.lang.String	getAdditionalWhereConditionForGlobalSearch() Returns additional where conditions for global search.
protected DataPropertyAdministration	getAssociatedPropertyAdministration() Returns the associated property administration.
java.lang.String	getElaboratedWhereCondition() Returns the where condition.
abstract Identifier[]	getIdentifiers()
protected int	getInitialXLocation() Returns the initial horizontal location.
protected int	getInitialYLocation() Returns the initial vertical location.
protected DataObject	getListDataObject() Returns the data object used to fill the list according to user's query.
protected abstract int	getListItemCount() Returns the number of items in the table.
protected int	getListModification() Returns the list modification case which may be LIST_MODIFICATION_APPEND, LIST_MODIFICATION_UPDATE or LIST_MODIFICATION_REMOVE
int	getListThreadPriority() Returns the listThreadPriority.
protected static int	getMaxListEntries() Returns the limit of entries to be displayed in the list.
protected java.lang.String	getNotFoundNotification() Returns the text to notify the user that no entry is matching the selection.
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 java.lang.Class<? extends DataPresentation>	getPresentationClass() Returns the presentation class - to be overridden by child if presentation class is available!
protected java.lang.Class<? extends DataPropertyPrint>	getPrintClass() Returns the print class - to be overridden by child if print class is available!
protected java.lang.String	getPrivateWhereConditionNotExpert()
protected abstract Identifier	getSelectedIdentifier() Returns the identifier (primary key) of the selected row.
protected abstract Identifier[]	getSelectedIdentifiers() Returns the identifiers (primary keys) of the selected rows.
protected java.util.Vector<Identifier>	getSelectedIdentifierVector() Returns the identifiers (primary keys) of the selected rows omitting negative values which are used for sub-headers.
protected abstract int	getSelectedIndex() Returns the index of the selected item.
protected abstract java.lang.String	getSelectedItem() Returns the selected item.
protected abstract java.lang.String[]	getSelectedItems() Returns the selected items.
int	getSelectedTab() Returns the selected tab of the tabbed pane.
protected java.lang.String	getSelectionFields() Returns the fields to be selected, separated by comma as usual in SQL statements.
protected java.lang.String	getTerritory() Returns the territory of this function.
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 boolean	isChoosingAllowed() Returns true if the user may choose the presented entries.
boolean	isClosingAllowed(int closeConfirmId) Returns true if closing of the window is allowed.
protected boolean	isConnectionOpen()
protected boolean	isCurrentListingCanceled()
protected boolean	isEditable()
protected boolean	isInputAccepted() Returns true if user input is accepted.
protected boolean	isModificationAllowed() Returns true if the user may modify the presented entries.
protected void	listButtonAction() The task to be done associated with the list button.
protected void	newButtonAction() The task to be done associated with the "new" button.
protected void	newDynamicSearchPanel(java.lang.String tabLabel, int elementAmount, SearchItem[] columns) Constructs a new dynamic search panel
protected void	newDynamicSearchPanel(java.lang.String tabLabel, int elementAmount, java.util.Vector<SearchItem> searchItems) Constructs a new dynamic search panel
protected void	newPanel() Creates a new panel and adds it to the tabbed pane with a list for row subselection.
protected void	newPanel(java.lang.String tabLabel) Creates a new panel and adds it to the tabbed pane with a list for row subselection.
protected void	newPanel(java.lang.String tabLabel, MustMultChoice multChoice, java.awt.Dimension preferedSize) Adds a panel with multiple choice selection.
protected void	newPanelWithExpertSearchTextArea(java.lang.String tabLabel) Adds an expert search panel to the tabbed pane.
protected void	packIfNotLaidOut() Packs the frame if it isn't already laid-out by user.
protected void	presentButtonAction() The task to be done associated with the present button.
protected void	printButtonAction() The task to be done associated with the print button.
protected void	propertyButtonAction() The task to be done associated with the property button.
void	receive(java.lang.String message)
void	refreshList() Clears and fills the list in separate thread.
protected abstract void	removeAllOfTheList() Removes all items of the table.
protected abstract void	requestListingFocus() Request the focus to the list.
protected void	reset()
protected void	resetExtensionMode() Resets extension mode.
protected void	resetList() Resets the list by resetting extension mode plus removing all items of the list.
protected void	resetListDataObjectWrapper()
void	run() Execution of the list thread.
protected boolean	select() Transfers the select relevant specification to the data object.
protected abstract void	selectListIndex(int indexToSelect) Selects an entry of the list by index.
protected void	setAssociatedPropertyAdministration(java.lang.Class<? extends DataPropertyAdministration> associatedPropertyAdministrationClass) Sets the associated property administration class.
protected void	setAssociatedPropertyAdministration(DataPropertyAdministration associatedPropertyAdministration) Sets the associated property administration.
protected void	setAutoInitialListFill(boolean wanted) Sets the flag for automatic list fill when construction is done.
protected void	setEditable(boolean editable)
protected void	setInitialXLocation(int newInitialXLocation) Sets the initial horizontal location.
protected void	setInitialYLocation(int newInitialYLocation) Sets the initial vertical location.
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 standard limit of entries to be displayed in the list.
void	setMaxListEntriesIndividual(int newMaxListEntriesIndividual) Sets the individual limit of entries to be displayed in the list.
abstract void	setSelectedIdentifier(Identifier identifier) Selects an item of the list / a row by identifier.

Methods inherited from class de.must.wuic.MustFrameWithStatusLabel

generalActionBeginnung, generalActionEnding, init, resetMessage, resetTemporaryMessage, setDefaultStatustext, setMessage, setMessageToKeep, setMessageToKeep

Methods inherited from class de.must.wuic.MustFrame

adjustSizeToPlausibleValue, bringToFrontAll, closeAll, closeAll, closeAllDueToInactivity, closeMainInstance, componentHidden, componentMoved, componentResized, componentShown, deiconifyAllExept, deregisterAsMainInstance, destroy, finalize, getAppResStr, getFrame, getHelpTarget, getHelpTopic, getLocale, getOrCreateMainInstance, getOrCreateMainInstance, getTranslation, iconifyAllExept, isCached, isClosingAllowedForAllFrames, isLaidOut, isRevivable, locateInCenter, logDebug, logError, logError, logError, logInfo, maximizeToBottomAndRight, open, packAndLocateInCenter, packAndLocateInCenterIfNotLaidOut, popupMessage, reInitialize, setDefaultIconImage, setDefaultIconImages, setHelpContext, setHelpContext, setIconImages, setLocaleStatically, setTitle, toFront, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class javax.swing.JFrame

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

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setUndecorated

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, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack

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, 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, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Detail

LIST_MODIFICATION_APPEND

public static final int LIST_MODIFICATION_APPEND

See Also:

Constant Field Values

LIST_MODIFICATION_UPDATE

public static final int LIST_MODIFICATION_UPDATE

See Also:

Constant Field Values

LIST_MODIFICATION_REMOVE

public static final int LIST_MODIFICATION_REMOVE

See Also:

Constant Field Values

THREAD_MODE_RESET

public static final int THREAD_MODE_RESET

The list thread is reset, know rows available

See Also:

Constant Field Values

THREAD_MODE_FILL

public static final int THREAD_MODE_FILL

The thread runs for initial fill

See Also:

Constant Field Values

THREAD_MODE_EXTEND

public static final int THREAD_MODE_EXTEND

The thread runs to extend list

See Also:

Constant Field Values

LIST_REFRESH_OFF

public static final int LIST_REFRESH_OFF

There is no refresh running

See Also:

Constant Field Values

LIST_REFRESH_SUSPENDED

public static final int LIST_REFRESH_SUSPENDED

Current list is suspended (incompletely loaded)

See Also:

Constant Field Values

LIST_REFRESH_PROCEEDING

public static final int LIST_REFRESH_PROCEEDING

The refresh is currently proceeding

See Also:

Constant Field Values

listModification

protected int listModification

rootFrame

protected final javax.swing.JFrame rootFrame

initialXLocation

protected int initialXLocation

initialYLocation

protected int initialYLocation

associatedPropertyAdministration

protected DataPropertyAdministration associatedPropertyAdministration

listThread

protected java.lang.Thread listThread

threadMode

protected int threadMode

listIsToRefresh

protected boolean listIsToRefresh

listRefreshState

protected int listRefreshState

maxListEntries

protected static int maxListEntries

maxListEntriesIndividual

protected int maxListEntriesIndividual

currentMaxListEntries

protected int currentMaxListEntries

refreshCausedByListButton

protected boolean refreshCausedByListButton

listIndex

protected int listIndex

panelTop

protected javax.swing.JPanel panelTop

mustTabbedPane1

protected MustTabbedPane mustTabbedPane1

listScrollPane

protected javax.swing.JScrollPane listScrollPane

tabCount

protected int tabCount

jSplitPane1

protected javax.swing.JSplitPane jSplitPane1

tabAttributeList

protected AttributeList[] tabAttributeList

currentAttributeList

protected AttributeList currentAttributeList

panelSelectButtons

protected javax.swing.JPanel panelSelectButtons

panelButtons

protected javax.swing.JPanel panelButtons

buttonList

protected MustButton buttonList

buttonNew

protected MustButton buttonNew

buttonPresent

protected MustButton buttonPresent

buttonChoose

protected MustButton buttonChoose

buttonProperties

protected MustButton buttonProperties

buttonCopy

protected MustButton buttonCopy

buttonPrint

protected MustButton buttonPrint

buttonDelete

protected MustButton buttonDelete

buttonClose

protected MustButton buttonClose

globalSearchTextField

protected MustTextField globalSearchTextField

searchCombination

protected RadioButtonPanel searchCombination

logic

protected RadioButtonPanel logic

searchElements

protected java.util.Vector<SearchElement> searchElements

expertSearchTextArea

protected MustTextArea expertSearchTextArea

printInstance

protected DataPropertyPrint printInstance

presentationInstance

protected DataPresentation presentationInstance

lastSelectionIdentifier

protected Identifier lastSelectionIdentifier

inquiryHistory

protected InquiryHistory inquiryHistory

Constructor Detail

AbstractDataListFrame

public AbstractDataListFrame(java.awt.Frame ownerFrame)

Constructs a new frame for selecting data.

Parameters:

ownerFrame - the frame form where this frame is called

Method Detail

createButton

protected MustButton createButton(java.lang.String imageName,
                                  java.lang.String defaultLabel,
                                  java.lang.String toolTipText)

append

protected void append(MustButton button)

Appends the passed button to the current AttributeList.

Parameters:

button - the button to add

creationEnding

protected void creationEnding()

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.

getTerritory

protected java.lang.String getTerritory()

Returns the territory of this function. Override this method if it differs from standard territory.

Returns:

the territory of this function

setEditable

protected void setEditable(boolean editable)

isEditable

protected boolean isEditable()

getInitialXLocation

protected int getInitialXLocation()

Returns the initial horizontal location.

Returns:

the initial horizontal location

setInitialXLocation

protected void setInitialXLocation(int newInitialXLocation)

Sets the initial horizontal location.

Parameters:

newInitialXLocation - the new initial horizontal location

getInitialYLocation

protected int getInitialYLocation()

Returns the initial vertical location.

Returns:

the initial vertical location

setInitialYLocation

protected void setInitialYLocation(int newInitialYLocation)

Sets the initial vertical location.

Parameters:

newInitialYLocation - the new initial vertical location

setMaxListEntries

public static void setMaxListEntries(int newMaxListEntries)

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

Parameters:

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

setMaxListEntriesIndividual

public void setMaxListEntriesIndividual(int newMaxListEntriesIndividual)

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

Parameters:

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

getMaxListEntries

protected static 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

setAssociatedPropertyAdministration

protected void setAssociatedPropertyAdministration(DataPropertyAdministration associatedPropertyAdministration)

Sets the associated property administration. This is the suitable instance to edit details of an entry selected in this list.

Parameters:

associatedPropertyAdministration - the associated property administration

setAssociatedPropertyAdministration

protected void setAssociatedPropertyAdministration(java.lang.Class<? extends DataPropertyAdministration> associatedPropertyAdministrationClass)

Sets the associated property administration class. This is the suitable class to edit details of an entry selected in this list.

Parameters:

associatedPropertyAdministrationClass - the associated property administration class

getAssociatedPropertyAdministration

protected DataPropertyAdministration getAssociatedPropertyAdministration()

Returns the associated property administration.

Returns:

associated property administration

setListDataObject

protected void setListDataObject(DataObject listDataObject)

Sets the data object to be used to fill the list. will become deprecated, use createListDataObjects(DataObjectConstructionDetails) instead because it provides private DB connection for each thread

Parameters:

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

resetListDataObjectWrapper

protected void resetListDataObjectWrapper()

getListDataObject

protected DataObject getListDataObject()

Returns the data object used to fill the list according to user's query.

Returns:

the data object used to fill the list according to user's query

packIfNotLaidOut

protected void packIfNotLaidOut()

Description copied from class: MustFrame

Packs the frame if it isn't already laid-out by user.

Overrides:

packIfNotLaidOut in class MustFrame

getListModification

protected int getListModification()

Returns the list modification case which may be LIST_MODIFICATION_APPEND, LIST_MODIFICATION_UPDATE or LIST_MODIFICATION_REMOVE

Returns:

the list modification case

newPanel

protected void newPanel()

Creates a new panel and adds it to the tabbed pane with a list for row subselection.

newPanel

protected void newPanel(java.lang.String tabLabel)

Creates a new panel and adds it to the tabbed pane with a list for row subselection.

Parameters:

tabLabel - the label of the new tab

newDynamicSearchPanel

protected void newDynamicSearchPanel(java.lang.String tabLabel,
                                     int elementAmount,
                                     java.util.Vector<SearchItem> searchItems)

Constructs a new dynamic search panel

Parameters:

tabLabel - the label of the new tab

elementAmount - the amount of elements to be created

searchItems - the search items - available columns where user can query

newDynamicSearchPanel

protected void newDynamicSearchPanel(java.lang.String tabLabel,
                                     int elementAmount,
                                     SearchItem[] columns)

Constructs a new dynamic search panel

Parameters:

tabLabel - the label of the new tab

elementAmount - the amount of elements to be created

columns - the search items - available columns where user can query

newPanelWithExpertSearchTextArea

protected void newPanelWithExpertSearchTextArea(java.lang.String tabLabel)

Adds an expert search panel to the tabbed pane.

Parameters:

tabLabel - the label of the new expert search tab

newPanel

protected void newPanel(java.lang.String tabLabel,
                        MustMultChoice multChoice,
                        java.awt.Dimension preferedSize)

Adds a panel with multiple choice selection.

Parameters:

tabLabel - the label of the new tab

multChoice - multiple choice to be presented

preferedSize - the preferred size of the scroll pane

createComboBox

protected HalfDataComboBox createComboBox(java.lang.String dataLabel,
                                          DataObject sourceDataObject,
                                          java.lang.String visibleColumn)

Creates a combo box in the same line as previously used.

Parameters:

dataLabel - the line label.

sourceDataObject - the source data object that shall fill the content of the combo box

visibleColumn - the column to be used to fill the combo box from the source data object

Returns:

the created combo box

createComboBox

protected HalfDataComboBox createComboBox(java.lang.String dataLabel,
                                          DataObject sourceDataObject,
                                          java.lang.String visibleColumn,
                                          java.lang.String orderByColumn)

Creates a combo box in the same line as previously used.

Parameters:

dataLabel - the line label.

sourceDataObject - the source data object that shall fill the content of the combo box

visibleColumn - the column to be used to fill the combo box from the source data object

orderByColumn - the column to be ordered by

Returns:

the created combo box

createComboBox

protected HalfDataComboBox createComboBox(java.lang.String dataLabel,
                                          DataObject sourceDataObject,
                                          java.lang.String visibleColumn,
                                          java.lang.String orderByColumn,
                                          java.lang.String nameForNoChoice)

Creates a combo box in the same line as previously used.

Parameters:

dataLabel - the line label.

sourceDataObject - the source data object that shall fill the content of the combo box

visibleColumn - the column to be used to fill the combo box from the source data object

orderByColumn - the column to be ordered by

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

Returns:

the created combo box

createVariableChoice

protected VariableChoice createVariableChoice(java.lang.String dataLabel,
                                              java.lang.String[][] content)

Creates a new variable choice with static content.

Parameters:

dataLabel - the line label.

content - the static content as a key / value table

Returns:

the created variable choice

createVariableChoice

protected VariableChoice createVariableChoice(java.lang.String dataLabel,
                                              java.lang.String[][] content,
                                              boolean noChoicePossible)

Creates a new variable choice with static content.

Parameters:

dataLabel - the line label.

content - the static content as a key / value table

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

Returns:

the created variable choice

createVariableChoice

protected VariableChoice createVariableChoice(java.lang.String dataLabel,
                                              java.lang.String[][] content,
                                              boolean noChoicePossible,
                                              boolean suppressKey)

Creates a new variable choice with static content.

Parameters:

dataLabel - the line label.

content - the static content as a key / value table

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

suppressKey - whether or not keys should be suppressed in ComboBox

Returns:

the created variable choice

createVariableChoice

protected VariableChoice createVariableChoice(java.lang.String dataLabel,
                                              KeyValuePair[] keyValuePairs)

Constructs an new variable choice with the specified content.

Parameters:

dataLabel - the line label.

keyValuePairs - the content as an array of key value pairs

Returns:

the created variable choice

createVariableChoice

protected VariableChoice createVariableChoice(java.lang.String dataLabel,
                                              KeyValuePair[] keyValuePairs,
                                              java.lang.String nameForNoChoice)

Constructs an new variable choice with the specified content.

Parameters:

dataLabel - the line label.

keyValuePairs - the content as an array of key value pairs

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

Returns:

the created variable choice

createRadioButtons

protected RadioButtonPanel createRadioButtons(java.lang.String label,
                                              KeyValuePair[] content)

Creates a radio button group in a new line.

Parameters:

label - the label of the new line

columnName - the name of the column to connect to

content - the content described by an array of KeyValuePair

Returns:

the created database connected

createTextFieldForGlobalSearch

protected void createTextFieldForGlobalSearch(java.lang.String label,
                                              int length)

Creates a new text field for global search.

Parameters:

label - the line label

length - the length of the global search text field

createTextFieldForGlobalSearch

protected void createTextFieldForGlobalSearch(java.lang.String label,
                                              int length,
                                              boolean chooseAndOr)

Creates a new text field for global search.

Parameters:

label - the line label

length - the length of the global search text field

chooseAndOr - whether or not user can choose AND or OR - caution: query could become to complex for some databases!

createTextField

protected MustTextField createTextField(java.lang.String label,
                                        int length)

Creates a new text field.

Parameters:

label - the line label

length - the length of the text field

Returns:

the created text field

createTextField

protected MustTextField createTextField(java.lang.String label,
                                        int length,
                                        DataObjectHolder.Creator choiceContentCreator,
                                        java.lang.String columnName)

Creates a new text field.

Parameters:

label - the line label

length - the length of the text field

choiceContentCreator - the creator of the data object which contains valid items

sourceColumnName - the name of the column containing the valid items

Returns:

the created text field

createTextField

protected MustTextField createTextField(int length)

Creates a text input field in the same line as previously used.

Parameters:

length - the length of the field

Returns:

the created text input field

createFragmentExactChoice

protected RadioButtonPanel createFragmentExactChoice()

createDateField

protected MustDateField createDateField(java.lang.String label)

Creates a date input field in a new line.

Parameters:

label - the line label

Returns:

the created date input field

createDateField

protected MustDateField createDateField()

Creates a date input field in the same line as previously used.

Returns:

the created date input field

createIntField

protected MustIntField createIntField(java.lang.String label,
                                      int length)

Creates a int field in a new line with its describing label.

Parameters:

label - the line label

length - the length of the field

Returns:

the created int field

createIntField

protected MustIntField createIntField(int length)

Creates a int input field in the same line as previously used.

Parameters:

length - the length of the field

Returns:

the created int field

createCheckBox

protected MustCheckBox createCheckBox(java.lang.String label,
                                      java.lang.String checkText)

createCheckBox

protected MustCheckBox createCheckBox(java.lang.String checkText)

createCleartextClassification

protected CleartextClassification createCleartextClassification(java.lang.String label,
                                                                SelfChainingDataObject sourceDataObject,
                                                                java.lang.String visibleColumnName,
                                                                int depth)

getIdentifiers

public abstract Identifier[] getIdentifiers()

createOrRecoverPropertyAdministration

protected void createOrRecoverPropertyAdministration()

Creates or recovers the associated property administration frame

getSelectedTab

public int getSelectedTab()

Returns the selected tab of the tabbed pane.

Returns:

the selected tab of the tabbed pane

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.

isConnectionOpen

protected boolean isConnectionOpen()

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Controls action events like button pressed.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Parameters:

e - the action event to be interpreted

isInputAccepted

protected boolean isInputAccepted()

Returns true if user input is accepted.

Returns:

true if user input is accepted

isChoosingAllowed

protected boolean isChoosingAllowed()

Returns true if the user may choose the presented entries. To be overridden by child if needed!

Returns:

true if the user may choose the presented entries

isModificationAllowed

protected boolean isModificationAllowed()

Returns true if the user may modify the presented entries. To be overridden by child if needed!

Returns:

true if the user may modify the presented entries

isCurrentListingCanceled

protected boolean isCurrentListingCanceled()

listButtonAction

protected void listButtonAction()

The task to be done associated with the list button.

propertyButtonAction

protected void propertyButtonAction()

The task to be done associated with the property button.

presentButtonAction

protected void presentButtonAction()

The task to be done associated with the present button.

chooseButtonAction

protected void chooseButtonAction()

The task to be done associated with the choose button.

copyButtonAction

protected void copyButtonAction()

The task to be done associated with the copy button.

deleteButtonAction

protected void deleteButtonAction()

The task to be done associated with the delete button.

delete

protected boolean delete(Identifier identifier)

printButtonAction

protected void printButtonAction()

The task to be done associated with the print button.

reset

protected void reset()

acceptsClosingDueToInactivity

public boolean acceptsClosingDueToInactivity()

Description copied from class: MustFrame

Returns true if frame accepts closing due to inactivity.

Specified by:

acceptsClosingDueToInactivity in class MustFrame

Returns:

true if frame accepts closing due to inactivity

isClosingAllowed

public boolean isClosingAllowed(int closeConfirmId)

Description copied from class: MustFrame

Returns true if closing of the window is allowed.

Specified by:

isClosingAllowed in class MustFrame

Parameters:

closeConfirmId - the ID of the confirmation issue - a way to avoid multiple question regarding the same issue

Returns:

true if closing of the window is allowed

closeInstance

public void closeInstance()

Closes the frame and its associated frames and destroys them.

Overrides:

closeInstance in class MustFrame

newButtonAction

protected void newButtonAction()

The task to be done associated with the "new" button.

refreshList

public void refreshList()

Clears and fills the list in separate thread.

extendList

public void extendList()

Extends the list dynamically in thread.

createWhereCondition

protected WhereCondition createWhereCondition()

Returns a new where condition object ready to apply specific SQL dialect aspects - available after list button has been pressed first time, which is at least the case in method getWhereCondition().

Returns:

a new where condition object

select

protected boolean select()

Transfers the select relevant specification to the data object. In general, the expert condition contains the where condition without the word where. But to support joins and other difficult select statements, there's a second way of usage: if the expert expression contains "select", then it is treated as the complete select statement. If so, it has to contain the entire stuff to get the right result.

createListDataObjectIfNull

protected void createListDataObjectIfNull()

createListDataObjects

protected DataObject createListDataObjects(DataObjectConstructionDetails docd)

Creates the main list data objects and other data object while list thread is executing and returns the main list data object. Thus, these data object may use different database connection if configured.

Parameters:

docd - the data object construction details (e.g. connection) to be used for all list data objects

Returns:

the main list data object.

getNotFoundNotification

protected java.lang.String getNotFoundNotification()

Returns the text to notify the user that no entry is matching the selection.

Returns:

the text to notify the user that no entry is matching the selection

run

public void run()

Execution of the list thread.

Specified by:

run in interface java.lang.Runnable

resetExtensionMode

protected void resetExtensionMode()

Resets extension mode. Called in cases where extension cannot be continued, e.g. after appending an entry which has been recorded right now.

fillList

protected void fillList()

Fills the List according to the specified criteria.

extendListAsThread

protected void extendListAsThread()

Extends list.

getElaboratedWhereCondition

public java.lang.String getElaboratedWhereCondition()

Returns the where condition.

Returns:

the where condition

getPrivateWhereConditionNotExpert

protected java.lang.String getPrivateWhereConditionNotExpert()

getPrintClass

protected java.lang.Class<? extends DataPropertyPrint> getPrintClass()

Returns the print class - to be overridden by child if print class is available!

Returns:

the print class

getPresentationClass

protected java.lang.Class<? extends DataPresentation> getPresentationClass()

Returns the presentation class - to be overridden by child if presentation class is available!

Returns:

the presentation class

getSelectionFields

protected 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

getAdditionalWhereConditionForGlobalSearch

protected java.lang.String getAdditionalWhereConditionForGlobalSearch()

Returns additional where conditions for global search. By default, null is returned. Override method to extend search by e.g. expression 'myKey in (select myKey in keyTable where fieldOfKeyTable like '%" + globalSearchTextField.getText()+ "%'))'

Returns:

additional where conditions for global search

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

getSelectedIdentifier

protected abstract Identifier getSelectedIdentifier()

Returns the identifier (primary key) of the selected row.

Returns:

the identifier (primary key) of the selected row

getSelectedIdentifiers

protected abstract Identifier[] getSelectedIdentifiers()

Returns the identifiers (primary keys) of the selected rows.

Returns:

the identifiers (primary keys) of the selected rows

getSelectedIdentifierVector

protected java.util.Vector<Identifier> getSelectedIdentifierVector()

Returns the identifiers (primary keys) of the selected rows omitting negative values which are used for sub-headers.

Returns:

the identifiers (primary keys) of the selected rows

getSelectedItem

protected abstract java.lang.String getSelectedItem()

Returns the selected item.

Returns:

the selected item

getSelectedItems

protected abstract java.lang.String[] getSelectedItems()

Returns the selected items.

Returns:

the selected items

clearSelection

protected abstract void clearSelection()

Clears the selection.

resetList

protected void resetList()

Resets the list by resetting extension mode plus removing all items of the list. May be used if search condition have been changed programmatically.

removeAllOfTheList

protected abstract void removeAllOfTheList()

Removes all items of the table.

beginListFill

protected abstract void beginListFill()

Beginning of list fills into a list model which is not currently assigned to the view. Activation of the model is done via completeListFill().

See Also:

completeListFill()

appendListEntry

protected abstract void appendListEntry()

Adds an entry at the end of the table.

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:

beginListFill()

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

getListItemCount

protected abstract int getListItemCount()

Returns the number of items in the table.

Returns:

the number of items in the table

requestListingFocus

protected abstract void requestListingFocus()

Request the focus to the list.

getSelectedIndex

protected abstract int getSelectedIndex()

Returns the index of the selected item.

Returns:

the index of the selected item

selectListIndex

protected abstract void selectListIndex(int indexToSelect)

Selects an entry of the list by index.

Parameters:

indexToSelect - the index to be selected

setSelectedIdentifier

public abstract void setSelectedIdentifier(Identifier identifier)

Selects an item of the list / a row by identifier.

Parameters:

identifier - the identifier of the item to be selected

beginOfListThread

protected abstract void beginOfListThread()

Called when list thread begins.

beginListExtension

protected abstract void beginListExtension()

endOfListThread

protected abstract void endOfListThread()

Called when list thread ends.

receive

public void receive(java.lang.String message)

Specified by:

receive in interface MessageReceiver

delayedInititialActions

protected void delayedInititialActions()

Workaround: called a little bit later than the initial time.

free

protected void free()

Description copied from class: MustFrame

Frees (releases) references caused by this frame, particularly static register entries. To be called via destroy() to prevent multiple call. Override it to do additional releases and don't forget to call super.free() at the end.

Overrides:

free in class MustFrame

See Also:

MustFrame.destroy(), MustFrame.isRevivable()