org.jactr.core.runtime.controller.debug

Class DebugController

java.lang.Object

org.jactr.core.runtime.controller.DefaultController

org.jactr.core.runtime.controller.debug.DebugController

All Implemented Interfaces:

IDebugController, IController

public class DebugController
extends DefaultController
implements IDebugController

support production break points that block the model when the marked productions are instantiated and selected for firing. it also supports a few other break point types

Author:

developer

Field Summary

Fields inherited from class org.jactr.core.runtime.controller.DefaultController

_lock

Constructor Summary

Constructors

Constructor and Description
DebugController()

Method Summary

Modifier and Type	Method and Description
void	addBreakpoint(IModel model, BreakpointType type, java.lang.Object value) add a breakpoint
void	addListener(IBreakpointListener listener, java.util.concurrent.Executor executor) when a break point is reached, the breakpoint listeners are called
void	attach() attach to the runtime - called by the runtime during ACTRRuntime.setController();
protected void	breakpointReached(IModel model, BreakpointType type, java.lang.Object value) actually suspend the model.
protected void	checkForBreakpoint(IModel model, BreakpointType type, java.lang.Object value) will check to see if value represents a valid break point of type within model and block after calling breakpointReached
void	clearBreakpoints() clear all of the break points permitting uninterrupted execution, unless an exception occurs
void	clearBreakpoints(IModel model, BreakpointType type) clear the specified breakpoints
protected IProceduralModuleListener	createProceduralListener()
void	detach() detach the runtime - called by the runtime during ACTRRuntime.setController(null);
protected void	fireBreakpointReachedEvent(IModel model, BreakpointType type, java.lang.Object details)
protected IProceduralModuleListener	getProceduralListener()
boolean	isBreakpoint(IModel model, BreakpointType type, java.lang.Object value) is this object a breakpoint
void	removeBreakpoint(IModel model, BreakpointType type, java.lang.Object value) remove a breakpoint
void	removeListener(IBreakpointListener listener) remove said listener
void	setEnabled(IProduction production, boolean enabled)

Methods inherited from class org.jactr.core.runtime.controller.DefaultController

complete, createModelRunnable, destroyModelRunnable, getRunningModels, getSuspendedModels, getTerminatedModels, isRunning, isSuspended, resume, start, start, startModel, stop, suspend, suspendLocally, terminate, waitForCompletion, waitForResumption, waitForStart, waitForSuspension

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jactr.core.runtime.controller.IController

complete, getRunningModels, getSuspendedModels, getTerminatedModels, isRunning, isSuspended, resume, start, start, stop, suspend, terminate, waitForCompletion, waitForResumption, waitForStart, waitForSuspension

Constructor Detail

DebugController

public DebugController()

Method Detail

addListener

public void addListener(IBreakpointListener listener,
                        java.util.concurrent.Executor executor)

Description copied from interface: IDebugController

when a break point is reached, the breakpoint listeners are called

Specified by:

addListener in interface IDebugController

See Also:

IDebugController.addListener(org.jactr.core.runtime.controller.debug.event.IBreakpointListener, java.util.concurrent.Executor)

removeListener

public void removeListener(IBreakpointListener listener)

Description copied from interface: IDebugController

remove said listener

Specified by:

removeListener in interface IDebugController

See Also:

IDebugController.removeListener(org.jactr.core.runtime.controller.debug.event.IBreakpointListener)

getProceduralListener

protected IProceduralModuleListener getProceduralListener()

createProceduralListener

protected IProceduralModuleListener createProceduralListener()

attach

public void attach()

Description copied from interface: IController

attach to the runtime - called by the runtime during ACTRRuntime.setController();

Specified by:

attach in interface IController

Overrides:

attach in class DefaultController

detach

public void detach()

Description copied from interface: IController

detach the runtime - called by the runtime during ACTRRuntime.setController(null);

Specified by:

detach in interface IController

Overrides:

detach in class DefaultController

clearBreakpoints

public void clearBreakpoints()

Description copied from interface: IDebugController

clear all of the break points permitting uninterrupted execution, unless an exception occurs

Specified by:

clearBreakpoints in interface IDebugController

See Also:

IDebugController.clearBreakpoints()

clearBreakpoints

public void clearBreakpoints(IModel model,
                             BreakpointType type)

Description copied from interface: IDebugController

clear the specified breakpoints

Specified by:

clearBreakpoints in interface IDebugController

See Also:

IDebugController.clearBreakpoints(org.jactr.core.model.IModel, org.jactr.core.runtime.controller.debug.BreakpointType)

setEnabled

public void setEnabled(IProduction production,
                       boolean enabled)

Specified by:

setEnabled in interface IDebugController

addBreakpoint

public void addBreakpoint(IModel model,
                          BreakpointType type,
                          java.lang.Object value)

Description copied from interface: IDebugController

add a breakpoint

Specified by:

addBreakpoint in interface IDebugController

See Also:

IDebugController.addBreakpoint(org.jactr.core.model.IModel, org.jactr.core.runtime.controller.debug.BreakpointType, java.lang.Object)

removeBreakpoint

public void removeBreakpoint(IModel model,
                             BreakpointType type,
                             java.lang.Object value)

Description copied from interface: IDebugController

remove a breakpoint

Specified by:

removeBreakpoint in interface IDebugController

See Also:

IDebugController.removeBreakpoint(org.jactr.core.model.IModel, org.jactr.core.runtime.controller.debug.BreakpointType, java.lang.Object)

isBreakpoint

public boolean isBreakpoint(IModel model,
                            BreakpointType type,
                            java.lang.Object value)

Description copied from interface: IDebugController

is this object a breakpoint

Specified by:

isBreakpoint in interface IDebugController

Returns:

See Also:

IDebugController.isBreakpoint(org.jactr.core.model.IModel, org.jactr.core.runtime.controller.debug.BreakpointType, java.lang.Object)

checkForBreakpoint

protected void checkForBreakpoint(IModel model,
                                  BreakpointType type,
                                  java.lang.Object value)

will check to see if value represents a valid break point of type within model and block after calling breakpointReached

Parameters:

model -

type -

value -

breakpointReached

protected void breakpointReached(IModel model,
                                 BreakpointType type,
                                 java.lang.Object value)

actually suspend the model. this should only be called on the model thread via an event listener that is attached as inline. we can independently suspend or resume models, however, that doesn't make a whole lot of sense. so, when we reach this point, we suspend EVERYONE. meaning, the model that tripped this breakpoint will suspend right here, but everyone else will suspend at the top of the next cycle, unless they also trip a breakpoint.

Parameters:

model -

type -

value -

fireBreakpointReachedEvent

protected void fireBreakpointReachedEvent(IModel model,
                                          BreakpointType type,
                                          java.lang.Object details)