org.lsst.ccs.framework

Class Module

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

All Implemented Interfaces:

Observer, ConfigurationBulkChangeHandler, Configurable, HasAgentPeriodicTasks, HasLifecycle, SignalHandler, UsesSubsystem

Direct Known Subclasses:

MonMain

public class Module
extends Observable
implements HasLifecycle, ConfigurationBulkChangeHandler, Observer, Configurable, SignalHandler, HasAgentPeriodicTasks

Building block for a ModularSubsystem. These are Configurable with additional facilities:

• Observable features
• a Timer to publish data at regular intervals
• SignalHandler capabilities (and corresponding commands)
• specific commands

Author:

aubourg

notes: module driver, sends to functionnal modules such as calibration iquestion: how are the module sindependants have a look at sampler ....

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Module.ValueUpdate

Nested classes/interfaces inherited from interface org.lsst.ccs.framework.Configurable

Configurable.Environment

Field Summary

Fields

Modifier and Type	Field and Description
protected String	name Deprecated. the name of this component can be accessed via getName() Use your own field if you wish to assign it.
protected int	nObserverThreads
protected int	tickMillis Deprecated.

Constructor Summary

Constructors

Constructor and Description
Module()
Module(int tickMillis) Deprecated.
Module(String name) Deprecated. the name can be accessed via getName()
Module(String name, int tickMillis) Deprecated. the name can be accessed via getName()

Method Summary

Modifier and Type	Method and Description
List<AgentPeriodicTask>	getAgentPeriodicTasks() Get the list of the AgentPeriodicTasks to be executed by the framework.
int	getNObserverThreads() Deprecated. it does not provide any useful information
List<Observable>	getObservables() Returns the list of Observable this module is observing.
int	getTickMillis() Deprecated.
void	init() Called from the enclosing Subsystem at construction phase.
void	initModule() Deprecated. use init method of HasLifeCycle instead.
void	listens(Observable... observs) Adds a list of observables for this module.
void	processUpdate(Observable source, Module.ValueUpdate update) This method should be overriden to handle change to properties of watched modules
void	setNObserverThreads(int observerThreads) Deprecated.
void	setObservables(List<Observable> l) Adds a list of observables for this module.
void	setTickMillis(int tickMillis) Deprecated. invoke setTaskPeriodMillis on the task instead.
void	shutdownNow() added for tying to unstuck ExcecutorService.
void	startTicking() Deprecated. this is not needed anymore.
void	tick() Deprecated. use the HasPeriodicTask interface instead and make sure this method has an empty implementation.
void	update(Observable o, Object arg) Synchronous update.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.lsst.ccs.framework.Configurable

change, dropSubmittedChanges, getChildren, getComponentByName, getEnvironment, getParent, getParentObject, getSubmittedChanges, isParameterConfigurable, printConfigurableParameters, setBulkParameter, submitChange, submitChanges, validateBulkChange

Methods inherited from interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

setParameterBulk

Methods inherited from interface org.lsst.ccs.framework.HasLifecycle

postInit, postStart, start

Methods inherited from interface org.lsst.ccs.framework.SignalHandler

sendSignal, sendSignalWithTimeLimit, signal

Methods inherited from interface org.lsst.ccs.UsesSubsystem

getComponentConfigurationEnvironment, getComponentLookup, getName, getSubsystem

Field Detail

name

@Deprecated
protected String name

Deprecated. the name of this component can be accessed via getName() Use your own field if you wish to assign it.

nObserverThreads

protected int nObserverThreads

tickMillis

@Deprecated
 @ConfigurationParameter
protected int tickMillis

Deprecated.

Constructor Detail

Module

public Module()

Module

@Deprecated
public Module(int tickMillis)

Deprecated.

Parameters:

tickMillis -

Module

@Deprecated
public Module(String name,
                          int tickMillis)

Deprecated. the name can be accessed via getName()

Parameters:

name -

tickMillis -

Module

@Deprecated
public Module(String name)

Deprecated. the name can be accessed via getName()

Parameters:

name -

Method Detail

setObservables

public void setObservables(List<Observable> l)

Adds a list of observables for this module.

Parameters:

l - the list of Observable to add

listens

public void listens(Observable... observs)

Adds a list of observables for this module.

Parameters:

observs - one or more Observable to add

getObservables

public List<Observable> getObservables()

Returns the list of Observable this module is observing.

Returns:

a list of

setTickMillis

@Deprecated
 @ConfigurationParameterChanger(propertyName="tickMillis")
public void setTickMillis(int tickMillis)

Deprecated. invoke setTaskPeriodMillis on the task instead.

Changes the periodic wake up time. The tick method will be called every tickMillis ms.

if called before startup this method just fix the tick frequency (the module wil later "tick" at this rate) .

if called after startup then will change the ticking rate
in that case the ticking will change but new rate will be effective after a delay of "old rate"

Parameters:

tickMillis -

getTickMillis

@Deprecated
public int getTickMillis()

Deprecated.

This method is not needed.

Returns:

the period of this module's ticking task.

setNObserverThreads

@Deprecated
public void setNObserverThreads(int observerThreads)

Deprecated.

Parameters:

observerThreads -

getNObserverThreads

@Deprecated
public int getNObserverThreads()

Deprecated. it does not provide any useful information

Returns:

the number of threads dedicated to process observer updates (inconsistent)

init

public final void init()

Description copied from interface: HasLifecycle

Called from the enclosing Subsystem at construction phase. This method is called before the children components of this object have their init method called. At the time it is called, connection to the messaging layer is not yet done, so there should be no attempt to send messages in the body of this method. Configuration for message listening can nevertheless be done here, such as adding MessageListener objects.

It is unnecessary to call super.init()

Specified by:

init in interface HasLifecycle

initModule

@Deprecated
public void initModule()

Deprecated. use init method of HasLifeCycle instead.

To be overriden by individual modules. Called after all parameters have been set from XML file.

startTicking

@Deprecated
public final void startTicking()

Deprecated. this is not needed anymore.

If there is a scheduled wake up (that is if the tickMillis is more than zero) then the ticking starts. This method is called on every module after the subsystem is itself ready to listen to commands.

update

public void update(Observable o,
                   Object arg)

Synchronous update. Do not override, override processUpdate. Should we make it final?

Specified by:

update in interface Observer

processUpdate

public void processUpdate(Observable source,
                          Module.ValueUpdate update)

This method should be overriden to handle change to properties of watched modules

Parameters:

source - the module

update - the update message, containing property name and new value

tick

@Deprecated
public void tick()

Deprecated. use the HasPeriodicTask interface instead and make sure this method has an empty implementation.

getAgentPeriodicTasks

public List<AgentPeriodicTask> getAgentPeriodicTasks()

Description copied from interface: HasAgentPeriodicTasks

Get the list of the AgentPeriodicTasks to be executed by the framework. This method is invoked when the ComponentLookup is set on the Subsystem, i.e. right after the objects on the ComponentLookup are built. So this list must be built either in the constructor or in the method itself.

Specified by:

getAgentPeriodicTasks in interface HasAgentPeriodicTasks

Returns:

The List of PeriodicTasks.

shutdownNow

public void shutdownNow()

added for tying to unstuck ExcecutorService. REVIEW : does it need to be stopped explicitely since it is handled by the scheduler ?

Specified by:

shutdownNow in interface HasLifecycle