org.jactr.tools.tracer

Class RuntimeTracer

java.lang.Object

org.jactr.tools.tracer.RuntimeTracer

All Implemented Interfaces:

IInitializable, IInstallable, IParameterized, IInstrument

public class RuntimeTracer
extends java.lang.Object
implements IInstrument, IParameterized

tracer that can listen and record the actions of all running models. At the start of the run (via ACTRRuntimeEvent.STARTED), the runtime tracer snags the current controller, which must be NetworkedIOHandler

Author:

developer

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EXECUTOR_PARAM
static java.lang.String	LISTENERS
static org.apache.commons.logging.Log	LOGGER logger definition
static java.lang.String	SINK_CLASS

Constructor Summary

Constructors

Constructor and Description
RuntimeTracer()

Method Summary

Modifier and Type	Method and Description
void	add(ITraceListener listener)
protected void	applyDeferred(IParameterized parameterized)
java.util.concurrent.Executor	getExecutor()
java.lang.String	getParameter(java.lang.String key) return parameter value - null if not defined.
java.util.Collection<java.lang.String>	getPossibleParameters() Return all parameters that can be read
java.util.Collection<java.lang.String>	getSetableParameters() Return list of all parameters that can be set.
void	initialize() we attach two listeners.
void	install(IModel model) Description of the Method
void	setExecutor(java.lang.String executorName)
void	setParameter(java.lang.String key, java.lang.String value) Set the named parameter
void	setTraceSink(ITraceSink sink) where should we send all the transformed events to?
void	uninstall(IModel model) Description of the Method

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

public static final org.apache.commons.logging.Log LOGGER

logger definition

EXECUTOR_PARAM

public static final java.lang.String EXECUTOR_PARAM

See Also:

Constant Field Values

SINK_CLASS

public static final java.lang.String SINK_CLASS

See Also:

Constant Field Values

LISTENERS

public static final java.lang.String LISTENERS

See Also:

Constant Field Values

Constructor Detail

RuntimeTracer

public RuntimeTracer()

Method Detail

getExecutor

public java.util.concurrent.Executor getExecutor()

setExecutor

public void setExecutor(java.lang.String executorName)

add

public void add(ITraceListener listener)

applyDeferred

protected void applyDeferred(IParameterized parameterized)

setTraceSink

public void setTraceSink(ITraceSink sink)

where should we send all the transformed events to?

Parameters:

sink -

install

public void install(IModel model)

Description copied from interface: IInstrument

Description of the Method

Specified by:

install in interface IInstallable

Specified by:

install in interface IInstrument

Parameters:

model - Description of the Parameter

uninstall

public void uninstall(IModel model)

Description copied from interface: IInstrument

Description of the Method

Specified by:

uninstall in interface IInstallable

Specified by:

uninstall in interface IInstrument

Parameters:

model - Description of the Parameter

initialize

public void initialize()

we attach two listeners. The first is the runtime listener which when the runtime stops, will force us to flush our data. The other is the a breakpoint listener so that it a breakpoint is reached, we flush.

Specified by:

initialize in interface IInitializable

Specified by:

initialize in interface IInstrument

See Also:

IInstrument.initialize()

getParameter

public java.lang.String getParameter(java.lang.String key)

Description copied from interface: IParameterized

return parameter value - null if not defined.

Specified by:

getParameter in interface IParameterized

Parameters:

key - Description of the Parameter

Returns:

The parameter value

See Also:

IParameterized.getParameter(java.lang.String)

getPossibleParameters

public java.util.Collection<java.lang.String> getPossibleParameters()

Description copied from interface: IParameterized

Return all parameters that can be read

Specified by:

getPossibleParameters in interface IParameterized

Returns:

The possibleParameters value

See Also:

IParameterized.getPossibleParameters()

getSetableParameters

public java.util.Collection<java.lang.String> getSetableParameters()

Description copied from interface: IParameterized

Return list of all parameters that can be set.

Specified by:

getSetableParameters in interface IParameterized

Returns:

The setableParameters value

See Also:

IParameterized.getSetableParameters()

setParameter

public void setParameter(java.lang.String key,
                         java.lang.String value)

Description copied from interface: IParameterized

Set the named parameter

Specified by:

setParameter in interface IParameterized

See Also:

IParameterized.setParameter(java.lang.String, java.lang.String)