Exported AuthenticationService via RMI. Insecure for now but we can switch over

to using SSL when needed.  Restructured exports of AVM specific apis to authenticate
remotely and pass the ticket with each remote service call.  These required some changes
to jndi-client and even to the web-client which uses the AVM remote interface within
the Alfresco server.  Oh, the point of this is that since I'm writing some CLTs, I might
as well do them correctly; we'll need the option of security sooner rather than later.


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

source/java/org/alfresco/service/cmr/avmsync/AVMSyncServiceTransport.java

@@ -0,0 +1,65 @@
+/**
+ * 
+ */
+package org.alfresco.service.cmr.avmsync;
+
+import java.util.List;
+
+/**
+ * A wrapper around AVMSyncService for remote access.
+ * @author britt
+ */
+public interface AVMSyncServiceTransport 
+{
+    /**
+     * Get a difference list between two corresponding node trees.
+     * @param srcVersion The version id for the source tree.
+     * @param srcPath The avm path to the source tree.
+     * @param dstVersion The version id for the destination tree.
+     * @param dstPath The avm path to the destination tree.
+     * @return A List of AVMDifference structs which can be used for
+     * the update operation.
+     */
+    public List<AVMDifference> compare(String ticket,
+                                       int srcVersion, String srcPath, 
+                                       int dstVersion, String dstPath);
+    
+    /**
+     * Updates the destination nodes in the AVMDifferences
+     * with the source nodes. Normally any conflicts or cases in
+     * which the source of an AVMDifference is older than the destination
+     * will cause the transaction to roll back.
+     * @param diffList A List of AVMDifference structs.
+     * @param ignoreConflicts If this is true the update will skip those 
+     * AVMDifferences which are in conflict with
+     * the destination.
+     * @param ignoreOlder If this is true the update will skip those 
+     * AVMDifferences which have the source older than the destination.
+     * @param overrideConflicts If this is true the update will override conflicting
+     * AVMDifferences and replace the destination with the conflicting source.
+     * @param overrideOlder If this is true the update will override AVMDifferences
+     * in which the source is older than the destination and overwrite the destination.
+     * @param tag Short comment.
+     * @param description Full update blurb.
+     */
+    public void update(String ticket, List<AVMDifference> diffList, boolean ignoreConflicts, boolean ignoreOlder,
+                       boolean overrideConflicts, boolean overrideOlder, String tag, String description);
+    
+    /**
+     * Flattens a layer so that all all nodes under and including
+     * <code>layerPath</code> become translucent to any nodes in the 
+     * corresponding location under and including <code>underlyingPath</code>
+     * that are the same version. 
+     * @param layerPath The overlying layer path.
+     * @param underlyingPath The underlying path.
+     */
+    public void flatten(String ticket, String layerPath, String underlyingPath);
+    
+    /**
+     * Takes a layer, deletes it and recreates it pointing at the same underlying
+     * node. Any changes in the layer are lost (except to history if the layer has been 
+     * snapshotted.)
+     * @param layerPath
+     */
+    public void resetLayer(String ticket, String layerPath);
+}