/* * Copyright (c) 2005, John Mettraux, OpenWFE.org * All rights reserved. *  * Redistribution and use in source and binary forms, with or without  * modification, are permitted provided that the following conditions are met: *  * . Redistributions of source code must retain the above copyright notice, this *   list of conditions and the following disclaimer.   *  * . Redistributions in binary form must reproduce the above copyright notice,  *   this list of conditions and the following disclaimer in the documentation  *   and/or other materials provided with the distribution. *  * . Neither the name of the "OpenWFE" nor the names of its contributors may be *   used to endorse or promote products derived from this software without *   specific prior written permission. *  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE  * POSSIBILITY OF SUCH DAMAGE. * * $Id: LaunchAction.java,v 1.19 2005/07/14 15:04:14 jmettraux Exp $ *///// LaunchAction.java//// jmettraux@openwfe.org//// generated with // jtmpl 1.0.04 31.10.2002 John Mettraux (jmettraux@openwfe.org)//package openwfe.org.wlactions;import javax.security.auth.Subject;import openwfe.org.ApplicationContext;import openwfe.org.engine.workitem.LaunchItem;import openwfe.org.engine.dispatch.DispatchingException;import openwfe.org.engine.participants.Participant;import openwfe.org.engine.participants.ParticipantMap;import openwfe.org.worklist.auth.LaunchPermission;/** * The action of launching a flow * * <p><font size=2>CVS Info : * <br>$Author: jmettraux $ * <br>$Date: 2005/07/14 15:04:14 $ * <br>$Id: LaunchAction.java,v 1.19 2005/07/14 15:04:14 jmettraux Exp $ </font> * * @author jmettraux@openwfe.org */public class LaunchAction    implements java.security.PrivilegedExceptionAction{    //    // FIELDS    protected ApplicationContext worklistContext = null;    protected Subject subject = null;    protected String engineId = null;    protected LaunchItem item = null;    //    // CONSTRUCTORS    public LaunchAction         (final ApplicationContext worklistContext,          final Subject subject,          final String engineId,         final LaunchItem item)    {        this.worklistContext = worklistContext;        this.subject = subject;        this.engineId = engineId;        this.item = item;    }    //    // METHODS    public Object run ()         throws DispatchingException    {        if (this.item.getWorkflowDefinitionUrl() == null)        {            throw new DispatchingException                ("LaunchItem with workflowDefinitionUrl field not set. "+                 "Cannot launch.");        }        //        // security control is performed here...        java.security.AccessController.checkPermission            (LaunchPermission.newLaunchPermission                (determinePermissionName()));        //        // find participant and dispatch                final ParticipantMap pMap = openwfe.org.engine.Definitions            .getParticipantMap(this.worklistContext);        final Participant p = pMap.get(this.engineId);        if (p == null)        {            throw new DispatchingException                 ("Cannot launch flow on unknown engine '"+this.engineId+"'");        }        return p.dispatch(this.item);    }    protected String determinePermissionName ()    {        StringBuffer sb = new StringBuffer();        sb.append(this.engineId);        sb.append("::");        sb.append(this.item.getWorkflowDefinitionUrl());        return sb.toString();    }}