Merged DEV/MOB453 to HEAD

14474: MOB-453 Export multiple root nodes into a single export package (for RM)
___________________________________________________________________
Modified: svn:mergeinfo
   Merged /alfresco/BRANCHES/DEV/MOB453:r14474

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@14496 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/cmr/view/ExporterContext.java

@@ -1,20 +1,102 @@
+/*
+ * Copyright (C) 2005-2007 Alfresco Software Limited.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ * As a special exception to the terms and conditions of version 2.0 of 
+ * the GPL, you may redistribute this Program in connection with Free/Libre 
+ * and Open Source Software ("FLOSS") applications as described in Alfresco's 
+ * FLOSS exception.  You should have recieved a copy of the text describing 
+ * the FLOSS exception, and it is also available here: 
+ * http://www.alfresco.com/legal/licensing"
+ */
 package org.alfresco.service.cmr.view;
 
 import java.util.Date;
 
 import org.alfresco.service.cmr.repository.NodeRef;
 
+
 public interface ExporterContext
 {
-
+    /**
+     * Gets who initiated the export
+     * 
+     * @return
+     */
     public String getExportedBy();
     
+    /**
+     * Gets date at which export occured
+     * 
+     * @return
+     */
     public Date getExportedDate();
     
+    /**
+     * Gets version number of exporter
+     * 
+     * @return
+     */
     public String getExporterVersion();
     
+    /**
+     * Gets active node for export
+     * 
+     * @return NodeRef 
+     */
     public NodeRef getExportOf();
     
+    /**
+     * Gets parent of exporting node
+     * 
+     * @return NodeRef 
+     */    
     public NodeRef getExportParent();
     
+    /**
+     * Gets list of nodes for export
+     * 
+     * @return NodeRef[]
+     */
+    public NodeRef[] getExportList();
+    
+    /**
+     * Gets list of parents for exporting nodes
+     * 
+     * @return NodeRef[]
+     */
+    public NodeRef[] getExportParentList();
+    
+    /**
+     * Return true if there is active node for export
+     * 
+     * @return
+     */
+    public boolean canRetrieve();
+    
+    /**
+     * Set next active node from list
+     * 
+     * @return
+     */
+    public int setNextValue();
+    
+    /**
+     * Set first active node 
+     */
+    public void resetContext();
+    
 }

source/java/org/alfresco/service/cmr/view/Location.java

@@ -38,6 +38,7 @@ public class Location
 {
     private StoreRef storeRef = null;
     private NodeRef nodeRef = null;
+    private NodeRef[] nodeRefs = null;
     private String path = null;
     private QName childAssocType = null;
     
@@ -54,6 +55,19 @@ public class Location
         this.nodeRef = nodeRef;
     }
 
+    /**
+     * Construct
+     * 
+     * @param nodeRefs
+     */
+    public Location(NodeRef[] nodeRefs)
+    {
+        ParameterCheck.mandatory("Node Refs", nodeRefs);
+        this.storeRef = nodeRefs[0].getStoreRef();
+        this.nodeRefs = nodeRefs;
+    }
+
+
     /**
      * Construct
      * 
@@ -81,6 +95,20 @@ public class Location
         return nodeRef;
     }
     
+    /**
+     * @return  the node refs
+     */
+    public NodeRef[] getNodeRefs()
+    {
+        return nodeRefs;
+    }
+    
+    public void setNodeRefs(NodeRef[] nodeRefs)
+    {
+        this.nodeRef = null;
+        this.nodeRefs = nodeRefs;   
+    }
+    
     /**
      * Sets the location to the specified path
      *