Package adams.gui.selection

Class AbstractDatabaseSelectionDialog<T,P extends AbstractDatabaseSelectionPanel>

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

javax.swing.JDialog

adams.gui.core.BaseDialog

adams.gui.dialog.DialogWithButtons

adams.gui.dialog.ApprovalDialog

adams.gui.selection.AbstractSelectionDialog<T,P>

adams.gui.selection.AbstractTableBasedSelectionDialog<T,P>

adams.gui.selection.AbstractDatabaseSelectionDialog<T,P>

Type Parameters:

T - the type of item that can be selected

P - the type of selection panel

All Implemented Interfaces:

CleanUpHandler, DatabaseConnectionHandler, DatabaseConnectionProvider, DatabaseConnectionUser, DatabaseConnectionChangeListener, ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

Direct Known Subclasses:

AbstractSelectDatabaseFieldDialog

public abstract class AbstractDatabaseSelectionDialog<T,P extends AbstractDatabaseSelectionPanel>
extends AbstractTableBasedSelectionDialog<T,P>
implements DatabaseConnectionChangeListener, DatabaseConnectionHandler

Abstract ancestor for dialogs that allow the selection of items from a table, using a database as backend.

Version:

$Revision$

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Nested Class Summary

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

JDialog.AccessibleJDialog

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

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class adams.gui.selection.AbstractTableBasedSelectionDialog

m_Current

Fields inherited from class adams.gui.selection.AbstractSelectionDialog

m_Panel

Fields inherited from class adams.gui.dialog.ApprovalDialog

APPROVE_OPTION, CANCEL_OPTION, DISCARD_OPTION, m_ButtonApprove, m_ButtonCancel, m_ButtonDiscard, m_Option

Fields inherited from class adams.gui.dialog.DialogWithButtons

m_PanelButtons, m_PanelButtonsLeft, m_PanelButtonsRight

Fields inherited from class adams.gui.core.BaseDialog

m_AfterHideActions, m_AfterShowActions, m_BeforeHideActions, m_BeforeShowActions, m_DisposeCalled, m_LocationBeforeMaximize, m_SizeBeforeMaximize, m_UISettingsApplied, m_UISettingsPrefix, m_UISettingsStored

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, 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 java.awt.image.ImageObserver

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

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractDatabaseSelectionDialog(Dialog owner, String title)	Creates a modal dialog.
protected	AbstractDatabaseSelectionDialog(Frame owner, String title)	Creates a modal dialog.

Method Summary

Modifier and Type	Method	Description
void	addRefreshActionListener(ActionListener l)	Adds the given listener to the Refresh button.
protected void	beforeShow()	Hook method just before the dialog is made visible.
void	cleanUp()	Cleans up data structures, frees up memory.
void	databaseConnectionStateChanged(DatabaseConnectionChangeEvent e)	A change in the database connection occurred.
abstract AbstractDatabaseConnection	getDatabaseConnection()	Returns the currently used database connection object, can be null.
void	removeRefreshActionListener(ActionListener l)	Removes the given listener from the Refresh button.
abstract void	setDatabaseConnection(AbstractDatabaseConnection value)	Sets the database connection object to use.

Methods inherited from class adams.gui.selection.AbstractTableBasedSelectionDialog

beforeHide, finishInit, getItem, getItems, getPanel, initGUI, isMultipleSelection, newPanel, setItem, setItems, setMultipleSelection, update

Methods inherited from class adams.gui.dialog.ApprovalDialog

approveDialog, cancelDialog, checkInput, discardDialog, getApproveButton, getApproveCaption, getApproveMnemonic, getCancelButton, getCancelCaption, getCancelMnemonic, getConfirmationDialog, getConfirmationDialog, getConfirmationDialog, getConfirmationDialog, getDialog, getDialog, getDialog, getDialog, getDiscardButton, getDiscardCaption, getDiscardMnemonic, getInformationDialog, getInformationDialog, getInformationDialog, getInformationDialog, getOption, initialize, isApproveEnabled, isApproveVisible, isCancelEnabled, isCancelVisible, isDiscardEnabled, isDiscardVisible, setApproveCaption, setApproveEnabled, setApproveMnemonic, setApproveVisible, setCancelCaption, setCancelEnabled, setCancelMnemonic, setCancelVisible, setDiscardCaption, setDiscardEnabled, setDiscardMnemonic, setDiscardVisible

Methods inherited from class adams.gui.dialog.DialogWithButtons

getButtonsPanel, getButtonsPanel

Methods inherited from class adams.gui.core.BaseDialog

addAfterHideAction, addAfterShowAction, addBeforeHideAction, addBeforeShowAction, afterHide, afterShow, applyUISettings, canMaximize, canMinimize, dispose, executeAfterHideActions, executeAfterShowActions, executeBeforeHideActions, executeBeforeShowActions, getUISettingsApplied, getUISettingsPrefix, maximize, minimize, pack, removeAfterHideAction, removeAfterShowAction, removeBeforeHideAction, removeBeforeShowAction, setLocationRelativeTo, setUISettingsPrefix, setUISettingsPrefix, setVisible, storeUISettings

Methods inherited from class javax.swing.JDialog

addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, 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, setTitle, setUndecorated, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, 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, setLocation, setLocationByPlatform, setMinimumSize, setModalExclusionType, setSize, 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, 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

Constructor Detail

AbstractDatabaseSelectionDialog

protected AbstractDatabaseSelectionDialog(Dialog owner,
                                          String title)

Creates a modal dialog.

Parameters:

owner - the owning dialog

title - the title of the dialog

AbstractDatabaseSelectionDialog

protected AbstractDatabaseSelectionDialog(Frame owner,
                                          String title)

Creates a modal dialog.

Parameters:

owner - the owning frame

title - the title of the dialog

Method Detail

addRefreshActionListener

public void addRefreshActionListener(ActionListener l)

Adds the given listener to the Refresh button.

Parameters:

l - the listener to add

removeRefreshActionListener

public void removeRefreshActionListener(ActionListener l)

Removes the given listener from the Refresh button.

Parameters:

l - the listener to remove

beforeShow

protected void beforeShow()

Hook method just before the dialog is made visible.

Overrides:

beforeShow in class AbstractTableBasedSelectionDialog<T,P extends AbstractDatabaseSelectionPanel>

databaseConnectionStateChanged

public void databaseConnectionStateChanged(DatabaseConnectionChangeEvent e)

A change in the database connection occurred.

Specified by:

databaseConnectionStateChanged in interface DatabaseConnectionChangeListener

Parameters:

e - the event

getDatabaseConnection

public abstract AbstractDatabaseConnection getDatabaseConnection()

Returns the currently used database connection object, can be null.

Specified by:

getDatabaseConnection in interface DatabaseConnectionProvider

Returns:

the current object

setDatabaseConnection

public abstract void setDatabaseConnection(AbstractDatabaseConnection value)

Sets the database connection object to use.

Specified by:

setDatabaseConnection in interface DatabaseConnectionHandler

Parameters:

value - the object to use

cleanUp

public void cleanUp()

Cleans up data structures, frees up memory.

Specified by:

cleanUp in interface CleanUpHandler

Overrides:

cleanUp in class AbstractTableBasedSelectionDialog<T,P extends AbstractDatabaseSelectionPanel>