ucar.unidata.idv.chooser
Class FileChooser

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  ucar.unidata.ui.ChooserPanel
                      ucar.unidata.idv.chooser.IdvChooser
                          ucar.unidata.idv.chooser.FileChooser

All Implemented Interfaces:

ActionListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, IdvConstants

Direct Known Subclasses:

Level2RadarChooser, PollingFileChooser

public class FileChooser
extends IdvChooser

This provides a JFileChooser for choosing data sets from the file system. It can be instantiated from the chooser.xml with the attributes:

 path="initial file system path"
 filters="File filters to use" (Define file filters)
 datasourceid="The data source id (from datasource.xml, force the file to
                                   be passed to the data source)
 

For information on the filters attribute see PatternFileFilter.createFilters(String)

Author:

IDV development team

See Also:

Serialized Form

Nested Class Summary

class

FileChooser.MyFileChooser An extension of JFileChooser

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

JPanel.AccessibleJPanel

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

protected JCheckBox	allowDirectorySelectionCbx allow directory selection checkbox
static String	ATTR_DATASOURCEID Pre-defined data source id to use
static String	ATTR_DSCOMP Should we show the polling cbx
static String	ATTR_FILECOUNT The most recent attribute
static String	ATTR_FILEPATTERN Default pattern
static String	ATTR_FILTERS Any filter filters to use
static String	ATTR_PATH Any initial file system path to start with
static String	ATTR_POLLON Default polling value
static String	ATTR_SHOWPATTERNFIELD Should we show the file pattern field
protected JTextField	patternFld Holds the file pattern
protected JComboBox	recentFilesCbx Como box for choosing relative files

Fields inherited from class ucar.unidata.idv.chooser.IdvChooser

ATTR_ID, ATTR_SHOWDETAILS, dirHistoryCbx, ignoreDirHistory, NULL_PROPERTIES, NULL_STRING, PREF_ADDESERVERS, PREF_CATALOGLIST, PREF_DEFAULTDIR, PREF_IMAGEDESCLIST, PREF_POLLINGINFO, PREF_RADARDESCLIST, PREF_TDSPOINTOBSERVER, PREF_TDSRADARSERVER, PROP_CHOOSER_MAPS, PROP_CHOOSER_PROJECTION_BOUNDS, PROP_CHOOSERCLASSNAME, PROP_STATUS_BACKGROUND, PROP_STATUS_FOREGROUND, PROP_STATUS_TEMPLATE, stationMap

Fields inherited from class ucar.unidata.ui.ChooserPanel

cancelButton, CMD_LOAD, contents, GRID_INSETS, GRID_SPACING, GRID_SPACING_H, GRID_SPACING_V, haveData, helpPath, loadButton, MAP_COLOR, simpleMode, statusLabel

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 ucar.unidata.idv.IdvConstants

ARG_B64BUNDLE, ARG_B64ISL, ARG_BUNDLE, ARG_CATALOG, ARG_CHOOSER, ARG_CLEARDEFAULT, ARG_CODE, ARG_CONNECT, ARG_CURRENTTIME, ARG_DATA, ARG_DEBUG, ARG_DEFAULT, ARG_DISPLAY, ARG_DXML, ARG_FIXEDTIME, ARG_HELP, ARG_IMAGE, ARG_IMAGESERVER, ARG_INSTALLPLUGIN, ARG_ISLFILE, ARG_ISLINTERACTIVE, ARG_LISTRESOURCES, ARG_MAINCLASS, ARG_MOVIE, ARG_MSG_DEBUG, ARG_MSG_RECORD, ARG_NODEFAULT, ARG_NOERRORSINGUI, ARG_NOGUI, ARG_NOONEINSTANCE, ARG_NOPLUGINS, ARG_NOPREF, ARG_ONEINSTANCEPORT, ARG_PLUGIN, ARG_PORT, ARG_PRINTJNLP, ARG_PROPERTIES, ARG_SCRIPT, ARG_SERVER, ARG_SETFILES, ARG_SITEPATH, ARG_TEMPLATE, ARG_TEST, ARG_TESTEVAL, ARG_TRACE, ARG_TRACEONLY, ARG_USERPATH, DEFAULT_DATE_FORMAT, DEFAULT_DOCPATH, DEFAULT_MAX_PERMGENSIZE, DEFAULT_TIMEZONE, FILTER_CPT, FILTER_ISL, FILTER_JNLP, FILTER_XIDV, FILTER_XIDVZIDV, FILTER_XML, FILTER_ZIDV, ID_COMMANDSTORUN, ID_DATASOURCES, ID_DISPLAYCONTROLS, ID_IDV, ID_JYTHON, ID_MESSAGE, ID_MISCHASHTABLE, ID_VERSION, ID_VIEWMANAGERS, ID_WINDOWS, INITIAL_PROBE_EARTHLOCATION, NULL_DATA_SELECTION, PREF_ARCHIVEDIR, PREF_ARCHIVENAME, PREF_AUTODISPLAYS_ENABLE, PREF_AUTODISPLAYS_SHOWGUI, PREF_AUTOSELECTDATA, PREF_CACHESIZE, PREF_CONTROLSINTABS, PREF_DATAPREFIX, PREF_DATE_FORMAT, PREF_DISTANCEUNIT, PREF_DOCACHE, PREF_EMBEDDATACHOOSERINDASHBOARD, PREF_EMBEDFIELDSELECTORINDASHBOARD, PREF_EMBEDLEGENDINDASHBOARD, PREF_EMBEDQUICKLINKSINDASHBOARD, PREF_EVENT_KEYBOARDMAP, PREF_EVENT_MOUSEMAP, PREF_EVENT_WHEELMAP, PREF_FAST_RENDER, PREF_FIELD_CACHETHRESHOLD, PREF_FILEREADDIR, PREF_FILEWRITEDIR, PREF_GEOMETRY_BY_REF, PREF_HISTORY, PREF_IMAGE_BY_REF, PREF_LASTVERSION, PREF_LATLON_FORMAT, PREF_LEGEND_SHOWICONS, PREF_LOCALE, PREF_LOOKANDFEEL, PREF_MAX_PERMGENSIZE, PREF_MAXIMAGESIZE, PREF_MEMORY, PREF_NPOT_IMAGE, PREF_OPEN_ASK, PREF_OPEN_MERGE, PREF_OPEN_REMOVE, PREF_PROJ_LIST, PREF_SAMPLINGMODE, PREF_SHOWCONTROLWINDOW, PREF_SHOWDASHBOARD, PREF_SHOWDECODEDIALOG, PREF_SHOWHIDDENFILES, PREF_SHOWQUITCONFIRM, PREF_SITEPATH, PREF_THREADS_DATA, PREF_THREADS_RENDER, PREF_TIMEZONE, PREF_VERTICALCS, PREF_VERTICALUNIT, PREF_WINDOW_SHOWTOOLBAR, PREF_ZIDV_ASK, PREF_ZIDV_DIRECTORY, PREF_ZIDV_SAVETOTMP, PROP_3DMODE, PROP_ABOUTTEXT, PROP_APPRESOURCEPATH, PROP_CHOOSERS, PROP_CHOOSERS_ALL, PROP_CONTROLDESCRIPTORS, PROP_CONTROLDESCRIPTORS_ALL, PROP_DATAHOLDERBOUNDS, PROP_DEFAULTLOCATIONS, PROP_DISPLAYLIST_GROUP, PROP_FIXFILELOCKUP, PROP_JNLPCODEBASE, PROP_JNLPTEMPLATE, PROP_JNLPTITLE, PROP_LOADINGXML, PROP_MAP_GLOBE_LEVEL, PROP_MAP_MAP_LEVEL, PROP_MINIMUMFRAMECYCLETIME, PROP_MONITORPORT, PROP_OLDCONTROLDESCRIPTORS, PROP_ONEINSTANCEPORT, PROP_PREFERENCES, PROP_PROJ_NAME, PROP_RESOURCEFILES, PROP_SHOWCLOCK, PROP_SHOWDASHBOARD, PROP_SHOWDATATREE, PROP_SHOWFORMULAS, PROP_SHOWSPLASH, PROP_SPLASHICON, PROP_UI_DESKTOP, PROP_USE_TIMEDRIVER, PROP_VERSIONFILE, PROP_WINDOW_SCREENSIZEOFFSET, PROP_WINDOW_SIZEHEIGHT, PROP_WINDOW_SIZEWIDTH, PROP_WINDOW_USESCREENSIZE, SUFFIX_BAT, SUFFIX_CPT, SUFFIX_ISL, SUFFIX_JNLP, SUFFIX_RBI, SUFFIX_SH, SUFFIX_XIDV, SUFFIX_XML, SUFFIX_ZIDV

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

FileChooser(IdvChooserManager mgr, Element root)
Create the FileChooser, passing in the manager and the xml element from choosers.xml

Method Summary

protected void	checkRecentPatternWidgetsEnable() Disable or enable the file pattern widget and label
void	doLoadInThread() Override the base class method to catch the do load
protected JComponent	doMakeContents() Construct a JFileChooser to put into the IdvChooserManager.
protected JFileChooser	doMakeFileChooser(String path) Make the file chooser
void	doUpdate() Override the base class method to catch the do update
protected JComponent	getAccessory() Get the accessory component
protected JCheckBox	getAllowDirectorySelectionCbx() Get the checkbox for allowing directory selection
protected String[]	getButtonLabels() _more_
protected JFileChooser	getFileChooser() Get the file chooser
protected int	getFileCount() Get the count of recent files
protected String[]	getFileNames(File[] files) Convert the given array of File objects to an array of String file names.
protected String	getFilePattern() Get the file pattern
protected String	getLoadToolTip() Get the tooltip for the load button
protected JComponent	getRecentFilesComponent() Get the recent file component
protected JComponent	getRecentFilesComponent(int[] values, int value, boolean addPatternField) Get the recent files component with the appropriate params
protected void	getTopComponents(List comps) Get the top components for the chooser
protected String	getUpdateToolTip() Get the tooltip for the update button
protected void	selectFiles(File[] files, File directory) Handle the selection of the set of files
protected boolean	selectFilesInner(File[] files, File directory) Handle the selection of the set of files
void	setHaveData(boolean haveData) _more_
protected boolean	shouldShowRecentComponent() Should show the recent (time relative) component

Methods inherited from class ucar.unidata.idv.chooser.IdvChooser

clearSelectedStations, clearStations, closeChooser, createStationMap, decorateButtons, doCancel, doClose, errorMessage, getAttribute, getContents, getDataManager, getDataSource, getDataSourceId, getDataSourceId, getDataSourceProperties, getDataSourcesComponent, getDataSourcesComponent, getDataSourcesComponent, getDataSourcesComponent, getDefaultButtons, getDefaultDisplayType, getDefaultMap, getDefaultMaps, getDefaultProjection, getDefaultProjectionRect, getHaveStations, getId, getIdv, getMenuTitle, getPreferenceList, getPreferenceList, getPreferenceList, getPreferenceList, getProperty, getProperty, getPropList, getSelectedStation, getSelectedStations, getShowInMenu, getStationMap, getStatusLabel, getStatusLabelBackground, getStatusLabelForeground, getTitle, getXmlNode, haveStationSelected, init, initChooserPanel, initStationMap, isReloadable, logException, makeDataSource, makeDataSource, makeTimeMenus, newSelectedStations, resetDataSourceId, setDataSource, setDataSourceListener, shouldDoUpdateOnFirstDisplay, showNormalCursor, showWaitCursor, startTask, stopTask, stopTaskAndIsOk, taskOk, updateStatus, userMessage, usingStations

Methods inherited from class ucar.unidata.ui.ChooserPanel

actionPerformed, addPropertyChangeListener, canDoUpdate, clearWaitCursor, doHelp, doLoad, firePropertyChange, getDefaultButtons, getHaveData, getLoadCommandName, getMessageTemplate, getSimpleMode, getStatusComponent, padLabel, registerStatusComp, revalidate, setHelpPath, setMessageTemplate, setStatus, setStatus, showNormalCursor, showWaitCursor

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

ATTR_PATH

public static final String ATTR_PATH

Any initial file system path to start with

See Also:

Constant Field Values

ATTR_FILECOUNT

public static final String ATTR_FILECOUNT

The most recent attribute

See Also:

Constant Field Values

ATTR_POLLON

public static final String ATTR_POLLON

Default polling value

See Also:

Constant Field Values

ATTR_DSCOMP

public static final String ATTR_DSCOMP

Should we show the polling cbx

See Also:

Constant Field Values

ATTR_SHOWPATTERNFIELD

public static final String ATTR_SHOWPATTERNFIELD

Should we show the file pattern field

See Also:

Constant Field Values

ATTR_FILEPATTERN

public static final String ATTR_FILEPATTERN

Default pattern

See Also:

Constant Field Values

ATTR_FILTERS

public static final String ATTR_FILTERS

Any filter filters to use

See Also:

Constant Field Values

ATTR_DATASOURCEID

public static final String ATTR_DATASOURCEID

Pre-defined data source id to use

See Also:

Constant Field Values

recentFilesCbx

protected JComboBox recentFilesCbx

Como box for choosing relative files

allowDirectorySelectionCbx

protected JCheckBox allowDirectorySelectionCbx

allow directory selection checkbox

patternFld

protected JTextField patternFld

Holds the file pattern

Constructor Detail

FileChooser

public FileChooser(IdvChooserManager mgr,
                   Element root)

Create the FileChooser, passing in the manager and the xml element from choosers.xml

Parameters:

mgr - The manager

root - The xml root

Method Detail

getButtonLabels

protected String[] getButtonLabels()

_more_

Overrides:

getButtonLabels in class ChooserPanel

Returns:

_more_

getLoadToolTip

protected String getLoadToolTip()

Get the tooltip for the load button

Overrides:

getLoadToolTip in class ChooserPanel

Returns:

The tooltip for the load button

getUpdateToolTip

protected String getUpdateToolTip()

Get the tooltip for the update button

Overrides:

getUpdateToolTip in class ChooserPanel

Returns:

The tooltip for the update button

getRecentFilesComponent

protected JComponent getRecentFilesComponent()

Get the recent file component

Returns:

the component

getRecentFilesComponent

protected JComponent getRecentFilesComponent(int[] values,
                                             int value,
                                             boolean addPatternField)

Get the recent files component with the appropriate params

Parameters:

values - values

value - selected value

addPatternField - the pattern field

Returns:

the component

getFileCount

protected int getFileCount()

Get the count of recent files

Returns:

Recent file count

checkRecentPatternWidgetsEnable

protected void checkRecentPatternWidgetsEnable()

Disable or enable the file pattern widget and label

getFilePattern

protected String getFilePattern()

Get the file pattern

Returns:

the file pattern

doMakeContents

protected JComponent doMakeContents()

Construct a JFileChooser to put into the IdvChooserManager. Initialize to point to the DEFAULTDIR preference (if defined)

Overrides:

doMakeContents in class ChooserPanel

Returns:

The gui of this chooser

getAllowDirectorySelectionCbx

protected JCheckBox getAllowDirectorySelectionCbx()

Get the checkbox for allowing directory selection

Returns:

the checkbox

getTopComponents

protected void getTopComponents(List comps)

Get the top components for the chooser

Parameters:

comps - the top component

doMakeFileChooser

protected JFileChooser doMakeFileChooser(String path)

Make the file chooser

Parameters:

path - the initial path

Returns:

the file chooser

setHaveData

public void setHaveData(boolean haveData)

_more_

Overrides:

setHaveData in class ChooserPanel

Parameters:

haveData - _more_

shouldShowRecentComponent

protected boolean shouldShowRecentComponent()

Should show the recent (time relative) component

Returns:

false - subclasses should override

getAccessory

protected JComponent getAccessory()

Get the accessory component

Returns:

the component

selectFiles

protected final void selectFiles(File[] files,
                                 File directory)

Handle the selection of the set of files

Parameters:

files - The files the user chose

directory - The directory they chose them from

getFileChooser

protected JFileChooser getFileChooser()

Get the file chooser

Returns:

the chooser for this instance

doLoadInThread

public void doLoadInThread()

Override the base class method to catch the do load

Overrides:

doLoadInThread in class ChooserPanel

doUpdate

public void doUpdate()

Override the base class method to catch the do update

Overrides:

doUpdate in class ChooserPanel

selectFilesInner

protected boolean selectFilesInner(File[] files,
                                   File directory)
                            throws Exception

Handle the selection of the set of files

Parameters:

files - The files the user chose

directory - The directory they chose them from

Returns:

True if the file was successful

Throws:

Exception

getFileNames

protected String[] getFileNames(File[] files)

Convert the given array of File objects to an array of String file names. Only include the files that actually exist.

Parameters:

files - Selected files

Returns:

Selected files as Strings