AMAPstudio

User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
file_preview_and_checking_in_file_chooser [2017/12/08 15:56]
coligny
file_preview_and_checking_in_file_chooser [2018/03/12 15:42] (current)
coligny
Line 1: Line 1:
-====== ​File preview and checking ​in file choosers ======+====== ​Checking the files in file choosers ​/ File previews ​======
  
-fc-5.12.2017+fc-8.12.2017
  
-===== FileAccessory ===== 
  
-It is possible to add a preview in a Java JFileChooser to throw an eye at the files during the selection. 
  
-<code java> +===== Checking file format on the fly in a CheckingFileChooser:​ 2 methods =====
-chooser ​new JFileChooser(Settings.getProperty("​heterofor.species.path",​ PathManager.getInstallDir()));​ +
-new FileAccessory(chooser);​ +
  
-</​code>​+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. 
  
-{{::capsis-file-accessory-1.png?300|The preview (here on the right side) tries to shows the file content}}+The compatible files will be associated to a {{::ok.png|}} green mark, the others ​to a {{::​cancel.png|}} red mark.
  
 +The Preview is always shown in the CheckingFileChooser,​ it will show the mark for the selected file.
  
-===== Checking ​file format ​in the file chooser: method 1 - simple =====+**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.
  
-If the file is to be read with file loader (i.e. jeeb.lib.util RecordSet or FileLoader)it is possible to pass the file loader to a CheckingFileChooser. All the listed files will be evaluated with the file loader to evaluate their compatibility.+{{::capsis-file-accessory-windows.png?​300|The green and red marks in Windows'​ Look & Feel}}{{::​capsis-file-accessory-gtk-with-green-check.png?​300|Under GTK+ L&F, the mark can be seen in the file preview}}
  
-The compatible files will be associated to a {{::​ok.png|}} green mark, the others to a {{::​cancel.png|}} red mark. 
  
-**Note**: this process ​only checks ​the format ​of the file, there may still be errors at effective ​load time if the read values are not correct.+ 
 +==== 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. 
 + 
 +**See also** jeeb.lib.util.fileloader.FileLoader for a variant. 
 + 
 +**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.
  
 <code java> <code java>
Line 40: Line 45:
 </​code>​ </​code>​
  
 +{{::​heterofor-samsara-file-preview.png?​300|}}
  
 +==== 2. Advanced checking, with a more complex loading method ​ ====
  
- +When the loading method is complex, it is possible to override ​the check () method of CheckingFileChooser ​to propose ​complete code to check the file.
-===== CheckingFileChooser ===== +
- +
-It is also 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 result is green check mark associated to each correct file, and a red mark for those which will not load correctly. +
- +
-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.+
  
 <code java> <code java>
 // fc-4.12.2017 A file chooser showing which files can be loaded // fc-4.12.2017 A file chooser showing which files can be loaded
-JFileChooser chooser = new CheckingFileChooser(Settings.getProperty("​capsis.inventory.path",​+JFileChooser chooser = new CheckingFileChooser(Settings.getProperty("​samsara2.inventory.path",​
  PathManager.getDir("​data"​))) {  PathManager.getDir("​data"​))) {
  
- public ​boolean ​check(File f) {+ public ​void check(File f) throws Exception ​{
  String fileName = f.getAbsolutePath();​  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 + // Throws an exception ​if file can not be loaded
- ipFake.vParamMS.virtualStand = false; +
- ipFake.fileName = fileName; +
- ipFake.buildInitScene(modelFake);​+
  
- // Seems ok + // Use fake objects to avoid side effects 
- return true;+ Samsa2Model modelFake = new Samsa2Model();​ 
 + Samsa2InitialParameters ipFake = modelFake.getSettings();
  
- } catch (Throwable e) { + // Check if the file can be loaded 
- // Seems problematic + ipFake.vParamMS.virtualStand = false
- return ​false;+ ipFake.fileName = fileName; 
 + ipFake.buildInitScene(modelFake);
  
- } 
  }  }
 }; };
Line 83: Line 75:
 </​code>​ </​code>​
  
-{{::​capsis-file-accessory-windows.png?​300|The green and red marks in Windows'​ Look & Feel}}{{::​capsis-file-accessory-metal-with-green-and-red-marks.png?​300|A green mark shows which file will be loaded correctly}}{{::​capsis-file-accessory-gtk-with-green-check.png?​300|Under GTK+ L&F, the mark can be seen in the file preview}}+{{::​capsis-file-accessory-windows.png?​300|The green and red marks in Windows'​ Look & Feel}}{{::​capsis-file-accessory-metal-with-green-and-red-marks.png?​300|A green mark shows which file will be loaded correctly}} 
 + 
  
-===== Fast checking ===== 
  
-This is a proposal of a simple check () implementation for the CheckingFileChooser when the file is to be loaded by a RecordSet / FileLoader. 
  
-It 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. 
  
-**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. 
  
-**See also** jeeb.lib.util.fileloader.FileLoader for a variant. 
  
-<code java> 
-String path = inventoryFileName.getText();​ 
  
-JFileChooser chooser = new CheckingFileChooser(path) { 
- public boolean check(File file) { 
- try { 
- // Just checks if the loader loads, do not check until Plot creation 
- new Lub2InventoryLoader(file.getAbsolutePath());​ 
- return true; 
- } catch (Exception e) { 
- return false; 
- } 
- } 
-}; 
  
-</​code>​ 
  
 {{::​file-accessory-luberon2.png?​300|The files with a green mark are supposed to be loaded correctly if selected}} {{::​file-accessory-luberon2.png?​300|The files with a green mark are supposed to be loaded correctly if selected}}
 +
 +
 +
 +===== FileAccessory without file checking =====
 +
 +It is also possible to add a preview to a standard Java **JFileChooser** to throw an eye at the files during the selection.
 +
 +<code java>
 +chooser = new JFileChooser(Settings.getProperty("​heterofor.species.path",​ PathManager.getInstallDir()));​
 +new FileAccessory(chooser);​
 +
 +</​code>​
 +
 +{{::​capsis-file-accessory-1.png?​300|The preview (here on the right side) tries to shows the file content}}
 +
 +
 +
 +
file_preview_and_checking_in_file_chooser.1512748572.txt · Last modified: 2017/12/08 15:56 by coligny