BasicFileChooserI (MyTISM API Documentation)

All Known Subinterfaces:

de.ipcon.db.core.BasicClientContextI, BasicDialogI, ClientContextI

All Known Implementing Classes:

Client, ClientFileChooserHelper
```
public interface BasicFileChooserI
```
Defines standard operations for opening, saving, and browsing filesystem paths.
Implementations are responsible for determining whether to display native OS file dialogs (e.g. via FlatLaf SystemFileChooser) or fallback to standard Swing JFileChooser components, as well as persisting last-recently-used (LRU) directory paths.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String key)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode, boolean quiet)` Deprecated. Use explicit native intent methods instead.
`default 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)` Deprecated. Use explicit native intent methods instead.
`default 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 accessoryComponent)` Deprecated. Use explicit native intent methods instead.
`default 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 accessoryComponent, java.io.File preselectedFile)` Deprecated. Use explicit native intent methods instead.
`default 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 accessoryComponent, java.io.File preselectedFile, java.io.File fallbackStartdir)` Deprecated. Use `showOpenFileChooser(java.lang.String, java.lang.String, boolean, javax.swing.filechooser.FileFilter)`, `showSaveFileChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, boolean, java.io.File)`, or `showFolderChooser(java.lang.String, java.lang.String, boolean, java.io.File)` to guarantee native OS dialog compliance (preventing invalid FlatLaf fallback combinations).
`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 accessoryComponent, java.io.File preselectedFile, java.io.File fallbackStartdir, int dialogType)` Internal and Legacy routing method for single file / directory selections.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String key)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String key, int selectionMode, javax.swing.filechooser.FileFilter filter)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default 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 accessoryComponent)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)` for native OS compliance.
`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 accessoryComponent, java.io.File fallbackStartdir)` Legacy multiple file routing method.
`default java.io.File`	`showFolderChooser(java.lang.String title)`
`default java.io.File`	`showFolderChooser(java.lang.String title, java.lang.String key)`
`default java.io.File`	`showFolderChooser(java.lang.String title, java.lang.String key, boolean quiet)`
`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.
`default java.io.File`	`showOpenFileChooser(java.lang.String title)`
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String key)`
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String key, boolean quiet)`
`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.
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title, java.lang.String key)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter)`
`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.
`default java.io.File`	`showSaveFileChooser(java.lang.String title)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String key)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter, boolean quiet)`
`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.
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String key, javax.swing.filechooser.FileFilter filter, java.io.File preselectedFile)`

Method Detail

showSaveFileChooser
```
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.

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.

showSaveFileChooser

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

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

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

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String key,
                                         javax.swing.filechooser.FileFilter filter)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String key)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser
```
default java.io.File showSaveFileChooser(java.lang.String title)
```
See Also:

showSaveFileChooser(String, String, FileFilter, boolean, File)

showOpenFileChooser
```
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.

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.

showOpenFileChooser

default java.io.File showOpenFileChooser(java.lang.String title,
                                         java.lang.String key,
                                         boolean quiet)

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser

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

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser

default java.io.File showOpenFileChooser(java.lang.String title,
                                         java.lang.String key)

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser
```
default java.io.File showOpenFileChooser(java.lang.String title)
```
See Also:

showOpenFileChooser(String, String, boolean, FileFilter)

showFolderChooser
```
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.

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.

showFolderChooser

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

See Also:: showFolderChooser(String, String, boolean, File)

showFolderChooser

default java.io.File showFolderChooser(java.lang.String title,
                                       java.lang.String key)

See Also:: showFolderChooser(String, String, boolean, File)

showFolderChooser
```
default java.io.File showFolderChooser(java.lang.String title)
```
See Also:

showFolderChooser(String, String, boolean, File)

showOpenFilesChooser
```
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.

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.

showOpenFilesChooser

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

See Also:: showOpenFilesChooser(String, String, FileFilter, File)

showOpenFilesChooser

default java.io.File[] showOpenFilesChooser(java.lang.String title,
                                            java.lang.String key)

See Also:: showOpenFilesChooser(String, String, FileFilter, File)

showOpenFilesChooser
```
default java.io.File[] showOpenFilesChooser(java.lang.String title)
```
See Also:

showOpenFilesChooser(String, String, FileFilter, File)

showFileChooser
```
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 accessoryComponent,
                             java.io.File preselectedFile,
                             java.io.File fallbackStartdir,
                             int dialogType)
```
Internal and Legacy routing method for single file / directory selections.

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.

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

preselectedFile - The initially selected file.

fallbackStartdir - 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.

showFileChooser

@Deprecated
default 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 accessoryComponent,
                                                 java.io.File preselectedFile,
                                                 java.io.File fallbackStartdir)

Deprecated. Use showOpenFileChooser(java.lang.String, java.lang.String, boolean, javax.swing.filechooser.FileFilter), showSaveFileChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, boolean, java.io.File), or showFolderChooser(java.lang.String, java.lang.String, boolean, java.io.File) to guarantee native OS dialog compliance (preventing invalid FlatLaf fallback combinations).

Shows a dialog to select a single file or directory.