/* * 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; import java.util.Set; import java.util.concurrent.ThreadPoolExecutor; import org.alfresco.error.StackTraceUtil; import org.alfresco.repo.rule.RuleServiceImpl; import org.alfresco.repo.security.authentication.AuthenticationComponent; import org.alfresco.repo.transaction.AlfrescoTransactionSupport; import org.alfresco.repo.transaction.RetryingTransactionHelper.RetryingTransactionCallback; import org.alfresco.service.cmr.action.Action; import org.alfresco.service.cmr.action.ActionServiceException; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.transaction.TransactionService; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * The asynchronous action execution queue implementation * * @author Roy Wetherall */ public class AsynchronousActionExecutionQueueImpl implements AsynchronousActionExecutionQueue { private static Log logger = LogFactory.getLog(AsynchronousActionExecutionQueueImpl.class); private ThreadPoolExecutor threadPoolExecutor; private TransactionService transactionService; private AuthenticationComponent authenticationComponent; /** * Default constructor */ public AsynchronousActionExecutionQueueImpl() { } /** * Set the thread pool, which may be shared with other components, that will be used * to run the actions. * * @param threadPoolExecutor the thread pool */ public void setThreadPoolExecutor(ThreadPoolExecutor threadPoolExecutor) { this.threadPoolExecutor = threadPoolExecutor; } /** * Set the transaction service * * @param transactionService the transaction service */ public void setTransactionService(TransactionService transactionService) { this.transactionService = transactionService; } /** * Set the authentication component * * @param authenticationComponent the authentication component */ public void setAuthenticationComponent(AuthenticationComponent authenticationComponent) { this.authenticationComponent = authenticationComponent; } /** * {@inheritDoc} */ public void executeAction(RuntimeActionService actionService, Action action, NodeRef actionedUponNodeRef, boolean checkConditions, Set actionChain) { executeAction(actionService, action, actionedUponNodeRef, checkConditions, actionChain, null); } /** * {@inheritDoc} */ @SuppressWarnings("unchecked") public void executeAction(RuntimeActionService actionService, Action action, NodeRef actionedUponNodeRef, boolean checkConditions, Set actionChain, NodeRef actionExecutionHistoryNodeRef) { Set executedRules = (Set) AlfrescoTransactionSupport.getResource("RuleServiceImpl.ExecutedRules"); Runnable runnable = new ActionExecutionWrapper( actionService, action, actionedUponNodeRef, checkConditions, actionExecutionHistoryNodeRef, actionChain, executedRules); threadPoolExecutor.execute(runnable); // Done if (logger.isDebugEnabled()) { // get the stack trace Exception e = new Exception(); e.fillInStackTrace(); StackTraceElement[] trace = e.getStackTrace(); StringBuilder sb = new StringBuilder(); sb.append("\n") .append("Placed action on execution queue: \n") .append(" Action: " + action); String msg = sb.toString(); sb = new StringBuilder(); StackTraceUtil.buildStackTrace(msg, trace, sb, -1); logger.debug(sb); } } /** * Runnable class to wrap the execution of the action. */ private class ActionExecutionWrapper implements Runnable { private RuntimeActionService actionService; private Action action; private NodeRef actionedUponNodeRef; private boolean checkConditions; private NodeRef actionExecutionHistoryNodeRef; private Set actionChain; private Set executedRules; /** * @param actionService the action service * @param action the action to perform * @param actionedUponNodeRef the node to perform the action on * @param checkConditions the check conditions * @param actionExecutionHistoryNodeRef the action execution history node reference * @param actionChain the action chain * @param executedRules list of executions done to helps to prevent loop scenarios with async rules */ public ActionExecutionWrapper( RuntimeActionService actionService, Action action, NodeRef actionedUponNodeRef, boolean checkConditions, NodeRef actionExecutionHistoryNodeRef, Set actionChain, Set executedRules) { this.actionService = actionService; this.actionedUponNodeRef = actionedUponNodeRef; this.action = action; this.checkConditions = checkConditions; this.actionExecutionHistoryNodeRef = actionExecutionHistoryNodeRef; this.actionChain = actionChain; this.executedRules = executedRules; } /** * Get the action * * @return the action */ public Action getAction() { return this.action; } /** * Get the actioned upon node reference * * @return the actioned upon node reference */ public NodeRef getActionedUponNodeRef() { return this.actionedUponNodeRef; } /** * Get the check conditions value * * @return the check conditions value */ public boolean getCheckCondtions() { return this.checkConditions; } /** * Get the action execution history node reference * * @return the action execution history node reference */ public NodeRef getActionExecutionHistoryNodeRef() { return this.actionExecutionHistoryNodeRef; } /** * Get the action chain * * @return the action chain */ public Set getActionChain() { return actionChain; } /** * Executes the action via the action runtime service * * @see java.lang.Runnable#run() */ public void run() { try { // Get the run as user name final String userName = ((ActionImpl)ActionExecutionWrapper.this.action).getRunAsUser(); if (userName == null) { throw new ActionServiceException("Cannot execute action asynchronously since run as user is 'null'"); } authenticationComponent.setCurrentUser(userName); try { RetryingTransactionCallback actionCallback = new RetryingTransactionCallback() { public Object execute() { if (ActionExecutionWrapper.this.executedRules != null) { AlfrescoTransactionSupport.bindResource("RuleServiceImpl.ExecutedRules", ActionExecutionWrapper.this.executedRules); } ActionExecutionWrapper.this.actionService.executeActionImpl( ActionExecutionWrapper.this.action, ActionExecutionWrapper.this.actionedUponNodeRef, ActionExecutionWrapper.this.checkConditions, true, ActionExecutionWrapper.this.actionChain); return null; } }; transactionService.getRetryingTransactionHelper().doInTransaction(actionCallback); } finally { authenticationComponent.clearCurrentSecurityContext(); } } catch (Throwable exception) { logger.error("Failed to execute asynchronous action: " + action, exception); } } } }