[exoplatform] eXo JCR 1.5.2 update released

["Gennady Azarenkov" <gazarenkov@xxxxxxxxx>]

eXo JCR 1.5.2 update released
http://forge.objectweb.org/project/download.php?group_id=151&file_id=9262


Notes

eXo JCR core 1.5.2 release is mainly intended to update from 1.5.x to never versions of eXo JCR due to changes in
persistent storage structure with some other bug fixes and small improvements.

The main difference between previous 1.5 versions is updating of import/export procedure, now it uses XML
Streaming (a.k.a. Stax) which allows exporting big JCR structure and so it can be imported to the never eXo JCR storage,


Here are typical steps to update:

 To update eXo JCR 1.5.X to 1.5.2 you need just replace
 exo-jcr.frameworks.command-1.5.jar
 exo-jcr.services.jcr.api-1.5.jar
 exo-jcr.services.jcr.impl-1.5.jar


 with newer *.-1.5.2 files

Migration to a newer releases
=============================

The Migration is possible via export/import to/from XML files.

For exporting some node (tree) to the XML file (system view) apply following to your eXo JCR 
1.5.2 repository
(where destPath - it is a path to the creating file)

 File destFile = new File(destPath);

 session.exportSystemView(source.getPath(), new FileOutputStream(destFile), false, false);
 //Do not forget close stream

 outStream.close();

For importing some node (tree) from the XML file (system view) apply following to your eXo JCR 1.7+ repository
(where pathToFile - it is a path to the file containing JCR data)

 File srcFile  = new File(pathToFile);

 //import data
 session.importXML (target.getPath(), new FileInputStream(destFile), ImportUUIDBehavior.IMPORT_UUID_COLLISION_THROW);
 // save in to persistent storage
 session.save();

NOTE: such an import procedure wont work for root node, so prepare several files for root's children and then 

import them one by one


Changes:
Bug fixes
=========
 JCR-306 UploadFileCommand doesn't extract filename properly on linux
 JCR-329 ValueData lifecycle refactoring (problems with FileNotFoundException during Node update, move fixed)


Changes and improvements
========================

 JCR-307 add jcr sql creation script for oracle (multidb)
 JCR-324 Porting export import implementation from 1.7 to 1.5 (StAX based, BLOB operation optimized)

 JCR-328 Be more tolerant with data inconsistancies at import (properties may be skipped if the nodetype disallow it)
 Multi value BLOB properties with external values storage bugfix.