de.ipcon.gui

Class ClientFileChooserHelper

java.lang.Object

de.ipcon.gui.ClientFileChooserHelper

All Implemented Interfaces:

BasicFileChooserI

public class ClientFileChooserHelper
extends java.lang.Object
implements BasicFileChooserI

Constructor Summary

Constructors

Constructor and Description
ClientFileChooserHelper(SessionI _session, de.ipcon.db.core.BasicClientContextI _ctx) Constructor for ClientFileChooserHelper

Method Summary

Modifier and Type	Method and Description
java.io.File	showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessory, java.io.File preselectedFile, java.io.File fallbackLastUsedDir, int dialogType) Internal and Legacy routing method for single file / directory selections.
java.io.File[]	showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessory, java.io.File fallbackLastUsedDir) Legacy multiple file routing method.
java.io.File	showFolderChooser(java.lang.String title, java.lang.String key, boolean quiet, java.io.File preselectedFile) Opens a native dialog strictly tailored to select a FOLDER / DIRECTORY.
java.io.File	showOpenFileChooser(java.lang.String title, java.lang.String key, boolean quiet, javax.swing.filechooser.FileFilter filter) Opens a native OPEN dialog strictly tailored to select a SINGLE EXISTING FILE.
java.io.File[]	showOpenFilesChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter, java.io.File preselectedFile) Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.
java.io.File	showSaveFileChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter, boolean quiet, java.io.File preselectedFile) Opens a native SAVE dialog with an input field for defining a file name.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.ipcon.tools.BasicFileChooserI

showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFolderChooser, showFolderChooser, showFolderChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFilesChooser, showOpenFilesChooser, showOpenFilesChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser

Constructor Detail

ClientFileChooserHelper

public ClientFileChooserHelper(SessionI _session,
                               de.ipcon.db.core.BasicClientContextI _ctx)

Constructor for ClientFileChooserHelper

Method Detail

showSaveFileChooser

public java.io.File showSaveFileChooser(java.lang.String title,
                                        java.lang.String key,
                                        javax.swing.filechooser.FileFilter filter,
                                        boolean quiet,
                                        java.io.File preselectedFile)

Opens a native SAVE dialog with an input field for defining a file name.

Note: Native OS save dialogs inherently support single-file selection only.

Implementation Note: Routes to the internal method, explicitly requesting a native SAVE dialog.

Specified by:

showSaveFileChooser in interface BasicFileChooserI

Parameters:

title - The title of the dialog.

key - The key under which this selection context is stored in the session (LRU dir tracking).

filter - The file filter to apply natively.

quiet - If true, suppresses the UI if the start directory is already set.

preselectedFile - The file to be initially selected (pre-fills the save input field).

Returns:

The selected File to save to, or null if canceled.

showOpenFileChooser

public java.io.File showOpenFileChooser(java.lang.String title,
                                        java.lang.String key,
                                        boolean quiet,
                                        javax.swing.filechooser.FileFilter filter)

Opens a native OPEN dialog strictly tailored to select a SINGLE EXISTING FILE.

Implementation Note: Routes to the internal method, explicitly requesting a native OPEN dialog.

Specified by:

showOpenFileChooser in interface BasicFileChooserI

Parameters:

title - The title of the dialog.

key - The key under which this selection context is stored in the session (LRU dir tracking).

quiet - If true, suppresses the UI if the start directory is already set.

filter - The file filter to apply.

Returns:

The selected existing File, or null if canceled.

showFolderChooser

public java.io.File showFolderChooser(java.lang.String title,
                                      java.lang.String key,
                                      boolean quiet,
                                      java.io.File preselectedFile)

Opens a native dialog strictly tailored to select a FOLDER / DIRECTORY.

Note: Native operating systems enforce directory selection via their "Open" dialog interface, even when the application intends to use the selected folder as a save/export destination.

Implementation Note: Routes to the internal method, explicitly requesting a native OPEN dialog strictly restricted to directories.

Specified by:

showFolderChooser in interface BasicFileChooserI

Parameters:

title - The title of the dialog (e.g. "Select Export Folder").

key - The key under which this selection context is stored in the session (LRU dir tracking).

quiet - If true, suppresses the UI if the start directory is already set.

preselectedFile - An optional directory to navigate into initially. If the directory does not exist, the OS typically falls back to the nearest existing parent.

Returns:

The selected directory as a File, or null if canceled.

showOpenFilesChooser

public java.io.File[] showOpenFilesChooser(java.lang.String title,
                                           java.lang.String key,
                                           javax.swing.filechooser.FileFilter filter,
                                           java.io.File preselectedFile)

Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.

Implementation Note: Bypasses the single-file router and calls chooseFile directly for native multi-selection.

Specified by:

showOpenFilesChooser in interface BasicFileChooserI

Parameters:

title - The title of the dialog.

key - The key under which this selection context is stored in the session (LRU dir tracking).

filter - The file filter to apply.

preselectedFile - A file to pre-select, positioning the user contextually.

Returns:

An array of selected File objects, or null if canceled.

showFileChooser

public java.io.File showFileChooser(java.lang.String title,
                                    java.lang.String approveText,
                                    java.lang.String key,
                                    int selectionMode,
                                    boolean quiet,
                                    javax.swing.filechooser.FileFilter filter,
                                    javax.swing.JComponent accessory,
                                    java.io.File preselectedFile,
                                    java.io.File fallbackLastUsedDir,
                                    int dialogType)

Description copied from interface: BasicFileChooserI

Internal and Legacy routing method for single file / directory selections.

Specified by:

showFileChooser in interface BasicFileChooserI

Parameters:

title - The dialog title.

approveText - The text on the approval button.

key - The key under which this selection context is stored in the session (LRU dir tracking).

selectionMode - The Swing selection mode constant.

quiet - If true, skips the dialog if LRU is known.

filter - The file filter to apply.

accessory - A custom Swing component (forces Swing fallback natively).

preselectedFile - The initially selected file.

fallbackLastUsedDir - The directory to start in if no LRU exists.

dialogType - The Swing dialog type (Open, Save, Custom).

Returns:

The selected File, or null if canceled.

showFilesChooser

public java.io.File[] showFilesChooser(java.lang.String title,
                                       java.lang.String approveText,
                                       java.lang.String key,
                                       int selectionMode,
                                       javax.swing.filechooser.FileFilter filter,
                                       javax.swing.JComponent accessory,
                                       java.io.File fallbackLastUsedDir)

Description copied from interface: BasicFileChooserI

Legacy multiple file routing method.

Specified by:

showFilesChooser in interface BasicFileChooserI

Parameters:

title - The dialog title.

approveText - The text on the approval button.

key - The key under which this selection context is stored in the session (LRU dir tracking).

selectionMode - The Swing selection mode constant.

filter - The file filter to apply.

accessory - A custom Swing component (forces Swing fallback natively).

fallbackLastUsedDir - The directory to start in if no LRU exists.

Returns:

An array of selected Files, or null if canceled.