oracle.jdeveloper.db.panels
Class GlobalConnectionPanelUI

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  oracle.jdeveloper.db.panels.GlobalConnectionPanelUI

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible

Direct Known Subclasses:

GlobalDatabaseConnPanel.GlobalConnectionPanelUI2

public class GlobalConnectionPanelUI
extends javax.swing.JPanel

Component for selecting connections like ConnectionPanelUI, but rather than being limited to the central IDE connections store, this displays a picker that contains all connections from all available connection stores in the given Context.

Only use this component in a feature that is global to all database connections (e.g. SQL Worksheet) and not based solely in an application based technology. Use AppConnectionPanelUI for application based technologies.

The picker will contain connections from the current Application and the Resource Palette for all cases except for when the Database Navigator is the current View. In that case ALL Applications' connections and the IDE Connections are shown.

Since:

11

See Also:

Serialized Form

Nested Class Summary

static class

GlobalConnectionPanelUI.ChosenConnection Deprecated. - use ConnectionInfo

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

GlobalConnectionPanelUI()

GlobalConnectionPanelUI(boolean oracleOnly)

GlobalConnectionPanelUI(java.lang.String[] subTypes)

GlobalConnectionPanelUI(java.lang.String[] subTypes, boolean showDetails)

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e)
protected void	addButton(javax.swing.JPanel panel, javax.swing.JButton button, java.awt.GridBagConstraints gbc, java.lang.String tooltip, java.lang.String mnemonicText, java.lang.String name)
protected void	addButtons(javax.swing.JPanel panel, java.awt.GridBagConstraints gbc) This adds the buttons on the RHS of the connection combo box.
void	addComboListener(java.awt.event.ItemListener itemListener) Adds an ItemListener to this class to listen for changes to the chosen connection.
protected void	checkConnection() Checks the current selection is a connection name that exists in the underlying connections namespace and enables the buttons as appropriate, plus populates the details panel if this panel is in showDetails mode.
protected void	clearLastShownInfo() Calls to populateDetails are only made if the connection store/name change.
protected void	disableDetails() Disables all components in the details panel.
void	enableActiveComponents(boolean boo) Enables or disables the picker component, but not the descriptive text.
protected void	enableButtons(boolean validConn) Used to enable/disable buttons that require a valid connection to be selected for their enabled state.
protected java.lang.String	getComponentNamePrefix()
static ConnectionInfo	getConnection(ConnectionInfo connInfo) Invokes a dialog for selecting a connection.
static ConnectionInfo	getConnection(ConnectionInfo connInfo, boolean oraOnly, Context context) Invokes a dialog for selecting a connection.
static ConnectionInfo	getConnection(java.lang.String title, java.lang.String prompt, ConnectionInfo connInfo, boolean oraOnly, Context ideContext) Invokes a dialog for selecting a connection.
static ConnectionInfo	getConnection(java.lang.String title, java.lang.String prompt, java.lang.String storeName, java.lang.String connName) Deprecated. - use #getConnection(String,String,ConnectionInfo)
static ConnectionInfo	getConnection(java.lang.String title, java.lang.String prompt, java.lang.String storeName, java.lang.String connName, boolean oraOnly) Deprecated. - use #getConnection(String,String,ConnectionInfo,boolean)
ConnectionInfo	getConnectionInfo()
java.awt.Component	getDefaultFocusComponent()
protected javax.swing.JPanel	getDetailsPanel() Returns the details panel (only called if m_showDetails is true).
java.awt.Component	getPicker()
protected java.lang.String	getPromptText() Deprecated. - call setConnectionPrompt(java.lang.String) in a subclass constructor.
protected oracle.ideimpl.db.DBUIResourceHelper	getResourceHelper()
protected java.lang.String[]	getSubTypes() If the picker was setup to only list certain connection subtypes this returns the required list.
protected void	initialise() Initialises the layout.
protected void	launchConnectionDialog(boolean edit)
protected void	populateDetails(ConnectionInfo connInfo) Populates the details panel with the given connection information.
void	removeComboListener(java.awt.event.ItemListener itemListener) Removes a previously registered ItemListener from this picker.
void	setConnectionInfo(ConnectionInfo info) Sets the ConnectionInfo for the picker to use.
void	setConnectionLabel(java.lang.String label) Sets the label for the connection combo box.
void	setConnectionPrompt(java.lang.String prompt) Sets the prompt above the connection selection.
void	setContext(Context ideContext)
void	setEnabled(boolean boo)

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, 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, 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, transferFocusBackward, 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, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

GlobalConnectionPanelUI

public GlobalConnectionPanelUI()

GlobalConnectionPanelUI

public GlobalConnectionPanelUI(boolean oracleOnly)

GlobalConnectionPanelUI

public GlobalConnectionPanelUI(java.lang.String[] subTypes)

GlobalConnectionPanelUI

public GlobalConnectionPanelUI(java.lang.String[] subTypes,
                               boolean showDetails)

Method Detail

getComponentNamePrefix

protected java.lang.String getComponentNamePrefix()

getConnectionInfo

public final ConnectionInfo getConnectionInfo()

setConnectionInfo

public final void setConnectionInfo(ConnectionInfo info)

Sets the ConnectionInfo for the picker to use. There are two reasons for doing this:

• To pre-select a given connection
• To provide a ConnectionInfo that the chosen connection details will be set in on selection by the user

Once the selection has been made the given ConnectionInfo will automatically be populated with the user's choice.

Parameters:

info -

setContext

public final void setContext(Context ideContext)

getPicker

public final java.awt.Component getPicker()

launchConnectionDialog

protected final void launchConnectionDialog(boolean edit)

addComboListener

public void addComboListener(java.awt.event.ItemListener itemListener)

Adds an ItemListener to this class to listen for changes to the chosen connection.

removeComboListener

public void removeComboListener(java.awt.event.ItemListener itemListener)

Removes a previously registered ItemListener from this picker.

See Also:

addComboListener(ItemListener)

getConnection

@Deprecated
public static ConnectionInfo getConnection(java.lang.String title,
                                                      java.lang.String prompt,
                                                      java.lang.String storeName,
                                                      java.lang.String connName)

Deprecated. - use #getConnection(String,String,ConnectionInfo)

getConnection

@Deprecated
public static ConnectionInfo getConnection(java.lang.String title,
                                                      java.lang.String prompt,
                                                      java.lang.String storeName,
                                                      java.lang.String connName,
                                                      boolean oraOnly)

Deprecated. - use #getConnection(String,String,ConnectionInfo,boolean)

getConnection

public static ConnectionInfo getConnection(ConnectionInfo connInfo)

Invokes a dialog for selecting a connection. This only allows the user to select from both the IDE connections, and application's resources. To select from just application resources use AppConnectionPanelUI.getConnection(java.lang.String, java.lang.String, java.lang.String, boolean)

Parameters:

connInfo - the initially selected connection or null to use the default. If provided the chosen connection information will also be set here.

getConnection

public static ConnectionInfo getConnection(ConnectionInfo connInfo,
                                           boolean oraOnly,
                                           Context context)

Invokes a dialog for selecting a connection. This only allows the user to select from both the IDE connections, and application's resources. To select from just application resources use AppConnectionPanelUI.getConnection(java.lang.String, java.lang.String, java.lang.String, boolean)

Parameters:

connInfo - the initially selected connection or null to use the default. If provided the chosen connection information will also be set here.

ideContext - the current IDE context - this is used to determine which connection stores are appropriate for the user to choose from. null ensures all stores will be available.

oracleOnly - whether to only display Oracle connections.

getConnection

public static ConnectionInfo getConnection(java.lang.String title,
                                           java.lang.String prompt,
                                           ConnectionInfo connInfo,
                                           boolean oraOnly,
                                           Context ideContext)

Invokes a dialog for selecting a connection. This only allows the user to select from both the IDE connections, and application's resources. To select from just application resources use AppConnectionPanelUI.getConnection(java.lang.String, java.lang.String, java.lang.String, boolean)

Parameters:

title - the dialog title

prompt - the prompt string for the dialog

connInfo - the initially selected connection or null to use the default. If provided the chosen connection information will also be set here.

ideContext - the current IDE context - this is used to determine which connection stores are appropriate for the user to choose from. null ensures all stores will be available.

oracleOnly - whether to only display Oracle connections.

getSubTypes

protected java.lang.String[] getSubTypes()

If the picker was setup to only list certain connection subtypes this returns the required list.

initialise

protected void initialise()

Initialises the layout. This calls getPicker() to get the active picker Component for the panel.

getResourceHelper

protected oracle.ideimpl.db.DBUIResourceHelper getResourceHelper()

For internal use only. Application developers should not use this

addButtons

protected void addButtons(javax.swing.JPanel panel,
                          java.awt.GridBagConstraints gbc)

This adds the buttons on the RHS of the connection combo box. The gridx of the given constraints is incremented after every button is added so subclasses can add their own buttons after the default add/edit buttons this class defines.

addButton

protected void addButton(javax.swing.JPanel panel,
                         javax.swing.JButton button,
                         java.awt.GridBagConstraints gbc,
                         java.lang.String tooltip,
                         java.lang.String mnemonicText,
                         java.lang.String name)

getDetailsPanel

protected javax.swing.JPanel getDetailsPanel()

Returns the details panel (only called if m_showDetails is true). The default details panel displays the username, driver class name and url for the database connection. Override as necessary.

If overriden to return a non-standard panel, populateDetails(oracle.jdeveloper.db.ConnectionInfo) must also be overriden. In addition either disableDetails() should be overriden, or calling setEnabled on the returned JPanel should enable/disable all the detail components on the panel as well as the panel itself.

enableButtons

protected void enableButtons(boolean validConn)

Used to enable/disable buttons that require a valid connection to be selected for their enabled state. This is called when the selected connection changes.

Parameters:

validConn - whether the current selection contains a valid connection

enableActiveComponents

public void enableActiveComponents(boolean boo)

Enables or disables the picker component, but not the descriptive text.

setEnabled

public void setEnabled(boolean boo)

Overrides:

setEnabled in class javax.swing.JComponent

checkConnection

protected void checkConnection()

Checks the current selection is a connection name that exists in the underlying connections namespace and enables the buttons as appropriate, plus populates the details panel if this panel is in showDetails mode.

See Also:

enableButtons(boolean), populateDetails(oracle.jdeveloper.db.ConnectionInfo)

clearLastShownInfo

protected final void clearLastShownInfo()

Calls to populateDetails are only made if the connection store/name change. If the details of the currently selected connection are changed (e.g. via the edit dialog) then this method must be called prior to calling checkConnection().

disableDetails

protected void disableDetails()

Disables all components in the details panel. By default this calls setEnabled( false ) on the details panel (returned by getDetailsPanel()). If that will not disable all the components on the details panel this method should be overridden to do that. The details panel should be enabled when populateDetails(oracle.jdeveloper.db.ConnectionInfo) is called with a ConnectionInfo.

populateDetails

protected void populateDetails(ConnectionInfo connInfo)

Populates the details panel with the given connection information. This is called by checkConnection()

getPromptText

@Deprecated
protected java.lang.String getPromptText()

Deprecated. - call setConnectionPrompt(java.lang.String) in a subclass constructor.

Returns the prompt text to go at the top of the panel. Subclasses can override, to customise the prompt text of a panel without subclassing simply call setConnectionPrompt(java.lang.String).

setConnectionLabel

public void setConnectionLabel(java.lang.String label)

Sets the label for the connection combo box.

setConnectionPrompt

public void setConnectionPrompt(java.lang.String prompt)

Sets the prompt above the connection selection.

getDefaultFocusComponent

public java.awt.Component getDefaultFocusComponent()

actionPerformed

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

Specified by:

actionPerformed in interface java.awt.event.ActionListener