An instance of this actor can have ports added to it. If it has input ports, then on each firing, before executing the referenced model, this actor will read an input token from the input port, if there is one, and use it to set the value of a top-level parameter in the contained model that has the same name as the port, if there is one. The simplest way to ensure that there is a matching parameter is to use a PortParameter for inputs. However, this actor will work also for ordinary ports. In this case, if this actor has a parameter with the same name as the port, and it is an instance of Variable (or its derived class Parameter), then the token read at the input is moved into it using its setToken() method. Otherwise, if it is an instance of Settable, then a string representation of the token is copied using the setExpression() method. Input ports should not be multiports, and if they are, then all but the first channel will be ignored.
If this actor has output ports and the contained model is executed, then upon completion of that execution, if this actor has parameters whose names match those of the output ports, then the final value of those parameters is sent to the output ports. If such a parameter is an instance of Variable (or its derived class Parameter), then its contained token is sent to the output token. Otherwise, if it is an instance of Settable, then a string token is produced on the output with its value equal to that returned by getExpression() of the Settable. Output ports should not be multiports. If they are, then all but the first channel will be ignored. A typical use of this actor will use the SetVariable actor inside to define the value of the output port.
In preinitialize(), type constraints are set up so that input and output ports with (name) matching parameters are constrained to have compatible types. Note that if the ports or parameters are changed during execution, then it will be necessary to set up matching type constraints by hand. Since this isn't possible to do from Vergil, the ports and parameters of this actor should not be changed using Vergil during execution.
This actor also overrides the requestChange() method and the executeChangeRequests() method to execute the given change. It does not delegate the change request to the container, but executes the request immediately or records it, depending on whether setDeferringChangeRequests() has been called with a true argument. @author Edward A. Lee @version $Id: ExecuteActor.java 69952 2014-09-01 20:35:48Z cxh $ @since Ptolemy II 10.0 @see ModelReference @see ptolemy.actor.lib.SetVariable @Pt.ProposedRating Yellow (eal) @Pt.AcceptedRating Red (eal) */ public class ExecuteActor extends RunCompositeActor { /** Construct a RunCompositeActor with a name and a container. * The container argument must not be null, or a * NullPointerException will be thrown. This actor will use the * workspace of the container for synchronization and version counts. * If the name argument is null, then the name is set to the empty string. * Increment the version of the workspace. This actor will have no * local director initially, and its executive director will be simply * the director of the container. * * @param container The container. * @param name The name of this actor. * @exception IllegalActionException If the container is incompatible * with this actor. * @exception NameDuplicationException If the name coincides with * an actor already in the container. */ public ExecuteActor(CompositeEntity container, String name) throws IllegalActionException, NameDuplicationException { super(container, name); actor = new TypedIOPort(this, "actor", true, false); actor.setTypeEquals(BaseType.ACTOR); StringAttribute cardinal = new StringAttribute(actor, "_cardinal"); cardinal.setExpression("SOUTH"); } /////////////////////////////////////////////////////////////////// //// parameters //// /** Input port on which to receive an actor. This has type actor. */ public TypedIOPort actor; /////////////////////////////////////////////////////////////////// //// public methods //// /** Make this actor opaque. */ @Override public boolean isOpaque() { return true; } /** Override the base class to not set type constraints between the * output ports and parameters of the actor. * This actor cannot manage type inference across independent models, * so the types have to be set by hand. * @exception IllegalActionException If there is no director, or if * the director's preinitialize() method throws it, or if this actor * is not opaque. */ @Override public void preinitialize() throws IllegalActionException { // Do not call super.preinitialize(). _stopRequested = false; Effigy parentEffigy = Effigy.findToplevelEffigy(this); if (parentEffigy != null) { try { parentEffigy.workspace().getWriteAccess(); _wrapperEffigy = new PtolemyEffigy(parentEffigy, parentEffigy.uniqueName("_wrapperEffigy")); } catch (NameDuplicationException e) { throw new IllegalActionException(this, e, "Unable to create an " + "effigy for the model."); } finally { parentEffigy.workspace().doneWriting(); } } if (_debugging) { _debug("Called preinitialize()"); } } /////////////////////////////////////////////////////////////////// //// protected methods //// /** Run a complete execution of the model provided on the actor port. * @exception IllegalActionException If the execution throws it. * @return One of COMPLETED or STOP_ITERATING. */ @Override protected int _executeInsideModel() throws IllegalActionException { if (actor.hasToken(0)) { Entity entity = ((ActorToken) actor.get(0)).getEntity(); if (!(entity instanceof TypedCompositeActor)) { throw new IllegalActionException(this, "actor input has to specify a TypedCompositeActor."); } _model = (TypedCompositeActor) entity; // In case we are running headless. if (_wrapperEffigy != null) { _wrapperEffigy.setModel(_model); } Manager manager = new Manager("_manager"); _model.setManager(manager); _readInputs(); try { manager.execute(); } catch (KernelException e) { throw new IllegalActionException(this, e, "Execution failed."); } _writeOutputs(); if (_debugging) { _debug("---- Firing is complete."); } } return COMPLETED; } /** Return the actor whose life cycle is being managed by this actor, * which is the most recently received actor on the actor input port. * @return This. */ @Override protected TypedCompositeActor _getManagedActor() { return _model; } /////////////////////////////////////////////////////////////////// //// private variables //// /** The most recently received actor on the actor input port. */ private TypedCompositeActor _model; /** The effigy to execute models at run time. */ private PtolemyEffigy _wrapperEffigy; }