resource-management-r0 -- Change the way Sophie handles large resources

[deyan]

• Make the "Link" and "Copy to files" always visible
• Make the default action for large resources "Link" with "Copy to files" checked
• If the book was never saved, the contents should be linked from a temporary directory and moved on save.

[meddle]

• I don't like the name of the task, it is not a bugfix. I think a proper name is CLIENT_SIDE_LARGE_RESOURCES_R0.
• I think that this task can include and fixing the exceptions thrown when the linked resource is missing. So I will try to fix it if I have time.

[meddle]

• We will use the temporary directory of the OS to store linked "relative" files if the book is not saved yet.
• The temporary directory will be retrieved with the System property java.io.tmpdir
  • In it a directory with the name of the unsaved book will be created (UUID string, unique).
  • All the files will be stored there, we will not use createTmpFile methods, because they change the names of the files and don't save the directory structure.
  • All the directories and files there will be marked with the File#deleteOnExit() method.
• In the ResourceFilesUtil will be added public static void copyResources(ResourceH resource, File fileToBeSaved) method that copies the files from the temporary directory to the true relative '_files' directory of the book.
• The ResourceFilesUtil's getFilesDir methods will work with memory resources, but will retrieve the directory in the temporary dir.
• In the SaveDocUtil public static boolean saveBookToFile(BookDocView bookDocView) will have the following changes after the file to save the book is determined:

  if (resAcc.getLocation().startsWith(LocationPrefix.MEMORY) 
  	&& ResourceFilesUtil.hasFileDirectory(book)) {
  	ResourceFilesUtil.copyResources(book, file);
  }
  
  

• Modified the BinDataChooser to have the checkbox for copying resources in the relative dir always enabled when link is choosen and by default checked.
• There are tests:
  • Test for the new functionallity -> ResourceFilesUtilTest
  • Fixed the Demo for the BinDataChooser BinDataChooserDemo.
  • Fixed the MediaPersistenceTest

[pap]

• Seems generally ok.
• As I told you the addition to SaveDocUtil seems unnecessary and maybe the new method in ResourceFilesUtil
• I think that it is better to use patches than branches when possible.
• Also I like the way you link files but sometimes it is useful to see the changes to those files.

[meddle]

• Use the browser to view the changes :)
• I thought the task will be more complex, that is why I use branch.

[meddle]

Implementation done.

• Now all the large resources by default are inserted as 'link and copy'.
• When the user opens a book with linked resource and it can not be found there is no exception thrown
• There is exception when the resource that is linked is removed while playing. The problem is that the BinSourceNotFoundException is thrown in the AudioThread of the NativeMediaHandler and not in the EDT so it can not be caught. I tried some solutions but after two hours I decided that the problem is not trivial so it should be in its own ticket.

Implementation code:

• ​svn://sophie2.org/sophie2/branches/private/meddle/large_resources_1
• [browse:branches/private/meddle/large_resources_1]

[meddle]

I had some problems with the track so:
implementation

[meddle]

I fixed the exception with the missing resource adding a BrokenAudioChunk that holds the error. If the chunk is broken one, the media view shows it's problem.

[deyan]

Batch update from file query.csv

[pap]

• Commited in [8743].
• I have no serious objection

[meddle]

Closing all the tickets before M Y1