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

- Full start/stop/status using WebScripts
 - AuditService API additions to support
 - .ftl to generate json response
 - Some javadoc and debug additions


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

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

@@ -20,7 +20,6 @@ package org.alfresco.service.cmr.audit;
 
 import java.io.Serializable;
 import java.util.Map;
-import java.util.Set;
 
 import org.alfresco.service.PublicService;
 
@@ -47,15 +46,49 @@ public interface AuditService
      * @since 3.4
      */
     void setAuditEnabled(boolean enable);
+
+    /**
+     * Helper bean to carry information about an audit application.
+     * 
+     * @author Derek Hulley
+     * @since 3.4
+     */
+    public static class AuditApplication
+    {
+        private final String name;
+        private final String key;
+        private final boolean enabled;
+        /**
+         * Constructor for final variables
+         */
+        public AuditApplication(String name, String key, boolean enabled)
+        {
+            this.name = name;
+            this.key = key;
+            this.enabled = enabled;
+        }
+        public String getName()
+        {
+            return name;
+        }
+        public String getKey()
+        {
+            return key;
+        }
+        public boolean isEnabled()
+        {
+            return enabled;
+        }
+    }
     
     /**
      * Get all registered audit applications
      * 
-     * @return                  Returns a set of all available audit applications
+     * @return                  Returns a map of audit applications keyed by their name
      * 
      * @since 3.4
      */
-    Set<String> getAuditApplications();
+    Map<String, AuditApplication> getAuditApplications();
     
     /**
      * @param applicationName   the name of the application to check