de.must.wuic

Class DataTableAdministration

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

de.must.wuic.DataTableAdministration

All Implemented Interfaces:

AppTextResource, ContextHelp, java.awt.event.ActionListener, java.awt.event.ComponentListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

Direct Known Subclasses:

DataClassificationAdministration

public abstract class DataTableAdministration
extends TableAdministration

Frame for administration of an entire entity in a single grid. Suitable for entities with few columns and rows. Controls load and save actions. Used for property administration of a multiple database records. It is meant to contain several data components like e.g. DataTextField.

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 DataObject	assignedDataObject
protected DataTableModel	mainTableModel

Fields inherited from class de.must.wuic.TableAdministration

buttonCancel, buttonDel, buttonOk, isLaidOut, panelBottom, panelButtons, statusLabel, table

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
DataTableAdministration()
DataTableAdministration(java.awt.Frame parentFrame) Constructs a new data table administration.

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 boolean	apply() Save values as edited if input is accepted without closing.
protected void	buttonDelEvent() Executed when delete button is pressed.
protected void	ButtonOkEvent() Executed when OK button is pressed.
void	closeInstance() Closes the frame and destroys it.
protected MustTable	createTable(DataTableModel newDataTableModel) Creates a new administration grid based on the specified table model.
void	generalActionBeginnung() Initializes things before an action begins like resetting the status label.
protected void	generalActionEnding() Concludes things after an action ended like resetting the status label to its default value.
protected abstract DataObject	getAssignedDataObject() Returns the assigned data object for loading and saving.
protected java.lang.String[]	getColumnLabels() Returns the labels of the columns to be laid-out.
protected abstract java.lang.String[]	getColumnNames() Returns the names of the columns to be laid-out.
protected java.lang.String	getFilterCondition()
protected int[]	getPreferedColumnSize() Returns the preferred column sizes.
boolean	isCancelAllowed() Returns true if it is allowed to cancel the dialog.
boolean	isClosingAllowed(int closeConfirmId) Returns true if closing of the window is allowed.
protected boolean	isInputAccepted() Returns true if user input is accepted.
protected abstract boolean	isInUse(Identifier identifier) Returns true if the entry as specified by the identifier is in use.
void	loadValues() Loads an entity specified by a primary key integer value.
protected int	markNotUsed() Selects table rows which represent entries that are not in use, e.g. to remove them,
protected void	packIfNotLaidOut() Packs the frame if it isn't already laid-out by user.
protected void	reInitialize() Called after a main instance of the requested frame class was found to initialize the appearance.
protected void	setColumnToolTip(int column, java.lang.String toolTipText) Sets the column's tool tip text.
protected void	setMessageToKeep(java.lang.String messageToKeep)
protected void	stopCellEditing()

Methods inherited from class de.must.wuic.TableAdministration

select

Methods inherited from class de.must.wuic.MustFrame

adjustSizeToPlausibleValue, bringToFrontAll, closeAll, closeAll, closeAllDueToInactivity, closeMainInstance, componentHidden, componentMoved, componentResized, componentShown, deiconifyAllExept, deregisterAsMainInstance, destroy, finalize, free, getAppResStr, getFrame, getHelpTarget, getHelpTopic, getLocale, getOrCreateMainInstance, getOrCreateMainInstance, getTranslation, iconifyAllExept, isCached, isClosingAllowedForAllFrames, isLaidOut, isRevivable, locateInCenter, logDebug, logError, logError, logError, logInfo, maximizeToBottomAndRight, open, packAndLocateInCenter, packAndLocateInCenterIfNotLaidOut, popupMessage, 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

assignedDataObject

protected DataObject assignedDataObject

mainTableModel

protected DataTableModel mainTableModel

Constructor Detail

DataTableAdministration

public DataTableAdministration()

DataTableAdministration

public DataTableAdministration(java.awt.Frame parentFrame)

Constructs a new data table administration.

Parameters:

parentFrame - the frame's parent frame

Method Detail

reInitialize

protected void reInitialize()

Description copied from class: MustFrame

Called after a main instance of the requested frame class was found to initialize the appearance.

Overrides:

reInitialize in class MustFrame

See Also:

MustFrame.reInitialize()

getAssignedDataObject

protected abstract DataObject getAssignedDataObject()

Returns the assigned data object for loading and saving.

Returns:

the assigned data object

getColumnNames

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

Returns the names of the columns to be laid-out.

Returns:

the names of the columns to be laid-out

getColumnLabels

protected java.lang.String[] getColumnLabels()

Returns the labels of the columns to be laid-out.

Returns:

the labels of the columns to be laid-out

getPreferedColumnSize

protected int[] getPreferedColumnSize()

Returns the preferred column sizes. To be overridden to layout columns differing from standard.

Returns:

the preferred column sizes

packIfNotLaidOut

protected void packIfNotLaidOut()

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

Overrides:

packIfNotLaidOut in class MustFrame

createTable

protected MustTable createTable(DataTableModel newDataTableModel)

Creates a new administration grid based on the specified table model. Available for individual needs - standard is just defining getColumnNames() and getColumnLabels().

Parameters:

newDataTableModel - the data table model to be used for the grid

Returns:

the created table

setColumnToolTip

protected void setColumnToolTip(int column,
                                java.lang.String toolTipText)

Sets the column's tool tip text.

Parameters:

column - the name of the column

toolTipText - the column's tool tip text

actionPerformed

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

Controls action events like button pressed.

Parameters:

e - the action event to be interpreted

generalActionBeginnung

public void generalActionBeginnung()

Initializes things before an action begins like resetting the status label.

Overrides:

generalActionBeginnung in class MustFrame

generalActionEnding

protected void generalActionEnding()

Concludes things after an action ended like resetting the status label to its default value.

loadValues

public void loadValues()

Loads an entity specified by a primary key integer value.

Parameters:

identifyValue - the primary key integer value.

getFilterCondition

protected java.lang.String getFilterCondition()

buttonDelEvent

protected void buttonDelEvent()

Executed when delete button is pressed.

isInUse

protected abstract boolean isInUse(Identifier identifier)

Returns true if the entry as specified by the identifier is in use.

Parameters:

keyIdentifier - the identifier of the entry to be checked

Returns:

true if the entry is in use

ButtonOkEvent

protected void ButtonOkEvent()

Executed when OK button is pressed.

setMessageToKeep

protected void setMessageToKeep(java.lang.String messageToKeep)

apply

protected boolean apply()

Save values as edited if input is accepted without closing.

Returns:

true if input is accepted

markNotUsed

protected int markNotUsed()

Selects table rows which represent entries that are not in use, e.g. to remove them,

Returns:

the number of selected entries

isInputAccepted

protected boolean isInputAccepted()

Returns true if user input is accepted. Override this method to implement individual input checks.

Returns:

true if user input is accepted

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

isCancelAllowed

public boolean isCancelAllowed()

Returns true if it is allowed to cancel the dialog.

Returns:

true if it is allowed to cancel the dialog

stopCellEditing

protected void stopCellEditing()

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 destroys it.

Overrides:

closeInstance in class MustFrame