Added audit entry ID (from and to) as search parameters (requ. for CMIS)

- This change will be needed when fixing ETHREEOH-3487: Searching on Events does not restrict the audit result.
 - Moved parameters from method arguments into AuditQueryParameters
 - Deprecated old auditQuery APIs and fixed up Alfresco usage


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

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

@@ -180,6 +180,17 @@ public interface AuditService
         boolean handleAuditEntryError(Long entryId, String errorMsg, Throwable error);
     }
     
+    /**
+     * Issue an audit query using the given parameters and consuming results in the callback.
+     * 
+     * @param callback          the callback that will handle results
+     * @param parameters        the parameters for the query (may not be <tt>null</tt>)
+     * @param maxResults        the maximum number of results to retrieve (zero or negative to ignore)
+     * 
+     * @since 3.3
+     */
+    void auditQuery(AuditQueryCallback callback, AuditQueryParameters parameters, int maxResults);
+    
     /**
      * Get the audit entries that match the given criteria.
      * 
@@ -193,6 +204,7 @@ public interface AuditService
      * @param maxResults        the maximum number of results to retrieve (zero or negative to ignore)
      * 
      * @since 3.2
+     * @deprecated              Use {@link #auditQuery(AuditQueryCallback, AuditQueryParameters)}
      */
     void auditQuery(
             AuditQueryCallback callback,
@@ -215,6 +227,7 @@ public interface AuditService
      * @param maxResults        the maximum number of results to retrieve (zero or negative to ignore)
      * 
      * @since 3.2
+     * @deprecated              Use {@link #auditQuery(AuditQueryCallback, AuditQueryParameters)}
      */
     void auditQuery(
             AuditQueryCallback callback,