Merged up to HEAD.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/WCM-DEV2/root@3129 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

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

@@ -0,0 +1,26 @@
+package org.alfresco.repo.transaction;
+
+
+/**
+ * Contract for a DAO to interact with a transaction.
+ * 
+ * @author davidc
+ */
+public interface TransactionalDao
+{
+    /**
+     * Allows the dao to flush any consuming resources.  This mechanism is
+     * used primarily during long-lived transactions to ensure that system resources
+     * are not used up.
+     * <p>
+     * This method must not be used for implementing business logic.
+     */
+    void flush();
+    
+    /**
+     * Are there any pending changes which must be synchronized with the store?
+     * 
+     * @return true => changes are pending
+     */
+    public boolean isDirty();
+}