AMAPstudio

### Sidebar

This is an old revision of the document!

# File preview and checking in file choosers

fc-5.12.2017

## Checking file format in the CheckingFileChooser: 2 methods

It is possible to use the CheckingFileChooser instead of the JFileChooser to check during selection which files will be loaded without error. The process relies on a method to be redefined called check (File f). When the file given to this method is correct, the method must return true.

The compatible files will be associated to a green mark, the others to a red mark.

The Preview is always shown in the CheckingFileChooser, it will show the mark for the selected file.

Warning: some Java look and feels do not show the icon for each file during selection (e.g. GTK+ under Linux). In this case, the mark can still be seen in the FileAccessory preview.

### 1. Simple checking, format only, with a standard RecordSet / FileLoader

If the file is to be read with a file loader (i.e. jeeb.lib.util RecordSet or FileLoader), it is possible to pass the file loader class to a CheckingFileChooser. All the listed files will be evaluated with the file loader to evaluate their compatibility.

Note: jeeb.lib.util.RecordSet is a tool to build text file loaders quickly, by specifying the expected line formats in objects extending the Record class. Giving a fileName to the tool, it will use introspection to check if the lines match the given Records and turn the file into a List of Records, easying their interpretation in a load () method called after.

Note: this process will check the file format interpretation by the loader but will not go further: an error might still happen later during effective file loading, when interpreting the content of the fields and lines.

// fc-8.11.2017 CheckingFileChooser tells user which files are supposed
// to be correct
JFileChooser chooser = CheckingFileChooser.getInstance(
Settings.getProperty("heterofor.samsaraLightPath", PathManager.getDir("data") + File.separator

chooser.setDialogTitle(Translator.swap("HetInitialDialog.fileChooser"));

int returnVal = chooser.showDialog(this, null); // null: approveButton text was already set

if (returnVal == JFileChooser.APPROVE_OPTION && chooser.getSelectedFile().exists())
samsaraLightFileName.setText(chooser.getSelectedFile().getPath());

When the loading method is complex, it is possible to override the check () method of CheckingFileChooser to propose a complete code to check the file.

// fc-4.12.2017 A file chooser showing which files can be loaded
JFileChooser chooser = new CheckingFileChooser(Settings.getProperty("capsis.inventory.path",
PathManager.getDir("data"))) {

public boolean check(File f) {
String fileName = f.getAbsolutePath();
try {
// Use fake objects to avoid side effects
Samsa2Model modelFake = new Samsa2Model();
Samsa2InitialParameters ipFake = modelFake.getSettings();

// Check if the file can be loaded
ipFake.vParamMS.virtualStand = false;
ipFake.fileName = fileName;
ipFake.buildInitScene(modelFake);

// Seems ok
return true;

} catch (Throwable e) {
// Seems problematic
return false;

}
}
};

## FileAccessory without file checking

It is possible to add a preview in a Java JFileChooser to throw an eye at the files during the selection.

chooser = new JFileChooser(Settings.getProperty("heterofor.species.path", PathManager.getInstallDir()));
new FileAccessory(chooser);