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

java.lang.Object
  gov.nasa.arc.brahms.common.rt.BrahmsObjectCtx
      gov.nasa.arc.brahms.common.rt.ConceptCtx
          gov.nasa.arc.brahms.common.rt.ActiveInstanceCtx

All Implemented Interfaces:

IActiveInstanceCtx, IBrahmsObjectCtx, IConceptCtx, IRuntimeConstants, java.io.Serializable

Direct Known Subclasses:

AgentCtx, ObjectInstanceCtx, VMActiveInstanceCtx

public abstract class ActiveInstanceCtx
extends ConceptCtx
implements IActiveInstanceCtx

The ActiveInstanceCtx is the runtime class for active instances (agents and object instances). It manages the belief set, location, frame contexts with their various states and containment. The virtual machine maintains the active instances states through the active instance contexts.

Version:

$Revision: 1.4 $ $Date: 2009/06/16 21:36:17 $ $Author: rvhoof $

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

ActiveInstanceCtx(ActiveInstance ai)
Constructor, creates a new context for the specified active instance.

Method Summary

void	addAvailableFrame(IFrameCtx frame) Adds the specified frame context as an available frame.
void	addBelief(IBeliefCtx belief) Add a new belief to the belief set of the active instance.
void	addCompletedFrame(IFrameCtx frame) Adds the given frame context as a completed frame.
void	addContainedElement(ContainedInstanceCtx ci) Adds the given contained element to the list of elements carried or contained by this active instance.
void	addImpasseDetectable(IDetectableCtx detectable) Adds the specified detectable causing an impasse to the list of impasse causing detectables.
void	addImpassedFrame(IWorkframeCtx frame) Adds the specified frame context as an impassed frame.
void	addInterruptedFrame(IWorkframeCtx frame) Adds the specified frame context as an interrupted frame.
void	addPastLocation(IAreaCtx location) Adds the given location to the list of past location visited by the active instance.
java.util.ListIterator	getAvailableThoughtframes() Returns a list of all the available thoughtframes.
java.util.ListIterator	getAvailableWorkframes() Returns a list of all the available workframes.
java.util.Enumeration	getBeliefs() Returns the active instance's belief set.
long	getBelievedTime() Returns the active instance's believed date and time (can but is not necessarily the same as the actual current time as managed by the Scheduler)
java.util.Set<java.lang.String>	getCompletedThoughtframeNames() Return a list of the fully qualified names for all the thoughtframes for which completed thoughtframe contexts exist.
java.util.ListIterator	getCompletedThoughtframes(java.lang.String frameName) Return a list of all the completed thoughtframe contexts for the thoughtframe with the specified fully qualified name.
java.util.Set<java.lang.String>	getCompletedWorkframeNames() Return a list of the fully qualified names for all the workframes for which completed workframe contexts exist.
java.util.ListIterator	getCompletedWorkframes(java.lang.String frameName) Return a list of all the completed workframe contexts for the workframe with the specified fully qualified name.
java.util.Enumeration	getContainedElements() Returns the active instance's carried or contained elements.
IWorkframeCtx	getCurrentWork() Returns the workframe currently active for the active instance.
java.util.ListIterator	getImpasseDetectables() Returns the list of detectables causing an impasse.
java.util.ListIterator	getImpassedFrames() Returns a list of all the impassed workframes.
java.util.ListIterator	getInterruptedFrames() Returns a list of all the interrupted workframes.
IAreaCtx	getLocation() Returns the current location of the active instance.
java.util.Enumeration	getPastLocations() Returns the active instance's past locations.
protected IThoughtframeCtx	getPriorityAvailableThoughtframe() Returns the highest priority available thoughtframe.
protected IWorkframeCtx	getPriorityAvailableWorkframe() Returns the highest priority available workframe.
protected IWorkframeCtx	getPriorityInterruptedFrame() Returns the highest priority interrupted workframe.
boolean	hasAvailableThoughtframes() Inficates whether there are any available thoughtframes.
boolean	hasAvailableWorkframes() Inficates whether there are any available workframes.
boolean	hasCompletedThoughtframes() Inficates whether there are any completed thoughtframes.
boolean	hasCompletedWorkframes() Inficates whether there are any completed workframes.
boolean	hasImpassedFrames() Inficates whether there are any impassed workframes.
boolean	hasInterruptedFrames() Inficates whether there are any interrupted workframes.
void	removeAllAvailableFrames() Removes all the available frames, work and thoughtframes.
void	removeAllBeliefs() Clears the active instance's belief set.
void	removeAllCompletedFrames() Removes all the completed frames, work and thoughtframes.
void	removeAllContainedElements() Clears the active instance's list containing the contained elements.
void	removeAllImpasseDetectables() Removes all the detectables causing an impasse.
void	removeAllImpassedFrames() Removes all the impassed frames.
void	removeAllInterruptedFrames() Removes all the interrupted frames.
void	removeAllPastLocations() Clears the active instance's list containing past locations.
void	removeAvailableFrame(IFrameCtx frame) Removes the specifies frame as an available frame.
void	removeBelief(IBeliefCtx belief) Removes the specified belief from the belief set of the active instance.
void	removeCompletedFrame(IFrameCtx frame) Removes the given frame context as a completed frame context
void	removeContainedElement(ContainedInstanceCtx ci) Removes the specified contained element from the list of elements carried or contained by this active instance.
void	removeImpasseDetectable(IDetectableCtx detectable) Removes the specified detectable causing an impasse from the list of impasse causing detectables.
void	removeImpassedFrame(IWorkframeCtx frame) Removes the specified frame context as an impassed frame.
void	removeInterruptedFrame(IWorkframeCtx frame) Removes the specified frame context as an interrupted frame.
void	removePastLocation(IAreaCtx location) Removes the specified location from the list of the active instance's past locations.
void	setBelievedTime(long time) Sets the active instance's believed date and time (can but is not necessarily the same as the actual current time as managed by the Scheduler)
void	setCurrentWork(IWorkframeCtx frame) Sets the workframe currently active for the active instance
void	setLocation(IAreaCtx location) Sets the current location of the active instance.

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

addAttribute, addRelation, getAttribute, getRelation, initAttributeRelationCache, removeAttribute, removeRelation, resetAttributeRelationCache, 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

ActiveInstanceCtx

public ActiveInstanceCtx(ActiveInstance ai)

Constructor, creates a new context for the specified active instance.

Parameters:

ai - the ActiveInstance for which to create a context

Method Detail

setBelievedTime

public void setBelievedTime(long time)
                     throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Sets the active instance's believed date and time (can but is not necessarily the same as the actual current time as managed by the Scheduler)

Specified by:

setBelievedTime in interface IActiveInstanceCtx

Parameters:

time - the date and time in milliseconds

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if an invalid time (< 0) is specified

See Also:

Date.getTime()

getBelievedTime

public long getBelievedTime()

Returns the active instance's believed date and time (can but is not necessarily the same as the actual current time as managed by the Scheduler)

Specified by:

getBelievedTime in interface IActiveInstanceCtx

Returns:

long the date and time in milliseconds

addBelief

public void addBelief(IBeliefCtx belief)
               throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Add a new belief to the belief set of the active instance.

Specified by:

addBelief in interface IActiveInstanceCtx

Parameters:

belief - the IBeliefCtx to be added to the belief set.

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null belief is passed

removeBelief

public void removeBelief(IBeliefCtx belief)
                  throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified belief from the belief set of the active instance.

Specified by:

removeBelief in interface IActiveInstanceCtx

Parameters:

belief - the IBeliefCtx to be removed from the belief set.

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null belief is passed, no beliefs are present or the specified belief is not present

getBeliefs

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

Returns the active instance's belief set.

Specified by:

getBeliefs in interface IActiveInstanceCtx

Returns:

Enumeration an enumeration of BeliefCtx's

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if active instance has no beliefs

removeAllBeliefs

public void removeAllBeliefs()

Clears the active instance's belief set.

Specified by:

removeAllBeliefs in interface IActiveInstanceCtx

setLocation

public void setLocation(IAreaCtx location)

Sets the current location of the active instance.

Specified by:

setLocation in interface IActiveInstanceCtx

Parameters:

location - the current location (IAreaCtx) of the active instance or null if not in a location.

getLocation

public IAreaCtx getLocation()

Returns the current location of the active instance.

Specified by:

getLocation in interface IActiveInstanceCtx

Returns:

IAreaCtx the current location of the active instance, null if the active instance is not in a specific location

addPastLocation

public void addPastLocation(IAreaCtx location)
                     throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the given location to the list of past location visited by the active instance.

Note: The location (IAreaCtx) given must not be an area context used for actively maintaining actual location information. The context should be a separate area context referencing an Area defining the the time the active instance entered the area and the time the active instance left the area (start and end time).

Specified by:

addPastLocation in interface IActiveInstanceCtx

Parameters:

location - the IAreaCtx to be added to the active instance's location history

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if the specified location is null.

removePastLocation

public void removePastLocation(IAreaCtx location)
                        throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified location from the list of the active instance's past locations.

Specified by:

removePastLocation in interface IActiveInstanceCtx

Parameters:

location - the IAreaCtx to be removed from the list of past locations.

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null location is specified, no past locations are present or the specified location is not present

getPastLocations

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

Returns the active instance's past locations.

Specified by:

getPastLocations in interface IActiveInstanceCtx

Returns:

Enumeration an enumeration of IAreaCtx's

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if active instance has no past locations

removeAllPastLocations

public void removeAllPastLocations()

Clears the active instance's list containing past locations.

Specified by:

removeAllPastLocations in interface IActiveInstanceCtx

addContainedElement

public void addContainedElement(ContainedInstanceCtx ci)
                         throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the given contained element to the list of elements carried or contained by this active instance.

Specified by:

addContainedElement in interface IActiveInstanceCtx

Parameters:

ci - the ContainedInstanceCtx to be added as the element contained by this active instance

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if the specified contained element is null.

removeContainedElement

public void removeContainedElement(ContainedInstanceCtx ci)
                            throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified contained element from the list of elements carried or contained by this active instance.

Specified by:

removeContainedElement in interface IActiveInstanceCtx

Parameters:

ci - the ContainedInstanceCtx to be removed.

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null contained element is specified, no contained elements are present or the specified contained element is not present

getContainedElements

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

Returns the active instance's carried or contained elements.

Specified by:

getContainedElements in interface IActiveInstanceCtx

Returns:

Enumeration an enumeration of ContainedInstanceCtx's

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if active instance has no contained elements

removeAllContainedElements

public void removeAllContainedElements()

Clears the active instance's list containing the contained elements.

Specified by:

removeAllContainedElements in interface IActiveInstanceCtx

addAvailableFrame

public void addAvailableFrame(IFrameCtx frame)
                       throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the specified frame context as an available frame.

Specified by:

addAvailableFrame in interface IActiveInstanceCtx

Parameters:

frame - the available work or thoughtframe

Throws:

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

removeAvailableFrame

public void removeAvailableFrame(IFrameCtx frame)
                          throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specifies frame as an available frame.

Specified by:

removeAvailableFrame in interface IActiveInstanceCtx

Parameters:

frame - the frame to be removed as an available frame.

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if a null frame is specified, no available frames are present or the specified frame is not present

getAvailableWorkframes

public java.util.ListIterator getAvailableWorkframes()
                                              throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns a list of all the available workframes.

Specified by:

getAvailableWorkframes in interface IActiveInstanceCtx

Returns:

ListIterator an iterator returning a list of IWorkframeCtx

Throws:

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

hasAvailableWorkframes

public boolean hasAvailableWorkframes()

Inficates whether there are any available workframes.

Specified by:

hasAvailableWorkframes in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more available workframe instantiations, false otherwise

getAvailableThoughtframes

public java.util.ListIterator getAvailableThoughtframes()
                                                 throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns a list of all the available thoughtframes.

Specified by:

getAvailableThoughtframes in interface IActiveInstanceCtx

Returns:

ListIterator an iterator returning a list of IThoughtframeCtx

Throws:

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

hasAvailableThoughtframes

public boolean hasAvailableThoughtframes()

Inficates whether there are any available thoughtframes.

Specified by:

hasAvailableThoughtframes in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more available thoughtframe instantiations, false otherwise

getPriorityAvailableWorkframe

protected IWorkframeCtx getPriorityAvailableWorkframe()

Returns the highest priority available workframe.

Returns:

IWorkframeCtx the context of the highest priority available workframe, null if there are no available workframes.

getPriorityAvailableThoughtframe

protected IThoughtframeCtx getPriorityAvailableThoughtframe()

Returns the highest priority available thoughtframe.

Returns:

IThoughtframeCtx the context of the highest priority available thoughtframe, null if there are no available thoughtframes.

removeAllAvailableFrames

public void removeAllAvailableFrames()

Removes all the available frames, work and thoughtframes.

Specified by:

removeAllAvailableFrames in interface IActiveInstanceCtx

addInterruptedFrame

public void addInterruptedFrame(IWorkframeCtx frame)
                         throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the specified frame context as an interrupted frame.

Specified by:

addInterruptedFrame in interface IActiveInstanceCtx

Parameters:

frame - the interrupted workframe to be added

Throws:

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

removeInterruptedFrame

public void removeInterruptedFrame(IWorkframeCtx frame)
                            throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified frame context as an interrupted frame.

Specified by:

removeInterruptedFrame in interface IActiveInstanceCtx

Parameters:

frame - the interrupted workframe to be removed

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if frame is null, no interrupted frames are available, or the frame is not present as an interrupted frame

getInterruptedFrames

public java.util.ListIterator getInterruptedFrames()
                                            throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns a list of all the interrupted workframes.

Specified by:

getInterruptedFrames in interface IActiveInstanceCtx

Returns:

ListIterator an iterator returning a list of IWorkframeCtx

Throws:

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

hasInterruptedFrames

public boolean hasInterruptedFrames()

Inficates whether there are any interrupted workframes.

Specified by:

hasInterruptedFrames in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more interrupted workframe instantiations, false otherwise

getPriorityInterruptedFrame

protected IWorkframeCtx getPriorityInterruptedFrame()

Returns the highest priority interrupted workframe.

Returns:

IWorkframeCtx the context of the highest priority interrupted workframe, null if there are no interrupted workframes.

removeAllInterruptedFrames

public void removeAllInterruptedFrames()

Removes all the interrupted frames.

Specified by:

removeAllInterruptedFrames in interface IActiveInstanceCtx

addImpassedFrame

public void addImpassedFrame(IWorkframeCtx frame)
                      throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the specified frame context as an impassed frame.

Specified by:

addImpassedFrame in interface IActiveInstanceCtx

Parameters:

frame - the impassed workframe to be added

Throws:

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

removeImpassedFrame

public void removeImpassedFrame(IWorkframeCtx frame)
                         throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified frame context as an impassed frame.

Specified by:

removeImpassedFrame in interface IActiveInstanceCtx

Parameters:

frame - the impassed workframe to be removed

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if frame is null, no impassed frames are available, or the frame is not present as an impassed frame

getImpassedFrames

public java.util.ListIterator getImpassedFrames()
                                         throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns a list of all the impassed workframes.

Specified by:

getImpassedFrames in interface IActiveInstanceCtx

Returns:

ListIterator an iterator returning a list of WorkframeCtx

Throws:

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

hasImpassedFrames

public boolean hasImpassedFrames()

Inficates whether there are any impassed workframes.

Specified by:

hasImpassedFrames in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more impassed workframe instantiations, false otherwise

removeAllImpassedFrames

public void removeAllImpassedFrames()

Removes all the impassed frames.

Specified by:

removeAllImpassedFrames in interface IActiveInstanceCtx

addCompletedFrame

public void addCompletedFrame(IFrameCtx frame)
                       throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the given frame context as a completed frame. This method is used by the virtual machine to store non repearing frames and this method can be used by other components to store a history of executed frames.

Specified by:

addCompletedFrame in interface IActiveInstanceCtx

Parameters:

frame - the IFrameCtx to be added as a completed frame

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if frame context is null or frame context references no frame

removeCompletedFrame

public void removeCompletedFrame(IFrameCtx frame)
                          throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the given frame context as a completed frame context

Specified by:

removeCompletedFrame in interface IActiveInstanceCtx

Parameters:

frame - the frame context to be removed

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if frame is null, no completed frames exist for the frame for which the specified frame is a context or if the specified frame context is not found or if the specified frame is not referencing a workframe or thoughtframe

getCompletedWorkframes

public java.util.ListIterator getCompletedWorkframes(java.lang.String frameName)
                                              throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Return a list of all the completed workframe contexts for the workframe with the specified fully qualified name.

Specified by:

getCompletedWorkframes in interface IActiveInstanceCtx

Parameters:

frameName - the fully qualified name for the workframe

Returns:

ListIterator the list of completed IWorkframeCtx

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if an invalid name is specified or no completed frames exist

getCompletedWorkframeNames

public java.util.Set<java.lang.String> getCompletedWorkframeNames()
                                                           throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Return a list of the fully qualified names for all the workframes for which completed workframe contexts exist.

Specified by:

getCompletedWorkframeNames in interface IActiveInstanceCtx

Returns:

Set the names of workframes for which completed IWorkframeCtx exist

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no completed frames exist

hasCompletedWorkframes

public boolean hasCompletedWorkframes()

Inficates whether there are any completed workframes.

Specified by:

hasCompletedWorkframes in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more completed workframe instantiations, false otherwise

getCompletedThoughtframes

public java.util.ListIterator getCompletedThoughtframes(java.lang.String frameName)
                                                 throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Return a list of all the completed thoughtframe contexts for the thoughtframe with the specified fully qualified name.

Specified by:

getCompletedThoughtframes in interface IActiveInstanceCtx

Parameters:

frameName - the fully qualified name for the thoughtframe

Returns:

ListIterator the list of completed IThoughtframeCtx

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if an invalid name is specified or no completed frames exist

getCompletedThoughtframeNames

public java.util.Set<java.lang.String> getCompletedThoughtframeNames()
                                                              throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Return a list of the fully qualified names for all the thoughtframes for which completed thoughtframe contexts exist.

Specified by:

getCompletedThoughtframeNames in interface IActiveInstanceCtx

Returns:

Set the names of thoughtframes for which completed IThoughtframeCtx exist

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no completed frames exist

hasCompletedThoughtframes

public boolean hasCompletedThoughtframes()

Inficates whether there are any completed thoughtframes.

Specified by:

hasCompletedThoughtframes in interface IActiveInstanceCtx

Returns:

boolean true if there are one or more completed thoughtframe instantiations, false otherwise

removeAllCompletedFrames

public void removeAllCompletedFrames()

Removes all the completed frames, work and thoughtframes.

Specified by:

removeAllCompletedFrames in interface IActiveInstanceCtx

setCurrentWork

public void setCurrentWork(IWorkframeCtx frame)

Sets the workframe currently active for the active instance

Specified by:

setCurrentWork in interface IActiveInstanceCtx

Parameters:

frame - the current work (IWorkframeCtx) of the active instance

getCurrentWork

public IWorkframeCtx getCurrentWork()

Returns the workframe currently active for the active instance. Thoughtframes are not considered current work as they take no time.

Specified by:

getCurrentWork in interface IActiveInstanceCtx

Returns:

IWorkframeCtx the current work of the active instance, null if the active instance is not working on anything

addImpasseDetectable

public void addImpasseDetectable(IDetectableCtx detectable)
                          throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Adds the specified detectable causing an impasse to the list of impasse causing detectables.

Specified by:

addImpasseDetectable in interface IActiveInstanceCtx

Parameters:

detectable - the IDetectableCtx for the detectable causing an impasse

Throws:

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

removeImpasseDetectable

public void removeImpasseDetectable(IDetectableCtx detectable)
                             throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Removes the specified detectable causing an impasse from the list of impasse causing detectables.

Specified by:

removeImpasseDetectable in interface IActiveInstanceCtx

Parameters:

detectable - the IDetectableCtx for the detectable causing an impasse to be removed

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if the detectable is null or no impasse causing detectables exist or the specified detectable is not found

getImpasseDetectables

public java.util.ListIterator getImpasseDetectables()
                                             throws gov.nasa.arc.brahms.common.exceptions.BrahmsException

Returns the list of detectables causing an impasse.

Specified by:

getImpasseDetectables in interface IActiveInstanceCtx

Returns:

ListIterator the list of detectables (IDetectableCtx) causing an impasse

Throws:

gov.nasa.arc.brahms.common.exceptions.BrahmsException - if no detectables causing an impasse exist

removeAllImpasseDetectables

public void removeAllImpasseDetectables()

Removes all the detectables causing an impasse.

Specified by:

removeAllImpasseDetectables in interface IActiveInstanceCtx