Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.3.0)

E17493-04


oracle.ide.net
Class URLChooser

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by javax.swing.JPanel
                  extended by oracle.ide.panels.DefaultTraversablePanel
                      extended by oracle.ide.net.URLChooser

All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, GridBagConstants, Traversable

public class URLChooser
extends DefaultTraversablePanel
implements GridBagConstants

The URLChooser is a replacement file chooser for JFileChooser. The URLChooser is designed to work in terms of URL rather than File instances.

In general, most client code should not call the URLChooser constructors directly. Instead, use one of the DialogUtil.newURLChooser() variants, as this ensures that the chooser will be initialized consistently throughout the application. When the URLChooser must be subclassed, however, the constructors can be called directly but this should be followed by a call to DialogUtil.initURLChooser(URLChooser,oracle.ide.Context).

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
static URLFilter ALL_FILES_FILTER
          The standard "All Files (*.*)" URLFilter for accepting all URLs.
static int APPROVE_OPTION
          Return value from showOpenDialog(...) and showSaveDialog(...) methods if open/save is chosen.
static int CANCEL_OPTION
          Return value from showOpenDialog(...) and showSaveDialog(...) methods if cancel is chosen.
static int DIRECTORIES_ONLY
           
static int DIRECTORIES_OR_FILES
           
static int ERROR_OPTION
          Return value from showOpenDialog(...) and showSaveDialog(...) methods if an I/O error occurred.
static int FILES_ONLY
           
protected static java.lang.String HELP_TOPIC_SELECT_DIRECTORIES
           
protected static java.lang.String HELP_TOPIC_SELECT_FILES
           
protected static java.lang.String HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES
           
static int MULTIPLE_INTERVAL_SELECTION
          A value for setSelectionMode(int) meaning that one or more continuous ranges of files can be selected at a time.
static int SINGLE_INTERVAL_SELECTION
          A value for setSelectionMode(int) meaning that one continuous range of files can be selected at a time.
static int SINGLE_SELECTION
          A value for setSelectionMode(int) meaning that one file can be selected at a time.

 

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
URLChooser()
          Constructs a default URLChooser with all file system roots as reported by URLFileSystem.listRoots().
URLChooser(java.net.URL defaultSelection)
          Constructs a default URLChooser with all file system roots as reported by URLFileSystem.listRoots().
URLChooser(java.net.URL[] roots, java.net.URL defaultSelection)
          Constructs a URLFilter to display the specified array of URLs as its "root" file systems and the specified URL as the default selection.
URLChooser(java.net.URL[] roots, java.net.URL defaultSelection, boolean showJarsAsDirs)
          Deprecated. Replace with URLChooser(URL[],URL) and setShowJarsAsDirs(boolean).
URLChooser(java.net.URL defaultSelection, boolean showJarsAsDirs)
          Deprecated. Replace with URLChooser(URL) and setShowJarsAsDirs(boolean).

 

Method Summary
 boolean accept(java.net.URL url)
          Returns true if the specified URL should be displayed in the URLChooser.
 void addChooseableURLFilter(URLFilter filter)
          Adds the specified URLFilter to be one of the filters that are shown in the "File type" combo box.
 void addNotify()
           
 void addShortcutButton(javax.swing.Icon icon, java.lang.String description, java.net.URL url)
          This method adds a shortcut button to the button panel on the left side of the URLChooser.
 void addURLChooserListener(oracle.ide.net.URLChooserListener ucl)
          Add a URLChooserListener to this URLChooser
 boolean approveSelection()
           
 void cancelSelection()
          This method is called when the URLChooser is being canceled.
protected  java.net.URL canonicalizeApprovalURL(java.net.URL url)
          Template helper method for approveSelection() to canonicalize the URL to be approved.
 void changeToParentDirectory()
           
protected  boolean checkApprovalParentExists(java.net.URL url)
          Template helper method for approveSelection() to check that the parent directory for the approval URL exists.
 void clearChooseableURLFilters()
          Clears the list of chooseable URLFilters.
 void flush()
          Clears the results of all file system queries that have been cached by the URLChooser, so a single chooser instance can be reused multiple times in a session.
protected  java.net.URL getApprovalFileListURL()
          Template helper method for approveSelection() and getSelectedURL() to get the URL of the selected node in the file list.
 URLFilter[] getChooseableURLFilters()
          Returns all of the URLFilters shown in the "File type" combo box as an array.
 DialogRunnerCallback getDialogRunnerCallback()
           
 java.net.URL[] getExtraURLs()
          Returns an array containing all URLs that have been registered as "extra" URLs; returns null if no URLs have previously been registed via setExtraURLs(URL[]).
 java.lang.String getFileNameURL()
           
 URLFilter getSelectedFilter()
          Returns the URLFilter that is currently selected in the file type combo box.
 java.net.URL getSelectedURL()
          Returns the URL of the node (which may be a directory or a file) that is currently selected in the URLChooser.
 java.net.URL[] getSelectedURLs()
          Returns an array of URLs representing the current selections in the URLChooser.
 boolean getShowJarsAsDirs()
          Returns whether the URLChooser allows browsing into archives.
 void removeNotify()
           
 void removeShortcutButtons()
          Removes all shortcut buttons from the button panel on the left side of the URLChooser, allowing the URLChooser instance to be reused in a different context without retaining the existing shortcut buttons.
 void removeURLChooserListener(oracle.ide.net.URLChooserListener ucl)
          Remove a URLChooserListener from this URLChooser
 void setDialogRunnerCallback(DialogRunnerCallback callBack)
           
 void setExtraURLs(java.net.URL[] extraURLs)
          Registers a URL array that corresponds to resources that exist only in memory and not in the file system (for example, unsaved files).
 void setFileNameURL(java.lang.String text)
           
 void setRoots(java.net.URL[] roots)
          Sets the root URLs that will be traversed by the URLChooser.
 void setSelectedURL(java.net.URL selection)
          Sets the selected directory such that the specified URL is shown in the file list.
 void setSelectionMode(int selectionMode)
          Sets the selection mode for the URLChooser.
 void setSelectionScope(int selectionScope)
          Valid values are FILES_ONLY and DIRECTORIES_ONLY.
 void setShowJarsAsDirs(boolean showJarsAsDirs)
          Sets whether the URLChooser should allow browsing into archives.
 void setURLFilter(URLFilter filter)
          Sets the active URLFilter.
 int showOpenDialog(java.awt.Component parent)
           
 int showOpenDialog(java.awt.Component parent, java.lang.String title)
           
 int showOpenDialog(java.awt.Component parent, Traversable content, java.lang.String title)
           
 int showSaveDialog(java.awt.Component parent)
           
 int showSaveDialog(java.awt.Component parent, java.lang.String title)
           
 int showSaveDialog(java.awt.Component parent, Traversable content, java.lang.String title)
           

 

Methods inherited from class oracle.ide.panels.DefaultTraversablePanel
gbc, gbc, getComponent, getDefaultTitle, getExitTransition, getHelpID, getText, onEntry, onExit, setDefaultTitle, setHelpID

 

Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

 

Methods inherited from class javax.swing.JComponent
addAncestorListener, 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, 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

ALL_FILES_FILTER

public static final URLFilter ALL_FILES_FILTER
The standard "All Files (*.*)" URLFilter for accepting all URLs.

CANCEL_OPTION

public static final int CANCEL_OPTION
Return value from showOpenDialog(...) and showSaveDialog(...) methods if cancel is chosen.
See Also:
Constant Field Values

APPROVE_OPTION

public static final int APPROVE_OPTION
Return value from showOpenDialog(...) and showSaveDialog(...) methods if open/save is chosen.
See Also:
Constant Field Values

ERROR_OPTION

public static final int ERROR_OPTION
Return value from showOpenDialog(...) and showSaveDialog(...) methods if an I/O error occurred.
See Also:
Constant Field Values

MULTIPLE_INTERVAL_SELECTION

public static final int MULTIPLE_INTERVAL_SELECTION
A value for setSelectionMode(int) meaning that one or more continuous ranges of files can be selected at a time.
See Also:
Constant Field Values

SINGLE_INTERVAL_SELECTION

public static final int SINGLE_INTERVAL_SELECTION
A value for setSelectionMode(int) meaning that one continuous range of files can be selected at a time.
See Also:
Constant Field Values

SINGLE_SELECTION

public static final int SINGLE_SELECTION
A value for setSelectionMode(int) meaning that one file can be selected at a time.
See Also:
Constant Field Values

FILES_ONLY

public static final int FILES_ONLY
See Also:
Constant Field Values

DIRECTORIES_ONLY

public static final int DIRECTORIES_ONLY
See Also:
Constant Field Values

DIRECTORIES_OR_FILES

public static final int DIRECTORIES_OR_FILES
See Also:
Constant Field Values

HELP_TOPIC_SELECT_FILES

protected static final java.lang.String HELP_TOPIC_SELECT_FILES
See Also:
Constant Field Values

HELP_TOPIC_SELECT_DIRECTORIES

protected static final java.lang.String HELP_TOPIC_SELECT_DIRECTORIES
See Also:
Constant Field Values

HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES

protected static final java.lang.String HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES
See Also:
Constant Field Values

Constructor Detail

URLChooser

public URLChooser()
Constructs a default URLChooser with all file system roots as reported by URLFileSystem.listRoots(). No default URL (directory or file) is set.

URLChooser

public URLChooser(java.net.URL defaultSelection)
Constructs a default URLChooser with all file system roots as reported by URLFileSystem.listRoots(). The specified URL is used as the default selection; if null, there will be no default selection.

URLChooser

public URLChooser(java.net.URL[] roots,
                  java.net.URL defaultSelection)
Constructs a URLFilter to display the specified array of URLs as its "root" file systems and the specified URL as the default selection. The "root" file systems only need to be directories and don't necessarily have to be actual file system roots.

URLChooser

@Deprecated
public URLChooser(java.net.URL defaultSelection,
                             boolean showJarsAsDirs)
Deprecated. Replace with URLChooser(URL) and setShowJarsAsDirs(boolean).

URLChooser

@Deprecated
public URLChooser(java.net.URL[] roots,
                             java.net.URL defaultSelection,
                             boolean showJarsAsDirs)
Deprecated. Replace with URLChooser(URL[],URL) and setShowJarsAsDirs(boolean).

Method Detail

setExtraURLs

public void setExtraURLs(java.net.URL[] extraURLs)
Registers a URL array that corresponds to resources that exist only in memory and not in the file system (for example, unsaved files). While it is allowable to register a URL for a resource that physically does exist, it is not recommended for performance reasons.

Nonexistent extra resources registered in this manner will appear in the URLChooser file list in italic font. This allows the user to distinguish between actual file system resources and in-memory only resources.

Extra resources should be registered each time the URLChooser becomes displayed, and they should be cleared each time it becomes undisplayed. Displayability changes to the URLChooser can be detected by adding a HierarchyListener to it with Component.addHierarchyListener(java.awt.event.HierarchyListener).

Parameters:
extraURLs - the URL array specifying all in-memory only resources, or null to clear the previously registered URLs.
See Also:
HierarchyEvent.SHOWING_CHANGED

getExtraURLs

public java.net.URL[] getExtraURLs()
Returns an array containing all URLs that have been registered as "extra" URLs; returns null if no URLs have previously been registed via setExtraURLs(URL[]).

setDialogRunnerCallback

public void setDialogRunnerCallback(DialogRunnerCallback callBack)

getDialogRunnerCallback

public DialogRunnerCallback getDialogRunnerCallback()

setShowJarsAsDirs

public void setShowJarsAsDirs(boolean showJarsAsDirs)
Sets whether the URLChooser should allow browsing into archives.

getShowJarsAsDirs

public boolean getShowJarsAsDirs()
Returns whether the URLChooser allows browsing into archives.

accept

public boolean accept(java.net.URL url)
Returns true if the specified URL should be displayed in the URLChooser. Returns false otherwise.

addChooseableURLFilter

public void addChooseableURLFilter(URLFilter filter)
Adds the specified URLFilter to be one of the filters that are shown in the "File type" combo box. If the specified filter is null or if the specified filter has already been added, this method does nothing.

clearChooseableURLFilters

public void clearChooseableURLFilters()
Clears the list of chooseable URLFilters.

getChooseableURLFilters

public URLFilter[] getChooseableURLFilters()
Returns all of the URLFilters shown in the "File type" combo box as an array. If there are no filters, then an empty array is returned.

addShortcutButton

public void addShortcutButton(javax.swing.Icon icon,
                              java.lang.String description,
                              java.net.URL url)
This method adds a shortcut button to the button panel on the left side of the URLChooser. When the user clicks on the shortcut button, the current location of the URLChooser will be changed to be the URL URL. If the specified URL is null, this method does nothing. If no shortcut buttons are added, then the shortcut panel is not drawn.

removeShortcutButtons

public void removeShortcutButtons()
Removes all shortcut buttons from the button panel on the left side of the URLChooser, allowing the URLChooser instance to be reused in a different context without retaining the existing shortcut buttons. The shortcut panel will no longer be visible after calling this method.

approveSelection

public boolean approveSelection()
Returns:
true if the URLChooser is ready to be dismissed; false if the user's current selection only indicates that a custom wildcard filter or directory change should occur instead.

cancelSelection

public void cancelSelection()
This method is called when the URLChooser is being canceled.

changeToParentDirectory

public void changeToParentDirectory()

getSelectedURL

public java.net.URL getSelectedURL()
Returns the URL of the node (which may be a directory or a file) that is currently selected in the URLChooser.

getFileNameURL

public java.lang.String getFileNameURL()
Returns:
The text of the file edit box. This is to allow listeners that care about the file filter to change the extension.

setFileNameURL

public void setFileNameURL(java.lang.String text)

getSelectedURLs

public java.net.URL[] getSelectedURLs()
Returns an array of URLs representing the current selections in the URLChooser. This array will contain only one element if there is only one selection or if the user typed the name of the file into the text field.

setSelectionMode

public void setSelectionMode(int selectionMode)
Sets the selection mode for the URLChooser. By default, the URLChooser allows multiple interval selection.
Parameters:
selectionMode - The specified mode must be one of MULTIPLE_INTERVAL_SELECTION, SINGLE_INTERVAL_SELECTION, or SINGLE_SELECTION.
Throws:
java.lang.IllegalArgumentException - if the specified selection mode is not one of the legal vales.

setRoots

public void setRoots(java.net.URL[] roots)
Sets the root URLs that will be traversed by the URLChooser. The roots can be any URL that represents a directory. Even directories within jar files are allowed.

setSelectedURL

public void setSelectedURL(java.net.URL selection)
Sets the selected directory such that the specified URL is shown in the file list. If the URL itself is a directory, then that directory is selected.

setSelectionScope

public void setSelectionScope(int selectionScope)
Valid values are FILES_ONLY and DIRECTORIES_ONLY. Note: This method must be called from the AWT event thread.

setURLFilter

public void setURLFilter(URLFilter filter)
Sets the active URLFilter. If the filter isn't on the list of filters used by the URLChooser it is first added. If the specified URLFilter is null, the default "all files" filter is set as the current filter.

flush

public void flush()
Clears the results of all file system queries that have been cached by the URLChooser, so a single chooser instance can be reused multiple times in a session. It is not necessary to use this method for a chooser instance that is used only once and then released.

This method is generally called immediately after a call to showOpenDialog() or showSaveDialog() has completed. If it is called before showing the chooser dialog, then it should be called before any other initialization of the chooser is done.


showOpenDialog

public int showOpenDialog(java.awt.Component parent)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

showOpenDialog

public int showOpenDialog(java.awt.Component parent,
                          java.lang.String title)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

showOpenDialog

public int showOpenDialog(java.awt.Component parent,
                          Traversable content,
                          java.lang.String title)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

showSaveDialog

public int showSaveDialog(java.awt.Component parent)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

showSaveDialog

public int showSaveDialog(java.awt.Component parent,
                          java.lang.String title)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

showSaveDialog

public int showSaveDialog(java.awt.Component parent,
                          Traversable content,
                          java.lang.String title)
Returns:
APPROVE_OPTION, CANCEL_OPTION, or ERROR_OPTION.

canonicalizeApprovalURL

protected java.net.URL canonicalizeApprovalURL(java.net.URL url)
Template helper method for approveSelection() to canonicalize the URL to be approved.

The default implementation calls URLFileSystem.canonicalize(URL). Subclasses may override to provide differing behavior.


getApprovalFileListURL

protected java.net.URL getApprovalFileListURL()
Template helper method for approveSelection() and getSelectedURL() to get the URL of the selected node in the file list.

The default implementation gets the URL of the selected node in the file list. Subclasses may wish to override to return null in order to ignore the file list selection.


checkApprovalParentExists

protected boolean checkApprovalParentExists(java.net.URL url)
Template helper method for approveSelection() to check that the parent directory for the approval URL exists.

The default implementation gets the parent of the specified URL via URLFileSystem.getParent(URL) and tests for that directory's existence with URLFileSystem.exists(URL). Subclasses may override to provide differing behavior (for example, to always return true if the parent directory need not exist).


addURLChooserListener

public void addURLChooserListener(oracle.ide.net.URLChooserListener ucl)
Add a URLChooserListener to this URLChooser

removeURLChooserListener

public void removeURLChooserListener(oracle.ide.net.URLChooserListener ucl)
Remove a URLChooserListener from this URLChooser

addNotify

public void addNotify()
Overrides:
addNotify in class javax.swing.JComponent

removeNotify

public void removeNotify()
Overrides:
removeNotify in class javax.swing.JComponent

getSelectedFilter

public final URLFilter getSelectedFilter()
Returns the URLFilter that is currently selected in the file type combo box. The value returned by this method should always be non-null.

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.3.0)

E17493-04


Copyright © 1997, 2012, Oracle. All rights reserved.