oracle.jdeveloper.db.panels
Class AppConnectionPanelUI

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

All Implemented Interfaces:

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

public class AppConnectionPanelUI
extends ConnectionPanelUI

Connection picker for the database connections in the "Application Resources" Connection section for an application (workspace).

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

AppConnectionPanelUI(boolean showDetails)

AppConnectionPanelUI(boolean oracleOnly, boolean showDetails)

AppConnectionPanelUI(java.lang.String[] dbSubTypes, 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.
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	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 java.lang.String	getConnection(java.lang.String title, java.lang.String prompt, java.lang.String connName, boolean oracleOnly) Invokes a dialog for selecting a connection from the Application Resources for the current active Application.
protected DatabaseConnections	getConnections() Used by the default implementation of ConnectionPanelUI.listConnections() to return the DatabaseConnections instance that contains the connections to choose from.
protected Context	getContext()
protected javax.swing.JPanel	getDetailsPanel() Returns the details panel (only called if m_showDetails is true).
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 java.util.Collection<java.lang.String>	listConnections() By default this lists the connections returned by ConnectionPanelUI.getConnections().
protected void	populateDetails(ConnectionInfo connInfo) Populates the details panel with the given connection information.
protected java.lang.String	runConnectionDialog(java.lang.String name) This method is called as a result of the New or Edit button being pressed.
protected java.lang.String	runIdeConnectionDialog()
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 context)
void	setEnabled(boolean boo)

Methods inherited from class oracle.jdeveloper.db.panels.ConnectionPanelUI

addComboListener, getCanAddNull, getConnCombo, getConnection, getConnectionInfo, getConnectionName, getDefaultFocusComponent, getPicker, getPropertyStorage, getSettingsKey, itemStateChanged, launchConnectionDialog, loadSettings, removeComboListener, resetConnections, saveSettings, setCanAddNull, setConnectionName

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

AppConnectionPanelUI

public AppConnectionPanelUI(boolean showDetails)

AppConnectionPanelUI

public AppConnectionPanelUI(boolean oracleOnly,
                            boolean showDetails)

AppConnectionPanelUI

public AppConnectionPanelUI(java.lang.String[] dbSubTypes,
                            boolean showDetails)

Method Detail

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.

getComponentNamePrefix

protected java.lang.String getComponentNamePrefix()

Overrides:

getComponentNamePrefix in class ConnectionPanelUI

actionPerformed

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

Specified by:

actionPerformed in interface java.awt.event.ActionListener

getConnections

protected DatabaseConnections getConnections()

Description copied from class: ConnectionPanelUI

Used by the default implementation of ConnectionPanelUI.listConnections() to return the DatabaseConnections instance that contains the connections to choose from.

Overrides:

getConnections in class ConnectionPanelUI

runConnectionDialog

protected java.lang.String runConnectionDialog(java.lang.String name)

Description copied from class: ConnectionPanelUI

This method is called as a result of the New or Edit button being pressed.

Overrides:

runConnectionDialog in class ConnectionPanelUI

Parameters:

name - the connection name to edit in the dialog, if null invoke a "new" dialog.

Returns:

the name of the connection that was edited (or newly created), or null if the user cancelled.

getContext

protected Context getContext()

setContext

public void setContext(Context context)

runIdeConnectionDialog

protected java.lang.String runIdeConnectionDialog()

getConnection

public static java.lang.String getConnection(java.lang.String title,
                                             java.lang.String prompt,
                                             java.lang.String connName,
                                             boolean oracleOnly)

Invokes a dialog for selecting a connection from the Application Resources for the current active Application.

Parameters:

title - the dialog title

prompt - the prompt string for the dialog

connName - the initially selected connection name, or null to use the default

connClassName - the connection class to prompt for

oracleOnly - whether to only display Oracle connections.

enableActiveComponents

public void enableActiveComponents(boolean boo)

Description copied from class: ConnectionPanelUI

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

Overrides:

enableActiveComponents in class ConnectionPanelUI

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)

listConnections

protected java.util.Collection<java.lang.String> listConnections()

Description copied from class: ConnectionPanelUI

By default this lists the connections returned by ConnectionPanelUI.getConnections(). Subclasses can override to provide any list of connection names required.

Overrides:

listConnections in class ConnectionPanelUI

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

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, checkConnection() and disableDetails() must also be overriden.

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

setEnabled

public void setEnabled(boolean boo)

Overrides:

setEnabled in class javax.swing.JComponent

disableDetails

protected void disableDetails()

Disables all components in the details panel.

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.