What happens when a file cannot be saved?

[jferard]

Currently, there is no way to distinguish the following cases:

• the file cannot be saved because the filename is a directory name
• the file can be saved but the current file will be overwritten
• the file can be saved without problem (I do not consider usual I/O problems). The library may be used in an application which has to handle the cases above (e.g. in the GUI), so its important to distinguish (exception or boolean return) thoses cases.

[jferard]

Other case: the file can't be saved because the path is wrong.

[jferard]

Conclusion:

• use if necessary OdsFactory.checkFile to check if the name is available ;
• the save|saveAs methods will throw an exception if the file can't be saved.

[jferard]

Better solution: use OdsFactory.openFile, and check the type of the result.