org.geotools.swing.data
Class JFileDataStoreChooser

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by javax.swing.JFileChooser
                  extended by org.geotools.swing.data.JFileDataStoreChooser
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class JFileDataStoreChooser
extends javax.swing.JFileChooser

A file chooser dialog to get user choices for data stores.

Examples of use:

// prompt the user for a shapefile
 File file = JFileDataStoreChooser.showOpenFile("shp", parentFrame);
 if (file != null) {
    ...
 }

 // prompt the user for a given data format

 

Since:
2.6
Version:
$Id: JFileDataStoreChooser.java 35249 2010-04-20 02:14:23Z jive $
Author:
Jody Garnett
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JFileChooser
javax.swing.JFileChooser.AccessibleJFileChooser
 
Nested classes/interfaces inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class javax.swing.JFileChooser
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY, accessibleContext, ACCESSORY_CHANGED_PROPERTY, APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY, APPROVE_BUTTON_TEXT_CHANGED_PROPERTY, APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY, APPROVE_OPTION, APPROVE_SELECTION, CANCEL_OPTION, CANCEL_SELECTION, CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY, CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY, CUSTOM_DIALOG, DIALOG_TITLE_CHANGED_PROPERTY, DIALOG_TYPE_CHANGED_PROPERTY, DIRECTORIES_ONLY, DIRECTORY_CHANGED_PROPERTY, ERROR_OPTION, FILE_FILTER_CHANGED_PROPERTY, FILE_HIDING_CHANGED_PROPERTY, FILE_SELECTION_MODE_CHANGED_PROPERTY, FILE_SYSTEM_VIEW_CHANGED_PROPERTY, FILE_VIEW_CHANGED_PROPERTY, FILES_AND_DIRECTORIES, FILES_ONLY, MULTI_SELECTION_ENABLED_CHANGED_PROPERTY, OPEN_DIALOG, SAVE_DIALOG, SELECTED_FILE_CHANGED_PROPERTY, SELECTED_FILES_CHANGED_PROPERTY
 
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
JFileDataStoreChooser(FileDataStoreFactorySpi format)
          Creates a dialog that filters for files matching the specified data format.
JFileDataStoreChooser(java.util.List<java.lang.String> extensions)
          Create a dialog that filters for files with the specified extensions.
JFileDataStoreChooser(java.util.Map<java.lang.String,java.lang.String> fileAssociations)
          Creates a dialog based on the given file associations.
JFileDataStoreChooser(java.lang.String extension)
          Create a dialog that filters for files with the specified extension.
JFileDataStoreChooser(java.lang.String[] extensions)
          Create a dialog that filters for files with the specified extensions.
 
Method Summary
static void main(java.lang.String[] arg)
          Demonstrates the file data store dialog by prompting for a shapefile
 void setSaveFile(java.io.File file)
          Consider the provided file as a candidate for a new filename.
static java.io.File showOpenFile(FileDataStoreFactorySpi format, java.awt.Component parent)
          Show a file open dialog that filters for files that match a given file data store format
static java.io.File showOpenFile(FileDataStoreFactorySpi format, java.io.File initialDir, java.awt.Component parent)
          Show a file open dialog that filters for files that match a given file data store format
static java.io.File showOpenFile(java.lang.String[] extensions, java.awt.Component parent)
          Show a file open dialog that filters for files with the given extensions.
static java.io.File showOpenFile(java.lang.String[] extensions, java.io.File initialDir, java.awt.Component parent)
          Show a file open dialog that filters for files with the given extensions.
static java.io.File showOpenFile(java.lang.String extension, java.awt.Component parent)
          Show a file open dialog that filters for files with the given extension.
static java.io.File showOpenFile(java.lang.String extension, java.io.File initialDir, java.awt.Component parent)
          Show a file open dialog that filters for files with the given extension.
 
Methods inherited from class javax.swing.JFileChooser
accept, addActionListener, addChoosableFileFilter, approveSelection, cancelSelection, changeToParentDirectory, createDialog, ensureFileIsVisible, fireActionPerformed, getAcceptAllFileFilter, getAccessibleContext, getAccessory, getActionListeners, getApproveButtonMnemonic, getApproveButtonText, getApproveButtonToolTipText, getChoosableFileFilters, getControlButtonsAreShown, getCurrentDirectory, getDescription, getDialogTitle, getDialogType, getDragEnabled, getFileFilter, getFileSelectionMode, getFileSystemView, getFileView, getIcon, getName, getSelectedFile, getSelectedFiles, getTypeDescription, getUI, getUIClassID, isAcceptAllFileFilterUsed, isDirectorySelectionEnabled, isFileHidingEnabled, isFileSelectionEnabled, isMultiSelectionEnabled, isTraversable, paramString, removeActionListener, removeChoosableFileFilter, rescanCurrentDirectory, resetChoosableFileFilters, setAcceptAllFileFilterUsed, setAccessory, setApproveButtonMnemonic, setApproveButtonMnemonic, setApproveButtonText, setApproveButtonToolTipText, setControlButtonsAreShown, setCurrentDirectory, setDialogTitle, setDialogType, setDragEnabled, setFileFilter, setFileHidingEnabled, setFileSelectionMode, setFileSystemView, setFileView, setMultiSelectionEnabled, setSelectedFile, setSelectedFiles, setup, showDialog, showOpenDialog, showSaveDialog, 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, 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
 

Constructor Detail

JFileDataStoreChooser

public JFileDataStoreChooser(java.lang.String extension)
Create a dialog that filters for files with the specified extension.

Parameters:
extension - the file extension, with or without the leading '.'

JFileDataStoreChooser

public JFileDataStoreChooser(java.util.List<java.lang.String> extensions)
Create a dialog that filters for files with the specified extensions.

Parameters:
extensions - the file extensions, with or without the leading '.'

JFileDataStoreChooser

public JFileDataStoreChooser(java.lang.String[] extensions)
Create a dialog that filters for files with the specified extensions.

Parameters:
extensions - the file extensions, with or without the leading '.'

JFileDataStoreChooser

public JFileDataStoreChooser(java.util.Map<java.lang.String,java.lang.String> fileAssociations)
Creates a dialog based on the given file associations.

 Map assoc = new HashMap();
 assoc.put(".foo", "Foo data files (*.foo)");
 assoc.put(".bar", "Bar data files (*.bar)");
 JFileDataStoreChooser chooser = new JFileDataStoreChooser(assoc);
 

Parameters:
fileAssociations - a Map where keys are extensions (with or wirhout the leading dot) and values are descriptions.

JFileDataStoreChooser

public JFileDataStoreChooser(FileDataStoreFactorySpi format)
Creates a dialog that filters for files matching the specified data format.

Parameters:
format - data file format
Method Detail

showOpenFile

public static java.io.File showOpenFile(java.lang.String extension,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files with the given extension.

Parameters:
extension - file extension, with or without leading '.'
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

showOpenFile

public static java.io.File showOpenFile(java.lang.String extension,
                                        java.io.File initialDir,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files with the given extension.

Parameters:
extension - file extension, with or without leading '.'
initialDir - initial directory to display; if null the initial directory will be the user's default directory
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

showOpenFile

public static java.io.File showOpenFile(java.lang.String[] extensions,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files with the given extensions.

Parameters:
extensions - array of file extension, with or without leading '.'
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

showOpenFile

public static java.io.File showOpenFile(java.lang.String[] extensions,
                                        java.io.File initialDir,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files with the given extensions.

Parameters:
extensions - array of file extension, with or without leading '.'
initialDir - initial directory to display; if null the initial directory will be the user's default directory
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

showOpenFile

public static java.io.File showOpenFile(FileDataStoreFactorySpi format,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files that match a given file data store format

Parameters:
format - the file data store format
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

showOpenFile

public static java.io.File showOpenFile(FileDataStoreFactorySpi format,
                                        java.io.File initialDir,
                                        java.awt.Component parent)
                                 throws java.awt.HeadlessException
Show a file open dialog that filters for files that match a given file data store format

Parameters:
format - the file data store format
initialDir - initial directory to display; if null the initial directory will be the user's default directory
parent - parent GUI component (may be null)
Returns:
the selected file or null if the user cancelled the selection
Throws:
java.awt.HeadlessException - if run in an unsupported environment

main

public static void main(java.lang.String[] arg)
Demonstrates the file data store dialog by prompting for a shapefile

Parameters:
arg - ignored

setSaveFile

public void setSaveFile(java.io.File file)
Consider the provided file as a candidate for a new filename. A number will be appended to the filename if there is a conflict.

Parameters:
file - the candidate file name


Copyright © 1996-2010 Geotools. All Rights Reserved.