URLChooser (Oracle Fusion Middleware Java API Reference for Oracle Extension SDK)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JPanel
      - oracle.ide.panels.DefaultTraversablePanel
        
        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

Fields
Modifier and Type	Field and Description
`static URLFilter`	`ALL_FILES_FILTER` The standard "All Files (.)" `URLFilter` for accepting all `URL`s.
`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

Constructors
Constructor and Description
`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 `URL`s 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

Methods
Modifier and Type	Method and Description
`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 `URLFilter`s.
`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 `URLFilter`s shown in the "File type" combo box as an array.
`DialogRunnerCallback`	`getDialogRunnerCallback()`
`java.net.URL[]`	`getExtraURLs()` Returns an array containing all `URL`s that have been registered as "extra" `URL`s; returns `null` if no `URL`s 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 `URL`s 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 `URL`s 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, isPaintingOrigin, 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, 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, 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 (directory or file) is set. In general, client code should not call the URLChooser constructors directly. Instead, use one of the DialogUtil.newURLChooser variants: this will ensure that the chooser will be initialized consistently throughout the application.
  - 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. In general, client code should not call the URLChooser constructors directly. Instead, use one of the DialogUtil.newURLChooser variants: this will ensure that the chooser will be initialized consistently throughout the application.
  - 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.
    Note: File name auto-completion is not supported for the case where there are multiple roots but the defaultSelection is null. Name completion requires either a single root or that the dialog have a selected URL. The selected URL may become non-null as a result of user interaction with the dialog.
  - 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.

Class URLChooser

Nested Class Summary

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

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

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

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

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface oracle.ide.controls.GridBagConstants

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class oracle.ide.panels.DefaultTraversablePanel

Methods inherited from class javax.swing.JPanel

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

ALL_FILES_FILTER

CANCEL_OPTION

APPROVE_OPTION

ERROR_OPTION

MULTIPLE_INTERVAL_SELECTION

SINGLE_INTERVAL_SELECTION

SINGLE_SELECTION

FILES_ONLY

DIRECTORIES_ONLY

DIRECTORIES_OR_FILES

HELP_TOPIC_SELECT_FILES

HELP_TOPIC_SELECT_DIRECTORIES

HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES

Constructor Detail

URLChooser

URLChooser

URLChooser

URLChooser

URLChooser

Method Detail

setExtraURLs

getExtraURLs

setDialogRunnerCallback

getDialogRunnerCallback

setShowJarsAsDirs

getShowJarsAsDirs

accept

addChooseableURLFilter

clearChooseableURLFilters

getChooseableURLFilters

addShortcutButton

removeShortcutButtons

approveSelection

cancelSelection

changeToParentDirectory

getSelectedURL

getFileNameURL

setFileNameURL

getSelectedURLs

setSelectionMode

setRoots

setSelectedURL

setSelectionScope

setURLFilter

flush

showOpenDialog

showOpenDialog

showOpenDialog

showSaveDialog

showSaveDialog

showSaveDialog

canonicalizeApprovalURL

getApprovalFileListURL

checkApprovalParentExists

addURLChooserListener

removeURLChooserListener

addNotify

removeNotify

getSelectedFilter