oracle.ide.model.panels
Class ProjectSettingsTraversablePanel

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  oracle.ide.panels.DefaultTraversablePanel
                      oracle.ide.model.panels.ProjectSettingsTraversablePanel

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, GridBagConstants, Traversable

Direct Known Subclasses:

ApplicationContentPanel, ApplicationDeploymentPanel, GenericPanel, J2eePanel, JProjectDependencyPanel, JProjectLibrariesPanel, JProjectPanel, OjcConfigurationPanel, ProjectDeploymentPanel, ResourceBundleOptionsPanel, TechnologiesPanel

public abstract class ProjectSettingsTraversablePanel
extends DefaultTraversablePanel

This panel is designed for use in the Project Properties dialog. The TraversableContext must contain the project properties HashStructure, referenced with key: PROPERTY_DATA_KEY.

In the case of the Project Properties dialog, this HashStructure contains either the shared project properties or the user properties. Subclasses can get the appropriate properties data, by calling getPropertyData(Namespace).

See Also:

getPropertyData(Namespace), 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

static java.lang.String	CHAINED_PROPERTY_DATA_KEY The key used to store the chained project property HashStructure in the TraversableContext.
static java.lang.String	DEFAULT_PROJECT_KEY The key used to store the value that indicates whether or not data in the shared Namespace is default project data (as opposed to a real project data).
static java.lang.String	EDITING_CUSTOM_PROPERTIES_KEY The key used to store a Boolean that indicates whether or not the properties panel is for edting user-only project properties, or shared project properties.
static java.lang.String	PROPERTY_DATA_KEY The key used to store the project properties HashStructure in the TraversableContext.
static java.lang.String	USER_ONLY_PROPERTY_DATA_KEY The key used to store the chained project property HashStructure in the TraversableContext.

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 oracle.ide.controls.GridBagConstants

ANCHOR_C, ANCHOR_E, ANCHOR_N, ANCHOR_NE, ANCHOR_NW, ANCHOR_S, ANCHOR_SE, ANCHOR_SW, ANCHOR_W, FILL_NONE, FILL_X, FILL_XY, FILL_Y

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

ProjectSettingsTraversablePanel()

Method Summary

void	activateProperties(TraversableContext tc, boolean useCustom) Enables or disables custom properties.
boolean	arePropertiesOverridden() Indicates whether or not the one or more shared project property is overridden by a custom property.
static boolean	editingUserProperties(Namespace data) Indicates whether or not the supplied Namespace corresponds to user properties opposed to shared properties.
abstract java.lang.String	getDataKey() Subclasses should implement this method and return the single key used to identify their project properties, unless the UI describes properties that span more than a single HashStructure, in which case null should be returned.
protected static Project	getProject(Namespace data) Returns the current Project in the Namespace.
protected static PropertyStorage	getPropertyData(Namespace data) Gets a PropertyStorage object that wraps the properties HashStructure, which is stored in the Namespace with the key: PROPERTY_DATA_KEY.
abstract java.lang.String[]	getPropertyKeys() Subclasses must implement this method and return the list of property keys for this Project Properties panel.
static boolean	isDefaultProject(Namespace data) Indicates whether or not the data in the supplied Namespace corresponds to the default project properties data.
boolean	isUserOnly() The default implementation returns false, indicating that the properties that are edited on this panel can be set at the user and at the project level.
void	onEntry(TraversableContext traversableContext) Does nothing by default.
abstract void	onProjectPanelEntry(TraversableContext traversableContext) Subclasses must implement this method which is invoked when the panel is about to be displayed.

Methods inherited from class oracle.ide.panels.DefaultTraversablePanel

gbc, gbc, getComponent, getDefaultTitle, getExitTransition, getHelpID, getText, onExit, setDefaultTitle, setHelpID

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

Field Detail

DEFAULT_PROJECT_KEY

public static final java.lang.String DEFAULT_PROJECT_KEY

The key used to store the value that indicates whether or not data in the shared Namespace is default project data (as opposed to a real project data).

See Also:

Constant Field Values

EDITING_CUSTOM_PROPERTIES_KEY

public static final java.lang.String EDITING_CUSTOM_PROPERTIES_KEY

The key used to store a Boolean that indicates whether or not the properties panel is for edting user-only project properties, or shared project properties.

See Also:

Constant Field Values

PROPERTY_DATA_KEY

public static final java.lang.String PROPERTY_DATA_KEY

The key used to store the project properties HashStructure in the TraversableContext.

See Also:

Constant Field Values

CHAINED_PROPERTY_DATA_KEY

public static final java.lang.String CHAINED_PROPERTY_DATA_KEY

The key used to store the chained project property HashStructure in the TraversableContext.

See Also:

Constant Field Values

USER_ONLY_PROPERTY_DATA_KEY

public static final java.lang.String USER_ONLY_PROPERTY_DATA_KEY

The key used to store the chained project property HashStructure in the TraversableContext.

See Also:

Constant Field Values

Constructor Detail

ProjectSettingsTraversablePanel

public ProjectSettingsTraversablePanel()

Method Detail

onEntry

public final void onEntry(TraversableContext traversableContext)

Description copied from class: DefaultTraversablePanel

Does nothing by default.

Specified by:

onEntry in interface Traversable

Overrides:

onEntry in class DefaultTraversablePanel

Parameters:

traversableContext - The data wrapper where the Traversable locates the data that it needs to populate the UI.

See Also:

Traversable.onEntry(TraversableContext)

onProjectPanelEntry

public abstract void onProjectPanelEntry(TraversableContext traversableContext)

Subclasses must implement this method which is invoked when the panel is about to be displayed.

Parameters:

traversableContext - the shared data context

getDataKey

public abstract java.lang.String getDataKey()

Subclasses should implement this method and return the single key used to identify their project properties, unless the UI describes properties that span more than a single HashStructure, in which case null should be returned.

Returns:

the unique key used to store and retrieve project properties, or null

See Also:

getPropertyKeys()

getPropertyKeys

public abstract java.lang.String[] getPropertyKeys()

Subclasses must implement this method and return the list of property keys for this Project Properties panel. If the data is stored in a single HashStructure, subclasses should implement getDataKey() and return the key used to store the set of properties, then this method should return the keys as short property names like:

"debugInformation"

If the panel contains UI for properties that span more than one HashStructure, the property keys must be in the form:

"oracle.jdeveloper.compiler.OjcConfiguration/debugInformation"

Returns:

a list of property keys for this panel

See Also:

getDataKey()

getProject

protected static Project getProject(Namespace data)

Returns the current Project in the Namespace.

Parameters:

data - the data used in the context of this panel

Returns:

a Project

Throws:

java.lang.NullPointerException - if data is null.

getPropertyData

protected static PropertyStorage getPropertyData(Namespace data)

Gets a PropertyStorage object that wraps the properties HashStructure, which is stored in the Namespace with the key: PROPERTY_DATA_KEY. This method requires that the Namespace contain the project properties HashStructure.

Parameters:

data - the data used in the context of this panel

Returns:

a PropertyStorage

Throws:

java.lang.IllegalArgumentException - if the Namespace does not contain the expected key, or the value is null

java.lang.NullPointerException - if data is null.

isUserOnly

public boolean isUserOnly()

The default implementation returns false, indicating that the properties that are edited on this panel can be set at the user and at the project level.

Subclasses that provide UI for user-only properties, those which are never stored in the project, should override this method and return true.

Returns:

true if the properties can only be set at the user level, false otherwise

isDefaultProject

public static final boolean isDefaultProject(Namespace data)

Indicates whether or not the data in the supplied Namespace corresponds to the default project properties data.

Parameters:

data - the shared Namespace

Returns:

true if the data is from the default project. Returns false if the data is a real project.

editingUserProperties

public static final boolean editingUserProperties(Namespace data)

Indicates whether or not the supplied Namespace corresponds to user properties opposed to shared properties.

Returns:

true if the data is user-specific project properties. Returns false if the data corresponds to (shared) project properties.

activateProperties

public final void activateProperties(TraversableContext tc,
                                     boolean useCustom)

Enables or disables custom properties. When useCustom is true, the custom properties are enabled so that they are accessible in the chained HashStructure. When useCustom is false, the custom properties are hidden so that they are not accessible from the project.

Parameters:

tc - the shared data context

useCustom - when true, custom properties are enabled, when false they are disabled and only team-level (shared) properties are used

See Also:

HashStructureNode.getProperties(), HashStructureNode.getPropertiesForOverriding()

arePropertiesOverridden

public boolean arePropertiesOverridden()

Indicates whether or not the one or more shared project property is overridden by a custom property. If at least one of the properties is overridden, this method returns true.

Returns:

true if any of the project properties are overridden by custom properties, false otherwise