edu.wisc.ssec.mcidasv.util.nativepathchooser

Class NativeFileChooser

java.lang.Object

edu.wisc.ssec.mcidasv.util.nativepathchooser.NativeFileChooser

public class NativeFileChooser
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.function.Supplier<javafx.stage.FileChooser>	fileChooserFactory

Constructor Summary

Constructors

Constructor and Description
NativeFileChooser(java.util.function.Supplier<javafx.stage.FileChooser> fileChooserFactory) Constructs a new file chooser that will use the provided factory.

Method Summary

Modifier and Type	Method and Description
<T> T	showDialog(java.util.function.Function<javafx.stage.FileChooser,T> method) Shows the FileChooser dialog by calling the provided method.
<T> T	showDialog(java.util.function.Function<javafx.stage.FileChooser,T> method, long timeout, java.util.concurrent.TimeUnit unit) Shows the FileChooser dialog by calling the provided method.
java.io.File	showOpenDialog() Shows a FileChooser using FileChooser.showOpenDialog().
java.util.List<java.io.File>	showOpenMultipleDialog() Shows a FileChooser using FileChooser.showOpenMultipleDialog().
java.io.File	showSaveDialog() Shows a FileChooser using FileChooser.showSaveDialog().

Methods inherited from class java.lang.Object

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

Field Detail

fileChooserFactory

private final java.util.function.Supplier<javafx.stage.FileChooser> fileChooserFactory

Constructor Detail

NativeFileChooser

public NativeFileChooser(java.util.function.Supplier<javafx.stage.FileChooser> fileChooserFactory)

Constructs a new file chooser that will use the provided factory. The factory is accessed from the JavaFX event thread, so it should either be immutable or at least its state shouldn't be changed randomly while one of the dialog-showing method calls is in progress. The factory should create and set up the chooser, for example, by setting extension filters. If there is no need to perform custom initialization of the chooser, FileChooser::new could be passed as a factory. Alternatively, the method parameter supplied to the showDialog() function can be used to provide custom initialization.

Parameters:

fileChooserFactory - the function used to construct new choosers

Method Detail

showDialog

public <T> T showDialog(java.util.function.Function<javafx.stage.FileChooser,T> method)

Shows the FileChooser dialog by calling the provided method. Waits for one second for the dialog-showing task to start in the JavaFX event thread, then throws an IllegalStateException if it didn't start.

Type Parameters:

T - the return type of the method, usually File or List<File>

Parameters:

method - a function calling one of the dialog-showing methods

Returns:

whatever the method returns

See Also:

showDialog(java.util.function.Function, long, java.util.concurrent.TimeUnit)

showDialog

public <T> T showDialog(java.util.function.Function<javafx.stage.FileChooser,T> method,
                        long timeout,
                        java.util.concurrent.TimeUnit unit)

Shows the FileChooser dialog by calling the provided method. The dialog is created by the factory supplied to the constructor, then it is shown by calling the provided method on it, then the result is returned.

Everything happens in the right threads thanks to SynchronousJFXCaller. The task performed in the JavaFX thread consists of two steps: construct a chooser using the provided factory and invoke the provided method on it. Any exception thrown during these steps will be rethrown in the calling thread, which shouldn't normally happen unless the factory throws an unchecked exception.

If the calling thread is interrupted during either the wait for the task to start or for its result, then null is returned and the Thread interrupted status is set.

Type Parameters:

T - return type (usually File or List<File>)

Parameters:

method - a function that calls the desired FileChooser method

timeout - time to wait for Platform.runLater() to start the dialog-showing task (once started, it is allowed to run as long as needed)

unit - the time unit of the timeout argument

Returns:

whatever the method returns

Throws:

java.lang.IllegalStateException - if Platform.runLater() fails to start the dialog-showing task within the given timeout

showOpenDialog

public java.io.File showOpenDialog()

Shows a FileChooser using FileChooser.showOpenDialog().

Returns:

the return value of FileChooser.showOpenDialog()

See Also:

showDialog(java.util.function.Function, long, java.util.concurrent.TimeUnit)

showSaveDialog

public java.io.File showSaveDialog()

Shows a FileChooser using FileChooser.showSaveDialog().

Returns:

the return value of FileChooser.showSaveDialog()

See Also:

showDialog(java.util.function.Function, long, java.util.concurrent.TimeUnit)

showOpenMultipleDialog

public java.util.List<java.io.File> showOpenMultipleDialog()

Shows a FileChooser using FileChooser.showOpenMultipleDialog().

Returns:

the return value of FileChooser.showOpenMultipleDialog()

See Also:

showDialog(java.util.function.Function, long, java.util.concurrent.TimeUnit)