Added 'version' column to ADM entities

- A patch will assign initial version values to the entities
 - Deprecated TransactionUtil in favour of the RetryingTransactionHelper
 - Renamed RetryingTransactionHelper.Callback to RetryingTransactionHelper.RetryingTransactionCallback
   The name Callback clashes with many other classes in the classpath
 - Moved loads of components to be included in the retry behaviour
Duplicate name checks
 - This is done using a query, but the entity update is not written to the database early
 - Concurrent adds of the same-named child node will only fail at the end of the transaction
 - TODO: Detect the duplicate violation during transaction retrying
Workaround for ADMLuceneTest
 - Disable session size resource management during tests


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

source/java/org/alfresco/repo/transaction/TransactionUtil.java

@@ -37,7 +37,9 @@ import org.apache.commons.logging.LogFactory;
 /**
  * Class containing transactions helper methods and interfaces.
  * 
- * @author Roy Wetherall
+ * @deprecated  Use a {@link RetryingTransactionHelper} instance
+ * 
+ * @author Derek Hulley
  */
 public class TransactionUtil
 {
@@ -48,6 +50,9 @@ public class TransactionUtil
      * <p>
      * This interface encapsulates a unit of work that should be done within a
      * transaction.
+     * 
+     * @deprecated
+     * @see RetryingTransactionHelper.RetryingTransactionCallback
      */
     public interface TransactionWork<Result>
     {
@@ -74,6 +79,8 @@ public class TransactionUtil
      * @param transactionWork the transaction work
      * 
      * @throws java.lang.RuntimeException if the transaction was rolled back
+     * 
+     * @deprecated  Use a {@link RetryingTransactionHelper} instance
      */
     public static <R> R executeInUserTransaction(
             TransactionService transactionService,
@@ -91,6 +98,8 @@ public class TransactionUtil
      * @param readOnly true if the transaction should be read-only
      * 
      * @throws java.lang.RuntimeException if the transaction was rolled back
+     * 
+     * @deprecated  Use a {@link RetryingTransactionHelper} instance
      */
     public static <R> R executeInUserTransaction(
             TransactionService transactionService,
@@ -108,6 +117,8 @@ public class TransactionUtil
      * @param transactionWork the transaction work
      * 
      * @throws java.lang.RuntimeException if the transaction was rolled back
+     * 
+     * @deprecated  Use a {@link RetryingTransactionHelper} instance
      */
     public static <R> R executeInNonPropagatingUserTransaction(
             TransactionService transactionService,
@@ -125,6 +136,8 @@ public class TransactionUtil
      * @param readOnly true if the transaction should be read-only
      * 
      * @throws java.lang.RuntimeException if the transaction was rolled back
+     * 
+     * @deprecated  Use a {@link RetryingTransactionHelper} instance
      */
     public static <R> R executeInNonPropagatingUserTransaction(
             TransactionService transactionService,