org.jactr.tools.change

Class ChangeTracker

java.lang.Object

org.jactr.tools.change.ChangeTracker

All Implemented Interfaces:

IInitializable, IInstallable, IParameterized, IInstrument

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

general change tracker that logs chunk changes and production instantiations. It outputs them to the Logger, using a custom stream label "CHANGE"

Author:

harrison

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CHANGE_STREAM
static java.lang.String	FORMAT_PARAM
static java.lang.String	TRACK_ACTIVE_CHUNKS
static java.lang.String	TRACK_INSTANTIATIONS
static java.lang.String	TRACK_NEW_CHUNKS

Constructor Summary

Constructors

Constructor and Description
ChangeTracker()

Method Summary

Modifier and Type	Method and Description
protected void	flush(IModel model, boolean cleanUp) generate the code for the asts and then send them to the logger on the background thread
protected void	generateAST(IModel model, IProduction production) generate the ast of the to-be-fire instantaition
protected void	generateASTs(IModel model) use the list of changed chunks to generate asts for them
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() perform any dependent initialization.
void	install(IModel model) Description of the Method
void	setParameter(java.lang.String key, java.lang.String value) Set the named parameter
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

CHANGE_STREAM

public static final java.lang.String CHANGE_STREAM

See Also:

Constant Field Values

FORMAT_PARAM

public static final java.lang.String FORMAT_PARAM

See Also:

Constant Field Values

TRACK_NEW_CHUNKS

public static final java.lang.String TRACK_NEW_CHUNKS

See Also:

Constant Field Values

TRACK_ACTIVE_CHUNKS

public static final java.lang.String TRACK_ACTIVE_CHUNKS

See Also:

Constant Field Values

TRACK_INSTANTIATIONS

public static final java.lang.String TRACK_INSTANTIATIONS

See Also:

Constant Field Values

Constructor Detail

ChangeTracker

public ChangeTracker()

Method Detail

initialize

public void initialize()

Description copied from interface: IInstrument

perform any dependent initialization. this is called before the model starts, on the model thread. All model data will be available at this time. this method should excecute as quickly as possible so that all the model can start running sooner. Any long running actions should likely be started during install and harvested by initialize()

Specified by:

initialize in interface IInitializable

Specified by:

initialize in interface IInstrument

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

generateAST

protected void generateAST(IModel model,
                           IProduction production)

generate the ast of the to-be-fire instantaition

Parameters:

model -

production -

generateASTs

protected void generateASTs(IModel model)

use the list of changed chunks to generate asts for them

Parameters:

model -

flush

protected void flush(IModel model,
                     boolean cleanUp)

generate the code for the asts and then send them to the logger on the background thread

Parameters:

model -

cleanUp -

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

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

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

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