**I don't see a ZipEntry for the Directory META-INF/ to be added in your list of files, is the manifest.xml file ending up in the root directory? then again, that's not the problem I guessing.**
> 1. "mimetype" (for this file, I set the ZipEntry method to STORED)
> 2. "manifest.xml" in a subfolder called "META-INF" (META-INF/manifest.xml)
> 3. "content.xml"
> 4. "styles.xml"
> 5. "meta.xml"
> 6. "thumbnail.png" in a subfolder called "Thumbnails" ("Thumbnails/thumbnail.png")
> 7. "settings.xml"
*That's why OO is freaking out for a moment and the and when you open it in winrar, winZip or any other zip utility and re-zip it, the utility will create the entry for the directories in the zipFile. by noticing that the file URL conforms to a valid path on the current OS, I beat if you took the bad zip file with not directory entries and opened in OO it may not be able to recover because the File.Separator is leaning the other way.*
*So In the case where you open it right in OO and it can't determine what type of content its opening maybe because it can't locate the manifest.xml which it would be expecting to unpack into the META-INF/ directory.*
*This causes a chain side effect. So when files that are inside directories are just seen as files with path "Configurations2/accelerator/current.xml" for example. But because the Name or the String Representation of the Path does not include actual folders, its just a string that looks like a path and so OO thinks "Configurations2/accelerator/current.xml" is the name of the file. It does not recognize it as two directories with a file init.*
**so why does zip utility or OO it self fix it at some point?**
*what's most likely going on is when OO unpacks the files tries to find the manifest.xml named entry, but it cant find it there is a "META-INF/manifest.xml" named entry or resource but it does a compare == 0 and withInString to find the keys.*
*And this gets fixed when the application(s) write the entry "META-INF/manifest.xml" back into a zipped file, it because of the "/" knows that this is a path that contains directories and adds the directories as entries in the zip file, so when it reopens or when it recovers by trying to save-reload the document it now has a directory META-INF/ as a entry it adds that first then the manifest.xml file into that dir and the ODF structure is what it likes*
**Important: When Adding files Images, Data, Video, Audio or any type you should either:
- Create a ZipEntry for each folder in the path. for /MyCustomImgDir/Trip/swimming.png
-- Entry Name: MyCustomImgDir/ should be added as a directory entry
-- and Entry Name: MyCustomImgDir/Trip/ should be added another directory entry
- OR you can add the file in the Meta-Inf/manifest.xml file and provide the full-path location so, OO can find-and-put it in the proper place.
**********************************************************************************
* Optianl Reading for more detail if you're not familir with zip files and paths *
**********************************************************************************
* Why the below section? - I spent many years working on a platform that used *
* the ODF format, when the API was limited and we were *
* and the only way to do many things was to rip aprt the*
* xml and add-delete-modify-move around the bytes all over*
* Major pain in the butt, I just want to same someonea few weeks*
* heck. (I can say that right?)
**********************************************************************************
So to further discuss and more details, Ex: I have a file.ods and when I list the contents of the file below is what I get with 15 files
kumar@PareshMacBookPro~/temp/eKits/variableData>unzip -l ../variabledata.ods
Archive: ../variabledata.ods
Length Date Time Name
-------- ---- ---- ----
46 04-11-08 18:36 mimetype
0 04-11-08 18:36 Configurations2/statusbar/
0 04-11-08 18:36 Configurations2/accelerator/current.xml
0 04-11-08 18:36 Configurations2/floater/
0 04-11-08 18:36 Configurations2/popupmenu/
0 04-11-08 18:36 Configurations2/progressbar/
0 04-11-08 18:36 Configurations2/menubar/
0 04-11-08 18:36 Configurations2/toolbar/
0 04-11-08 18:36 Configurations2/images/Bitmaps/
61403 04-11-08 18:36 content.xml
6909 04-11-08 18:36 styles.xml
1037 04-11-08 18:36 meta.xml
1355 04-11-08 18:36 Thumbnails/thumbnail.png
7668 04-11-08 18:36 settings.xml
1873 04-11-08 18:36 META-INF/manifest.xml
-------- -------
80291 15 files
*****************************************************************************
and Unziping it produces: (15 files, like it listed)
kumar@PareshMacBookPro~/temp/eKits>unzip -d variabledata variabledata.ods
Archive: variabledata.ods
extracting:/mimetype
creating:/Configurations2/statusbar/
inflating:/Configurations2/accelerator/current.xml
creating:/Configurations2/floater/
creating:/Configurations2/popupmenu/
creating:/Configurations2/progressbar/
creating:/Configurations2/menubar/
creating:/Configurations2/toolbar/
creating:/Configurations2/images/Bitmaps/
inflating:/content.xml
inflating:/styles.xml
extracting:/meta.xml
inflating:/Thumbnails/thumbnail.png
inflating:/settings.xml
inflating:/META-INF/manifest.xml
*****************************************************************************
so from my unzipped files and folders I rezip it without any change and looking at results show:
kumar@PareshMacBookPro~/temp/eKits/variableData>zip -ru newDocZip.zip *
zip warning: newDocZip.zip not found or empty
adding: Configurations2/ (stored 0%)
adding: Configurations2/accelerator/ (stored 0%)
adding: Configurations2/accelerator/current.xml (stored 0%)
adding: Configurations2/floater/ (stored 0%)
adding: Configurations2/images/ (stored 0%)
adding: Configurations2/images/Bitmaps/ (stored 0%)
adding: Configurations2/menubar/ (stored 0%)
adding: Configurations2/popupmenu/ (stored 0%)
adding: Configurations2/progressbar/ (stored 0%)
adding: Configurations2/statusbar/ (stored 0%)
adding: Configurations2/toolbar/ (stored 0%)
adding: META-INF/ (stored 0%)
adding: META-INF/manifest.xml (deflated 83%)
adding: Thumbnails/ (stored 0%)
adding: Thumbnails/thumbnail.png (deflated 44%)
adding: content.xml (deflated 89%)
adding: meta.xml (deflated 59%)
adding: mimetype (deflated 4%)
adding: settings.xml (deflated 87%)
adding: styles.xml (deflated 78%)
******************************************************************************
*****now there are 20 entries*******************
Why OO does not include a ZipEntry for folder that are in the middle of a path:
Example there is an entry at: Configurations2/accelerator/current.xml
but you do not see entries for directories:
- Configurations2/
and
- Configurations2/accelerator
Why Because it know when it keeps
******************************************************************************
** Notice that mimetype is the first ZipEntry in the ZipFile created by OO and its anywhere and where ever when created by a zip utility**
*Notice the META-INF/ and Thumbnails/ other folders that are added in order (<em>parent dir before children's<em>)!*
**So lets check out the mimetype of the .ods and .zip file with command line util:**
kumar@PareshMacBookPro~/temp/eKits>file --mime variabledata.ods
variabledata.ods: application/vnd.oasis.opendocument.spreadsheet; charset=binary
*you see that the mimetype shows as a application/spreadsheet and when you do the same for the new zip file (just rezipped unzipped ods content by zip util no changes to paths or files) you get:*
******************************************************************************
kumar@PareshMacBookPro~/temp/eKits/variabledata>file --mime newDoc.zip
newDoc.zip: application/zip; charset=binary
*it's no loger a spreadsheet it is an actual zip file content type.*
******************************************************************************
*Also just for fun you may want to output the raw bytes in a command line or consol by just 'cat' or 'head' or 'print' on the same files. You get trash but somethings there if look closer.*
******************************************************************************
kumar@PareshMacBookPro~/temp/eKits/variabledata>head ../variabledata.ods
PK???8?l9?.<em>mimetypeapplication/vnd.oasis.opendocument.spreadsheet<em>PK???8Configurations2/statusbar/???8'
**and re-zipped file, we've lost the content-type header and much more.**
******************************************************************************
kumar@PareshMacBookPro~/temp/eKits/variabledata>head newDoc.ods
PK
u??@Configurations2/UT ?? PF? Pux
?PK
******************************************************************************
***What to watch out for***
******************************************************************************
**It is not nesserry to have the content-type of the zip file as the <em>mimetypeapplication/vnd.oasis.opendocument.spreadsheet<em> it can be <em>applicatoin/zip<em> and openOffice will still be able to use it. The content-type is important to have there and correct, but for OpenOffice-Documents its more important to have the mimetype file in the root dir and have the META-INF/manifest.xml file in the directory META-INF/.
- The application does not look at the extension to determine the file type the OS does to launch the linked application for that extension, and if there is non it tries to find the content-type from the file header and find the appropriate application to handel file. Note that you can assign .txt or .jpeg to open with openOffice and it will open it even though its not a zip file.
- OO tries to start by looking at the file header to find the content-type first but it can live with out it.
- It then tries to find manifest.xml file. It placed it there so it can trust it. From that file It makes a check list of stuff listed in the manifest.xml file and cross checks it against the actual files (ZipEntires) extracted from the ZippedFile.
<em>Listed directories in the manifest.xml that are not in the zipContent as entries won't cause a problem long as its not expecting a file in that directory.<em>
- When it fails to read the file header (because its application/zip type), and the it does not have a mimetype. It will wiggout and want to find out really bad what type this file is. Or if there is file (i.e. ZipEntry) missing or it thinks its missing becuase the name is full string literal with the full path it can't resolve it to a ZipEntry Name Key. Even though, the real readable binary data is in the zip file, it will think something is wrong and ask to restore it but reproduce the zip content the best way it can.
- The ODF file is a zip format file but it's picky and expect things to in a certain place. **
******************************************************************************
**So whats the fix to not have this problem? Simply: You need to recursively walk the directories adding sub-dirs and files all of them.**
******************************************************************************
**In more detail:**
1. start at the root directory
2. RootDirectory.listfiles()
2a. if the entry from listfile()
2a-1) if aFile from the list is a real file then add that as the zipentry as you would
* then move on to the next item in your listfiles()
2a-2) if aFile from the list is a directory you need to add that as a entry in the zipfile as a dir by appending "/" at the end of the path.
* then again do a listfiles() on the directory to get files and dirs for the directory you just added and restart step 1. with the sub-directory as the RootDirectory and add its dirs and sub-dirs and files.
******************************************************************************
* other note to keep in mind:
******************************************************************************
** Of course there is the matter of using the right Encoding for the xml files and other files. Windows defualts to ios-8859-1 and Linux/Unix/Mac defaults to UTF-8 when new OutputSteams and writers are create. so if somethings working in nix and not winders, good place to look is at your streams**
******************************************************************************
Thanks, I hope you had as much fun reading this as I did writing it. I just hope it makes sense.
ps - sorry about the formatting job.