ptolemy.domains.fsm.kernel
Interface RefinementActor

All Superinterfaces:

Actor, Executable, Initializable, Nameable

All Known Implementing Classes:

ModalController, Refinement, TDLRefinement, TransitionRefinement

public interface RefinementActor
extends Actor

An interface for actors that act as refinements of states in FSMs or events in Ptera models.

Since:

Ptolemy II 8.0

Version:

$Id: RefinementActor.java 57044 2010-01-27 22:41:05Z cxh $

Author:

Thomas Huining Feng

Accepted Rating:

Red (tfeng)

Proposed Rating:

Red (tfeng)

Field Summary

Fields inherited from interface ptolemy.actor.Executable

COMPLETED, NOT_READY, STOP_ITERATING

Method Summary

void	addRefinement(State state, java.lang.String name, Entity template, java.lang.String className, Configuration configuration) Create a refinement for the given state.
State	getRefinedState() Return the state (or event, which subclasses state) that this actor refines.

Methods inherited from interface ptolemy.actor.Actor

createReceivers, getCausalityInterface, getDirector, getExecutiveDirector, getManager, inputPortList, newReceiver, outputPortList

Methods inherited from interface ptolemy.actor.Executable

fire, isFireFunctional, isStrict, iterate, postfire, prefire, stop, stopFire, terminate

Methods inherited from interface ptolemy.actor.Initializable

addInitializable, initialize, preinitialize, removeInitializable, wrapup

Methods inherited from interface ptolemy.kernel.util.Nameable

description, getContainer, getDisplayName, getFullName, getName, getName, setName

Method Detail

getRefinedState

State getRefinedState()
                      throws IllegalActionException

Return the state (or event, which subclasses state) that this actor refines.

Returns:

The state or event that this actor refines.

Throws:

IllegalActionException - If thrown while trying to find the refined state or event.

addRefinement

void addRefinement(State state,
                   java.lang.String name,
                   Entity template,
                   java.lang.String className,
                   Configuration configuration)
                   throws IllegalActionException

Create a refinement for the given state.

Parameters:

state - The state that will contain the new refinement.

name - The name of the composite entity that stores the refinement.

template - The template used to create the refinement, or null if template is not used.

className - The class name for the refinement, which is used when template is null.

configuration - The configuration that is used to open the refinement (as a look-inside action) after it is created, or null if it is not needed to open the refinement.

Throws:

IllegalActionException - If error occurs while creating the refinement.