Implimenting moderated reject email. And adding @Auditable to invitation service.

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

source/java/org/alfresco/repo/invitation/ModeratedActionReject.java

@@ -1,24 +1,39 @@
 package org.alfresco.repo.invitation;
 
 
+import java.util.HashMap;
+import java.util.Map;
+
+import org.alfresco.repo.action.executer.MailActionExecuter;
+import org.alfresco.repo.invitation.site.RejectInviteAction;
 import org.alfresco.repo.security.authentication.MutableAuthenticationDao;
 import org.alfresco.repo.workflow.jbpm.JBPMSpringActionHandler;
 import org.alfresco.service.ServiceRegistry;
+import org.alfresco.service.cmr.action.Action;
+import org.alfresco.service.cmr.action.ActionService;
+import org.alfresco.service.cmr.repository.TemplateService;
 import org.alfresco.service.cmr.security.PersonService;
 import org.alfresco.service.cmr.workflow.WorkflowService;
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
 import org.jbpm.graph.exe.ExecutionContext;
 import org.springframework.beans.factory.BeanFactory;
 
 /**
- *
+ * JBPM Action fired when a moderated invitation is rejected.
  */
 public class ModeratedActionReject extends JBPMSpringActionHandler
 {
     private static final long serialVersionUID = 4377660284993206875L;
+    private static final Log logger = LogFactory.getLog(ModeratedActionReject.class);
     
     private MutableAuthenticationDao mutableAuthenticationDao;
     private PersonService personService;
     private WorkflowService workflowService;
+    private ActionService actionService;
+    private TemplateService templateService;
+    //private String rejectTemplate = " PATH:\"app:company_home/app:dictionary/app:email_templates/cm:invite/cm:moderated-reject-email.ftl\"";
+    private String rejectTemplate = "/alfresco/bootstrap/invite/moderated-reject-email.ftl";
 
     /* (non-Javadoc)
      * @see org.alfresco.repo.workflow.jbpm.JBPMSpringActionHandler#initialiseHandler(org.springframework.beans.factory.BeanFactory)
@@ -30,6 +45,8 @@ public class ModeratedActionReject extends JBPMSpringActionHandler
         mutableAuthenticationDao = (MutableAuthenticationDao) factory.getBean("authenticationDao");
         personService = (PersonService) services.getPersonService();
         workflowService = (WorkflowService) services.getWorkflowService();
+        templateService = (TemplateService) services.getTemplateService();
+        actionService = (ActionService) services.getActionService();
     }
 
     /* (non-Javadoc)
@@ -45,7 +62,32 @@ public class ModeratedActionReject extends JBPMSpringActionHandler
         final String inviteeRole = (String)executionContext.getVariable(WorkflowModelModeratedInvitation.wfVarInviteeRole);
         final String reviewer = (String)executionContext.getVariable(WorkflowModelModeratedInvitation.wfVarReviewer);
         final String reviewComments = (String)executionContext.getVariable(WorkflowModelModeratedInvitation.wfVarReviewComments);
-
-
+        
+        // send email to the invitee if possible - but don't fail the rejection if email cannot be sent
+        try 
+        {
+        	Map<String, Object> model = new HashMap<String, Object>(8, 1.0f);
+        	model.put("resourceName", resourceName);
+        	model.put("resourceType", resourceType);
+        	model.put("inviteeRole", inviteeRole);
+        	model.put("reviewComments", reviewComments);
+        	model.put("reviewer", reviewer);
+        	model.put("inviteeUserName", inviteeUserName);
+     
+        	String emailMsg = templateService.processTemplate("freemarker", rejectTemplate,  model);
+        	        
+        	Action emailAction = actionService.createAction("mail");
+        	emailAction.setParameterValue(MailActionExecuter.PARAM_TO, inviteeUserName);
+        	emailAction.setParameterValue(MailActionExecuter.PARAM_FROM, reviewer);
+        	emailAction.setParameterValue(MailActionExecuter.PARAM_SUBJECT, "Rejected invitation to web site:" + resourceName);
+        	emailAction.setParameterValue(MailActionExecuter.PARAM_TEXT, emailMsg);
+        	emailAction.setExecuteAsynchronously(true);
+        	actionService.executeAction(emailAction, null);
+        }
+        catch(Exception e)
+        {
+        	// Swallow exception
+        	logger.error("unable to send reject email", e);
+        }
     }
 }

source/java/org/alfresco/service/cmr/invitation/InvitationService.java

@@ -26,6 +26,8 @@ package org.alfresco.service.cmr.invitation;
 
 import java.util.List;
 
+import org.alfresco.service.Auditable;
+
 /**
  * The invitation service provides the ability to invite
  * people to resources.    For example adding a user to a shared web site.
@@ -64,6 +66,14 @@ public interface InvitationService
 	 * @throws InvitationExceptionUserError
 	 * @throws InvitationExceptionForbidden
 	 */
+    @Auditable(parameters = {"inviteeUserName", 
+			"resourceType",
+			"resourceName", 
+			"inviteeRole", 
+			"serverPath",
+			"acceptUrl", 
+			"rejectUrl"})
+			
 	public NominatedInvitation inviteNominated(
 			String inviteeUserName, 
 			Invitation.ResourceType resourceType,
@@ -94,6 +104,16 @@ public interface InvitationService
 	 * @throws InvitationExceptionUserError
 	 * @throws InvitationExceptionForbidden
 	 */
+    @Auditable(parameters = {
+    		"inviteeFirstName", 
+			"inviteeLastName",
+            "inviteeEmail", 
+            "resourceType",
+            "resourceName", 
+            "inviteeRole", 
+            "serverPath", 
+            "acceptUrl", 
+            "rejectUrl"})
 	public NominatedInvitation inviteNominated(
 			String inviteeFirstName, 
 			String inviteeLastName,
@@ -112,6 +132,12 @@ public interface InvitationService
      * @param resourceName which resource
      * @param inviteeRole which role ?
 	 */
+    @Auditable(parameters = {
+    		"inviteeComments",
+			"inviteeUserName",
+			"resourceType",
+			"resourceName", 
+			"inviteeRole"})
 	public ModeratedInvitation inviteModerated(
 			String inviteeComments,
 			String inviteeUserName,
@@ -126,6 +152,7 @@ public interface InvitationService
 	 * @param ticket
 	 * @return the invitation
 	 */
+    @Auditable(parameters = {"invitationId", "reason"})    
 	public Invitation accept(String invitationId, String ticket);
 	
 
@@ -135,22 +162,22 @@ public interface InvitationService
 	 * @param invitationId the request to approve
 	 * @param reason - comments about the acceptance
 	 */
+    @Auditable(parameters = {"invitationId", "reason"})
 	public Invitation approve(String invitationId, String reason);
-	
-	
 
-	
 	/**
 	 * User or moderator rejects this request
 	 * @param invitationId
 	 * @param reason
-	 */
+	 */        
+    @Auditable(parameters = {"invitationId", "reason"})
 	public Invitation reject(String invitationId, String reason);
-	
+
 	
 	/**
 	 * cancel this request
 	 */
+    @Auditable(parameters = {"invitationId"})
 	public Invitation cancel (String invitationId);
 	
 	/**