ALF-4106 (ALF-4103): AuditService REST API

- Enable/disable auditing and tests
 - TODO: Use .ftl to generate JSON from model


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

source/java/org/alfresco/service/cmr/audit/AuditService.java

@@ -32,6 +32,22 @@ import org.alfresco.service.PublicService;
 @PublicService
 public interface AuditService
 {
+    /**
+     * @return                  Returns <tt>true</tt> if auditing is globally enabled
+     * 
+     * @since 3.4
+     */
+    boolean isAuditEnabled();
+    
+    /**
+     * Enable or disable the global auditing state
+     * 
+     * @param enable            <tt>true</tt> to enable auditing globally or <tt>false</tt> to disable
+     * 
+     * @since 3.4
+     */
+    void setAuditEnabled(boolean enable);
+    
     /**
      * Get all registered audit applications
      * 
@@ -41,13 +57,6 @@ public interface AuditService
      */
     Set<String> getAuditApplications();
     
-    /**
-     * @return                  Returns <tt>true</tt> if auditing is globally enabled
-     * 
-     * @since 3.4
-     */
-    boolean isAuditEnabled();
-    
     /**
      * @param applicationName   the name of the application to check 
      * @param path              the path to check
@@ -83,9 +92,24 @@ public interface AuditService
      * @param applicationName   the name of the application for which to remove entries
      * 
      * @since 3.2
+     * 
+     * @deprecated          Use {@link #clearAudit(String, Long, Long)}
      */
     void clearAudit(String applicationName);
     
+    /**
+     * Remove audit entries for the given application between the time ranges.  If no start
+     * time is given then entries are deleted as far back as they exist.  If no end time is
+     * given then entries are deleted up until the current time.
+     * 
+     * @param applicationName   the name of the application for which to remove entries
+     * @param fromTime          the start time of entries to remove (inclusive and optional)
+     * @param toTime            the end time of entries to remove (exclusive and optional)
+     * 
+     * @since 3.4
+     */
+    void clearAudit(String applicationName, Long fromTime, Long toTime);
+    
     /**
      * The interface that will be used to give query results to the calling code.
      *