Merged V2.0 to HEAD

5880, 5881: Script actio parameter


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

source/java/org/alfresco/repo/action/executer/ActionExecuter.java

@@ -29,10 +29,15 @@ import org.alfresco.service.cmr.action.ActionDefinition;
 import org.alfresco.service.cmr.repository.NodeRef;
 
 /**
+ * Action executer interface
+ * 
  * @author Roy Wetherall
  */
 public interface ActionExecuter
 {
+	/** Standard action result parameter name */
+	public static String PARAM_RESULT = "result";
+	
 	/**
 	 * Get the action definition for the action
 	 * 

source/java/org/alfresco/repo/action/executer/CountChildrenActionExecuter.java

@@ -0,0 +1,83 @@
+/*
+ * Copyright (C) 2005-2007 Alfresco Software Limited.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ * As a special exception to the terms and conditions of version 2.0 of 
+ * the GPL, you may redistribute this Program in connection with Free/Libre 
+ * and Open Source Software ("FLOSS") applications as described in Alfresco's 
+ * FLOSS exception.  You should have recieved a copy of the text describing 
+ * the FLOSS exception, and it is also available here: 
+ * http://www.alfresco.com/legal/licensing
+ */
+package org.alfresco.repo.action.executer;
+
+import java.util.List;
+
+import org.alfresco.service.cmr.action.Action;
+import org.alfresco.service.cmr.action.ParameterDefinition;
+import org.alfresco.service.cmr.repository.NodeRef;
+import org.alfresco.service.cmr.repository.NodeService;
+
+/**
+ * Action executer that counts the number of children the actioned upon node has.
+ * This provides as example of how actions can return results.
+ * 
+ * @author Roy Wetherall
+ */
+public class CountChildrenActionExecuter extends ActionExecuterAbstractBase
+{
+    /**
+     * Action constants
+     */
+	public static final String NAME = "count-children";
+	
+	/**
+	 * The node service
+	 */
+	private NodeService nodeService;
+	
+    /**
+     * Set the node service
+     * 
+     * @param nodeService  the node service
+     */
+	public void setNodeService(NodeService nodeService) 
+	{
+		this.nodeService = nodeService;
+	}
+    
+    /**
+     * @see org.alfresco.repo.action.executer.ActionExecuter#execute(org.alfresco.service.cmr.repository.NodeRef, NodeRef)
+     */
+    public void executeImpl(Action ruleAction, NodeRef actionedUponNodeRef)
+    {
+		if (this.nodeService.exists(actionedUponNodeRef) == true)
+		{
+			// Get the parent node		
+			int count = this.nodeService.getChildAssocs(actionedUponNodeRef).size();
+			ruleAction.setParameterValue(PARAM_RESULT, Integer.valueOf(count));
+		}
+    }
+
+    /**
+     * @see org.alfresco.repo.action.ParameterizedItemAbstractBase#addParameterDefinitions(java.util.List)
+     */
+	@Override
+	protected void addParameterDefinitions(List<ParameterDefinition> paramList) 
+	{		
+	}
+
+}

source/java/org/alfresco/repo/action/executer/ScriptActionExecuter.java

@@ -24,6 +24,7 @@
  */
 package org.alfresco.repo.action.executer;
 
+import java.io.Serializable;
 import java.util.List;
 import java.util.Map;
 
@@ -149,10 +150,11 @@ public class ScriptActionExecuter extends ActionExecuterAbstractBase
                 ScriptAction scriptAction = new ScriptAction(this.serviceRegistry, action, this.actionDefinition);
                 model.put("action", scriptAction);
                 
+                Object result = null;
                 if (this.scriptLocation == null)
                 {
                     // execute the script against the default model
-                    this.serviceRegistry.getScriptService().executeScript(
+                    result = this.serviceRegistry.getScriptService().executeScript(
                         scriptRef,
                         ContentModel.PROP_CONTENT,
                         model);
@@ -160,7 +162,13 @@ public class ScriptActionExecuter extends ActionExecuterAbstractBase
                 else
                 {
                     // execute the script at the specified script location
-                    this.serviceRegistry.getScriptService().executeScript(this.scriptLocation, model);
+                    result = this.serviceRegistry.getScriptService().executeScript(this.scriptLocation, model);
+                }
+                
+                // Set the result
+                if (result != null)
+                {
+                	action.setParameterValue(PARAM_RESULT, (Serializable)result);
                 }
             }
         }