com.lf.commons.docking.db

Class DatabaseSessionWindow

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

com.lf.commons.docking.tabbed.TabbedWindow

com.lf.commons.docking.db.DatabaseSessionWindow

All Implemented Interfaces:

DockingWindow, ActionDelegate, ConfigurableUnit, java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ChangeListener, javax.swing.event.PopupMenuListener

public class DatabaseSessionWindow
extends TabbedWindow

Docking window to implement database sessions based on connectors.

Connector instances together with the underlying DatabaseManager can be used to integrate databases on an abstract level. The only possible tab instances to be integrated here must be of the type SessionTab.

Since:

1.6

Version:

$Revision: 1.8 $, $Date: 2012/12/28 11:44:25 $

Author:

Axel Schwolow

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JPanel.AccessibleJPanel

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected DatabaseSessionController	controller Instance processing the GUI callbacks (MVC controller).
protected CollapsibleOptionsView	filterOptions The optional component with filter options.
protected java.util.Date	lastRun The timestamp when the update task was executed.
protected TableSearchOptionsView	searchOptions The optional component with search options.
protected java.util.Vector<java.lang.Runnable>	tasks Additional task to be executed with the updater task (optional).
protected java.lang.Runnable	updater The current update task (no thread!).

Fields inherited from class com.lf.commons.docking.tabbed.TabbedWindow

autoHide, cacheTabByID, cacheTabByRenderer, counter, helpID, iconError, maxTitleLength, popupListener, popupMenu, previous, tabbedPane, windowParams

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
DatabaseSessionWindow() Constructor for the GUI component.
DatabaseSessionWindow(java.lang.String title, java.lang.String tooltip) Constructor for the GUI component.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	addTab(TabbedWindowTab tab) Adds a new tab for the tabbed pane (must be of the type SessionTab).
void	addTask(java.lang.Runnable task) Adds an additional task to be executed with the updater task (optional)
protected void	finalize() Cares for proper cleanup after releasing the object.
TabbedWindowTab	findTab(DatabaseConnector connector) Provides the parental tab for a connector.
DatabaseConnector[]	getAllConnectedConnectors() Provides all managed connectors currently connected.
DatabaseConnector[]	getAllConnectedUniqueConnectors() Provides all managed connectors currently connected (only one instance per connection).
DatabaseConnector[]	getAllConnectors() Provides all managed connectors.
DatabaseConnector	getSelectedConnector() Provides the tabbed pane selection (connector).
void	removeTask(java.lang.Runnable task) Removes an existing task to be executed with the updater task (optional)
void	setFilterOptions(CollapsibleOptionsView tab) Sets the filter options component (options).
void	setSearchOptions(TableSearchOptionsView tab) Sets the search options component (options).
void	windowBecomesHidden(int location) Informs the docking window that it will be made invisible by the manager.
void	windowBecomesShown(int location) Informs the docking window that it will be made visible by the manager.

Methods inherited from class com.lf.commons.docking.tabbed.TabbedWindow

actionPerformed, addTabChangeListener, closeAllTabs, closeOtherTabs, closeSelectedTab, configureUnit, findTab, findTab, findTab, getActionDelegate, getComponent, getDockingManager, getIcon, getID, getMode, getPreferredHeight, getPreferredWidth, getSelectedTab, getSelectedTabID, getSupportedActions, getTabRenderer, getTitle, getToolTip, getWindowHeight, getWindowLocation, getWindowLocationX, getWindowLocationY, getWindowState, getWindowWidth, isAutomatic, isButtonPressed, isButtonVisible, isGrowing, isWindowMode, isWindowVisible, popupMenuCanceled, popupMenuWillBecomeInvisible, popupMenuWillBecomeVisible, processAction, refresh, removeTab, removeTab, removeTabChangeListener, setAutomatic, setButtonPressed, setButtonVisible, setErrorState, setGrowing, setHelpID, setID, setMode, setPreferredHeight, setPreferredWidth, setSelectedTab, setSelectedTab, setToolTipTextForTab, setWindowHeight, setWindowLocationX, setWindowLocationY, setWindowMode, setWindowState, setWindowVisible, setWindowWidth, startControl, stateChanged, stopControl, storeUnit, unitRegistered, unitUnregistered, updateTabIcons, updateTabTexts, updateTabToolTips, windowAdded, windowIsActive, windowIsHiding, windowIsInactive, windowIsShowing, windowRemoved

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

updater

protected java.lang.Runnable updater

The current update task (no thread!).

lastRun

protected java.util.Date lastRun

The timestamp when the update task was executed.

searchOptions

protected TableSearchOptionsView searchOptions

The optional component with search options.

filterOptions

protected CollapsibleOptionsView filterOptions

The optional component with filter options.

controller

protected DatabaseSessionController controller

Instance processing the GUI callbacks (MVC controller).

tasks

protected java.util.Vector<java.lang.Runnable> tasks

Additional task to be executed with the updater task (optional).

Constructor Detail

DatabaseSessionWindow

public DatabaseSessionWindow()

Constructor for the GUI component.

Since:

1.6

DatabaseSessionWindow

public DatabaseSessionWindow(java.lang.String title,
                     java.lang.String tooltip)

Constructor for the GUI component.

Parameters:

title - The window title

tooltip - The window tooltip

Since:

1.6

Method Detail

finalize

protected void finalize()
                 throws java.lang.Throwable

Cares for proper cleanup after releasing the object.

Overrides:

finalize in class TabbedWindow

Throws:

java.lang.Throwable

Since:

1.6

addTab

public java.lang.String addTab(TabbedWindowTab tab)

Adds a new tab for the tabbed pane (must be of the type SessionTab).

Overrides:

addTab in class TabbedWindow

Parameters:

tab - The new tab to be added

Returns:

Unique ID

Throws:

java.lang.NullPointerException - If parameter is null

java.lang.IllegalArgumentException - If parameter is invalid

Since:

1.6

windowBecomesShown

public void windowBecomesShown(int location)

Informs the docking window that it will be made visible by the manager.

Specified by:

windowBecomesShown in interface DockingWindow

Overrides:

windowBecomesShown in class TabbedWindow

Parameters:

location - The location (TOP, BOTTOM, LEFT, RIGHT)

Since:

1.6

windowBecomesHidden

public void windowBecomesHidden(int location)

Informs the docking window that it will be made invisible by the manager.

Specified by:

windowBecomesHidden in interface DockingWindow

Overrides:

windowBecomesHidden in class TabbedWindow

Parameters:

location - The location (TOP, BOTTOM, LEFT, RIGHT)

Since:

1.6

findTab

public TabbedWindowTab findTab(DatabaseConnector connector)

Provides the parental tab for a connector.

Parameters:

connector - The desired connector

Returns:

The parental tab or null if not available

Since:

1.6

setSearchOptions

public void setSearchOptions(TableSearchOptionsView tab)

Sets the search options component (options).

The various session tabs use this global reference. This reference must be set before any tabs are added since listeners are installed for new session tabs.

Parameters:

tab - The search options component

Since:

1.6

setFilterOptions

public void setFilterOptions(CollapsibleOptionsView tab)

Sets the filter options component (options).

The various session tabs use this global reference. This reference must be set before any tabs are added since listeners are installed for new session tabs.

Parameters:

tab - The filter options component

Since:

1.6

getSelectedConnector

public DatabaseConnector getSelectedConnector()

Provides the tabbed pane selection (connector).

Returns:

The selected connector or null if not available

Since:

1.6

getAllConnectors

public DatabaseConnector[] getAllConnectors()

Provides all managed connectors.

Returns:

The connectors, may have zero-length

Since:

1.6

getAllConnectedConnectors

public DatabaseConnector[] getAllConnectedConnectors()

Provides all managed connectors currently connected.

Returns:

The connectors, may have zero-length

Since:

1.6

getAllConnectedUniqueConnectors

public DatabaseConnector[] getAllConnectedUniqueConnectors()

Provides all managed connectors currently connected (only one instance per connection).

Returns:

The connectors, may have zero-length

Since:

1.6

addTask

public void addTask(java.lang.Runnable task)

Adds an additional task to be executed with the updater task (optional)

Parameters:

task - The new task to be added

Throws:

java.lang.NullPointerException - If parameter is null

Since:

1.6

removeTask

public void removeTask(java.lang.Runnable task)

Removes an existing task to be executed with the updater task (optional)

Parameters:

task - The task to be removed

Throws:

java.lang.NullPointerException - If parameter is null

Since:

1.6