Merge DM-DM_deployment to HEAD

18665 : Switch over to using new surf <formdata multipart-processing="false" /> configuration option.
   - now the PostContentCommandProcessor and PostSnapshotCommandProcessor handle their own MimePart processing.
  18683 : SAIL-288 Implementation of TransferService client side cancelAsync.
  18716 : Adding TransferEventBegin missed from asyncCancel work.
  18734 : Transfer format : implementation of null properties and Serialized base64 Java objects for type d:any
  18749 : SAIL-290: Added features that provide asynchronous commit on the receiver end and the ability to query commit status, as well as code that writes a progress report on the server side (currently only plain text) and the functionality to allow a transfer to be cancelled
  18750 : New files that should have been checked in with previous commit but weren't...
  18770 : Various transfer service work.
   - correction to transfer report name.
   - use surf Base64 Encoder
   - implementation of async commit to the TransferServiceImpl
   - implementation of the statusCommand through the HttpClientTransmitter.
  18773 : transferId was null.
  18780 : Changed the server-side commit to occur asynchronously.
	Added two test actions to transfer a single node or a tree of nodes.
	Tweaked TransferDefinition to provide varargs version of setNodes.
  18793 : SAIL-290:    Added a couple of test actions.
    	Added varargs versions of transfer and transferAsync on TransferService.
  18794 : SAIL-290: Added "targetExists" operation to the TransferService interface.
  18804 : SAIL-36: Fixed an issue where transfer could fail if numerous nodes with the same cm:name value are transferred.
  18805 : SAIL-36: Added model file that should have been with last commit.
  18808 Continuing work on transfer report.
  18825 TransferServiceImplTest green line.
  18836 : Added a little more output to the server-side transfer report. 
  18848 : More work on transfer report.

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

source/java/org/alfresco/service/cmr/transfer/TransferService.java

@@ -25,6 +25,7 @@
 
 package org.alfresco.service.cmr.transfer;
 
+import java.util.Collection;
 import java.util.Set;
 
 import org.alfresco.service.cmr.repository.NodeRef;
@@ -63,24 +64,55 @@ public interface TransferService
      * @throws TransferException
      * @return the node reference of the transfer report
      */       
-   public NodeRef transfer(String targetName, TransferDefinition definition, Set<TransferCallback> callback) throws TransferException;
+   public NodeRef transfer(String targetName, TransferDefinition definition, Collection<TransferCallback> callback) throws TransferException;
    
    /**
-    * Transfer nodes async with callback.   The asynchronous version of the transfer method starts a transfer and returns as 
-    * soon as possible.
-    * The transfer callbacks will be called by a different thread to that used to call the transferAsync method so transaction 
-    * context will be different to the calling context. 
-    * 
-    * Please also be aware that the asychronous transfer does not have access to uncommitted 
-    * data in the calling transaction.
-    * 
+    * Transfer nodes sync, with callback.  This synchronous version of the transfer method waits for the transfer to complete 
+    * before returning to the caller.  Callbacks are called in the current thread context, so will be associated with the current 
+    * transaction and user.
+    *  
     * @param targetName the name of the target to transfer to
-    * @param definition - the definition of the transfer. Specifies which nodes to transfer.  
+    * @param definition - the definition of the transfer.   Specifies which nodes to transfer. 
     * The following properties must be set, nodes
-    * @param callback - a set of callback handlers that will be called as transfer proceeds.  May be null.
+    * @param callbacks - a list of callback handlers that will be called as transfer proceeds.  May be null.
     * @throws TransferException
+    * @return the node reference of the transfer report
     */       
-   public void transferAsync(String targetName, TransferDefinition definition, Set<TransferCallback> callback) throws TransferException;
+  public NodeRef transfer(String targetName, TransferDefinition definition, TransferCallback... callbacks) throws TransferException;
+  
+  /**
+   * Transfer nodes async with callback.   The asynchronous version of the transfer method starts a transfer and returns as 
+   * soon as possible.
+   * 
+   * The transfer callbacks will be called by a different thread to that used to call the transferAsync method so transaction 
+   * context will be different to the calling context. The asychronous transfer does not have access to uncommitted 
+   * data in the calling transaction.
+   * 
+   * @param targetName the name of the target to transfer to
+   * @param definition - the definition of the transfer. Specifies which nodes to transfer.  
+   * The following properties must be set, nodes
+   * @param callback - a collection of callback handlers that will be called as transfer proceeds.  May be null.
+   * 
+   * @throws TransferException
+   */       
+  public void transferAsync(String targetName, TransferDefinition definition, Collection<TransferCallback> callback) throws TransferException;
+
+  /**
+   * Transfer nodes async with callback.   The asynchronous version of the transfer method starts a transfer and returns as 
+   * soon as possible.
+   * 
+   * The transfer callbacks will be called by a different thread to that used to call the transferAsync method so transaction 
+   * context will be different to the calling context. The asychronous transfer does not have access to uncommitted 
+   * data in the calling transaction.
+   * 
+   * @param targetName the name of the target to transfer to
+   * @param definition - the definition of the transfer. Specifies which nodes to transfer.  
+   * The following properties must be set, nodes
+   * @param callbacks - a collection of callback handlers that will be called as transfer proceeds.  May be null.
+   * 
+   * @throws TransferException
+   */       
+  public void transferAsync(String targetName, TransferDefinition definition, TransferCallback... callbacks) throws TransferException;
 
     /**
       * Verify a target is available and that the configured credentials correctly identify an admin user.     
@@ -119,6 +151,13 @@ public interface TransferService
      */
     public TransferTarget getTransferTarget(String name) throws TransferException;
     
+    /**
+     * Test to see if the target with the specified name exists
+     * @param name
+     * @return true if the specified target exists, and false otherwise
+     */
+    public boolean targetExists(String name);
+    
     /**
      * Delete a transfer target.  After calling this method the transfer target will no longer exist.
      * @throws TransferException - target does not exist
@@ -153,4 +192,23 @@ public interface TransferService
      */
     public void enableTransferTarget(String name, boolean enable) throws TransferException;
     
+    /**
+     * Asynchronously cancel an in-progress transfer
+     * 
+     * This method tells an in-process transfer to give up, rollback and stop as soon as possible.
+     * 
+     * Depending upon the state of the in-progress transfer, the transfer may still complete, 
+     * despite calling this method, however in most cases the transfer will not complete.    
+     * 
+     * Calling this method for a transfer that does not exist, possibly because it has already finished, has no 
+     * effect and will not throw an exception.
+     * 
+     * The transfer handle is returned by a TransferEventBegin event callback.
+     * 
+     * @param transferId the unique identifier for the instance of the transfer to cancel.
+     * 
+     * @see TransferEventBegin;
+     */
+    public void cancelAsync(String transferId);
+    
 }