gov.nasa.arc.brahms.vm.rt
Class VMMethodInvocationCtx

java.lang.Object
  gov.nasa.arc.brahms.common.rt.BrahmsObjectCtx
      gov.nasa.arc.brahms.common.rt.MethodInvocationCtx
          gov.nasa.arc.brahms.vm.rt.VMMethodInvocationCtx

All Implemented Interfaces:

IBrahmsObjectCtx, IMethodInvocationCtx, IRuntimeConstants, gov.nasa.arc.brahms.vm.events.IDiscreteEventData, gov.nasa.arc.brahms.vm.events.IDiscreteEventHandler, java.io.Serializable

public class VMMethodInvocationCtx
extends MethodInvocationCtx
implements gov.nasa.arc.brahms.vm.events.IDiscreteEventData, gov.nasa.arc.brahms.vm.events.IDiscreteEventHandler

The VMMethodInvocationCtx is a MethodInvocationCtx with specializations for use in the virtual machine. A MethodInvocationCtx is the context for an executed method invocation operation. It defines the method invocation operation that was executed, what frame executed the operation and defines what element(s) was/were marked for deletion.

Version:

$Revision: 1.1 $ $Date: 2009/11/23 20:46:18 $ $Author: rnado $

Author:

Bob Nado

See Also:

MethodInvocationCtx, Serialized Form

Field Summary

Fields inherited from interface gov.nasa.arc.brahms.common.rt.IRuntimeConstants

ABORTED, ACTIVE, ACTIVITY, AVAILABLE, COMPLETED, CONSEQUENCE, DETECTABLE, ENDED, ENGINE, EXTERNAL_AGENT, FROM, IMPASSED, INITIAL, INTERRUPTED, JAVA_PROPERTY, sABORTED, sACTIVE, sAVAILABLE, sCOMPLETED, sENDED, sIMPASSED, sINTERRUPTED, sUNAVAILABLE, TO, TRANSFER, UNAVAILABLE

Constructor Summary

VMMethodInvocationCtx(MethodInvocation invocation)
Constructor, creates a new method invocation context for the specified method invocation operation.

Method Summary

boolean	handleDiscreteEvent(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt) Process the specified discrete event.
boolean	handleDiscreteEvent(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt, gov.nasa.arc.brahms.vm.events.IDiscreteEventHandlerFactory ehf) Handles the specified discrete event by selecting the appropriate event handler from the specified event handler factory.
protected void	onExecute(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt) Executes the method invocation operation

Methods inherited from class gov.nasa.arc.brahms.common.rt.MethodInvocationCtx

getParent, setParent, toString

Methods inherited from class gov.nasa.arc.brahms.common.rt.BrahmsObjectCtx

addNote, getContextFor, getEndTime, getID, getNote, getNotes, getStartTime, removeNote, setContextFor, setEndTime, setID, setStartTime

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface gov.nasa.arc.brahms.common.rt.IBrahmsObjectCtx

addNote, getContextFor, getEndTime, getID, getNote, getNotes, getStartTime, removeNote, setEndTime, setID, setStartTime

Constructor Detail

VMMethodInvocationCtx

public VMMethodInvocationCtx(MethodInvocation invocation)

Constructor, creates a new method invocation context for the specified method invocation operation.

Parameters:

invocation - the method invocation operation for which this context is the context

Method Detail

handleDiscreteEvent

public boolean handleDiscreteEvent(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt,
                                   gov.nasa.arc.brahms.vm.events.IDiscreteEventHandlerFactory ehf)

Handles the specified discrete event by selecting the appropriate event handler from the specified event handler factory. The specified event contains as its data the object implementing this interface. The following should be the case: evt.getData() == this

Specified by:

handleDiscreteEvent in interface gov.nasa.arc.brahms.vm.events.IDiscreteEventData

Parameters:

evt - the DiscreteEvent to be handled

ehf - the EventHandlerFactory containing handlers from which this DiscreteEventData selects the appropriate handler

Returns:

boolean true if the event could be processed, false if not

handleDiscreteEvent

public boolean handleDiscreteEvent(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt)

Process the specified discrete event.

Specified by:

handleDiscreteEvent in interface gov.nasa.arc.brahms.vm.events.IDiscreteEventHandler

Parameters:

evt - the DiscreteEvent to be processed.

Returns:

boolean true if the event could be processed, false if not

onExecute

protected void onExecute(gov.nasa.arc.brahms.vm.events.DiscreteEvent evt)

Executes the method invocation operation

Parameters:

evt - the DiscreteEvent that initiated the method invocation operation