gov.nasa.arc.brahms.common.rt
Class PrimitiveActivityCtx

java.lang.Object
  gov.nasa.arc.brahms.common.rt.BrahmsObjectCtx
      gov.nasa.arc.brahms.common.rt.ActivityCtx
          gov.nasa.arc.brahms.common.rt.PrimitiveActivityCtx

All Implemented Interfaces:

IActivityCtx, IBrahmsObjectCtx, IPrimitiveActivityCtx, IRuntimeConstants, java.io.Serializable

Direct Known Subclasses:

BroadcastActivityCtx, ContainmentActivityCtx, CreateAgentActivityCtx, CreateAreaActivityCtx, CreateObjectActivityCtx, GestureActivityCtx, JavaActivityCtx, MoveActivityCtx

public class PrimitiveActivityCtx
extends ActivityCtx
implements IPrimitiveActivityCtx

The PrimitiveActivityCtx maintains the context of a primitive activity being or to be executed by an active instance. The context maintains the start and end times for an activity, the duration, priority, status, randomness, duration and resources.

Version:

28 July 2000

Author:

Ron van Hoof

See Also:

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

PrimitiveActivityCtx(PrimitiveActivity act)
Constructor, creates a new context for the specified PrimitiveActivity.

Method Summary

void	addResource(ParameterCtx resource) Adds the specified resource as a resource for this activity.
long	getDuration() Returns the calculated duration of the activity used by the VM
long	getElapsedTime() Returns the elapsed time when the activity has been active
ParameterCtx	getMaxDuration() Returns the maximum duration of the activity.
ParameterCtx	getMinDuration() returns the minimum duration of the activity.
ParameterCtx	getRandom() Returns whether the duration of the activity is random or not.
int	getResourceCount() Return the number of resources associated with the activity.
java.util.Enumeration	getResources() Returns a list of all the resources (ParameterCtx).
void	removeResource(ParameterCtx resource) Removes the specified resource as a resource for this activity.
void	setDuration(long duration) Specifies the calculated duration of the activity used by the VM
void	setElapsedTime(long elapsedTime) Specifies the elapsed time when the activity has been active
void	setMaxDuration(ParameterCtx maxDuration) Sets the maximum duration of the activity.
void	setMinDuration(ParameterCtx minDuration) Sets the minimum duration of the activity.
void	setRandom(ParameterCtx random) Sets whether the duration of the activity is random or not.

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

getCompletionCause, getDisplayText, getParentFrame, getPerformedBy, getPriority, getReferencedBy, getState, getStatus, setCompletionCause, setDisplayText, setParentFrame, setPerformedBy, setPriority, setReferencedBy, setState, setState, setStatus, 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.IActivityCtx

getCompletionCause, getDisplayText, getParentFrame, getPerformedBy, getPriority, getReferencedBy, getStatus, setCompletionCause, setDisplayText, setParentFrame, setPerformedBy, setReferencedBy, setStatus

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

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

Constructor Detail

PrimitiveActivityCtx

public PrimitiveActivityCtx(PrimitiveActivity act)

Constructor, creates a new context for the specified PrimitiveActivity.

Parameters:

act - the PrimitiveActivity for which to create a context

Method Detail

setRandom

public void setRandom(ParameterCtx random)
               throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Sets whether the duration of the activity is random or not. The random indicator is set through a parameter context containing either the actual value or a reference to a variable containing the random value.

Parameters:

random - the ParameterCtx containing a boolean value defining whether the activity duration is random

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null random indicator is specified

getRandom

public ParameterCtx getRandom()
                       throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns whether the duration of the activity is random or not. The random indicator is set through a parameter context containing either the actual value or a reference to a variable containing the random value.

Specified by:

getRandom in interface IPrimitiveActivityCtx

Returns:

ParameterCtx containing a boolean value defining whether the activity duration is random

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no random indicator is specified

setMinDuration

public void setMinDuration(ParameterCtx minDuration)
                    throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Sets the minimum duration of the activity. The minimum duration is set through a parameter context containing either the actual value or a reference to a variable containing the value.

Parameters:

minDuration - the ParameterCtx containing an integer value defining the minimum duration of the activity

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null minimum duration is specified

getMinDuration

public ParameterCtx getMinDuration()
                            throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

returns the minimum duration of the activity. The minimum duration is set through a parameter context containing either the actual value or a reference to a variable containing the value.

Specified by:

getMinDuration in interface IPrimitiveActivityCtx

Returns:

ParameterCtx containing an integer value defining the minimum duration of the activity

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no minimum duration is specified

setMaxDuration

public void setMaxDuration(ParameterCtx maxDuration)
                    throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Sets the maximum duration of the activity. The maximum duration is set through a parameter context containing either the actual value or a reference to a variable containing the value.

Parameters:

maxDuration - the ParameterCtx containing an integer value defining the maximum duration of the activity

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null maximum duration is specified

getMaxDuration

public ParameterCtx getMaxDuration()
                            throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns the maximum duration of the activity. The maximum duration is set through a parameter context containing either the actual value or a reference to a variable containing the value.

Specified by:

getMaxDuration in interface IPrimitiveActivityCtx

Returns:

ParameterCtx containing an integer value defining the maximum duration of the activity

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no maximum duration is specified

setDuration

public void setDuration(long duration)

Specifies the calculated duration of the activity used by the VM

Parameters:

duration - the total duration of the activity

getDuration

public long getDuration()

Returns the calculated duration of the activity used by the VM

Specified by:

getDuration in interface IPrimitiveActivityCtx

Returns:

long the total duration of the activity

setElapsedTime

public void setElapsedTime(long elapsedTime)

Specifies the elapsed time when the activity has been active

Specified by:

setElapsedTime in interface IPrimitiveActivityCtx

Parameters:

elapsedTime - the activities elapsed time

getElapsedTime

public long getElapsedTime()

Returns the elapsed time when the activity has been active

Specified by:

getElapsedTime in interface IPrimitiveActivityCtx

Returns:

long the activities elapsed time

addResource

public void addResource(ParameterCtx resource)
                 throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the specified resource as a resource for this activity. The actual resource is the concept referenced by the parameter context where the parameter context specifies when the resource was associated with the activity.

Specified by:

addResource in interface IPrimitiveActivityCtx

Parameters:

resource - the resource (ParameterCtx) to be added

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if resource is null

removeResource

public void removeResource(ParameterCtx resource)
                    throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified resource as a resource for this activity. The actual resource is the concept referenced by the parameter context where the parameter context specifies when the resource was (dis)associated with the activity.

Specified by:

removeResource in interface IPrimitiveActivityCtx

Parameters:

resource - the resource (ParameterCtx) to be removed

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if resource is null, no resources are available, or the resource is not found

getResources

public java.util.Enumeration getResources()
                                   throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns a list of all the resources (ParameterCtx).

Specified by:

getResources in interface IPrimitiveActivityCtx

Returns:

Enumeration an enumeration of ParameterCtx

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if there are no resources

getResourceCount

public int getResourceCount()

Return the number of resources associated with the activity.

Specified by:

getResourceCount in interface IPrimitiveActivityCtx

Returns:

int the number of resources