Audit session and bootstrap support

- Sessions are created using an application name (shared prop) and a persisted model ID
 - Added a bootstrap bean for audit that unmarshalls the models
 - Added hook points for repo-loading models, but won't implement yet


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

source/java/org/alfresco/repo/audit/AuditComponent.java

@@ -77,14 +77,23 @@ public interface AuditComponent
      */
     public List<AuditInfo> getAuditTrail(NodeRef nodeRef);
 
+    /*
+     * V3.2 from here on.  Put all fixes to the older audit code before this point, please.
+     */
+
     /**
      * Start an audit session for the given root path.  All later audit operations on the resulting
      * session will be relative to this root path.
+     * <p/>
+     * The name of the application controls part of the audit model will be used.  The root path must
+     * start with the matching <b>key</b> attribute that was declared for the matching
+     * <b>Application</b> element in the audit configuration.
      * 
+     * @param application       the name of the application to log against
      * @param rootPath          a base path of {@link AuditPath} key entries concatenated with <b>.</b> (period)
      * @return                  Returns the unique session identifier
      */
-    public Long startAuditSession(String rootPath);
+    public Long startAuditSession(String application, String rootPath);
     
     /**
      * Record a set of values against the given session.