org.lsst.ccs.framework

Class Module

java.lang.Object

org.lsst.ccs.framework.Module

All Implemented Interfaces:

ConfigurationBulkChangeHandler, Configurable, HasLifecycle, SignalHandler, UsesSubsystem

Direct Known Subclasses:

MonMain

Deprecated.

This class has been split into single purposed interfaces HasLifecycle, ConfigurationBulkChangeHandler and SignalHandler, and is not needed anymore

@Deprecated
public class Module
extends Object
implements HasLifecycle, ConfigurationBulkChangeHandler, Configurable, SignalHandler

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/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 set to any String field via the @LookupName annotation
protected int	tickMillis Deprecated.

Constructor Summary

Constructors

Constructor and Description
Module() Deprecated.
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
int	getTickMillis() Deprecated.
void	init() Deprecated. Called from the enclosing Subsystem at construction phase.
void	initModule() Deprecated. use init method of HasLifeCycle instead.
void	setTickMillis(int tickMillis) Deprecated. invoke setTaskPeriodMillis on the task instead.
void	shutdownNow() Deprecated. 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.

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, postShutdown, 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
 @LookupName
protected String name

Deprecated. the name of this component can be set to any String field via the @LookupName annotation

tickMillis

@Deprecated
 @ConfigurationParameter
protected int tickMillis

Deprecated.

Constructor Detail

Module

public Module()

Deprecated.

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

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.

init

public final void init()

Deprecated.

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.

tick

@Deprecated
public void tick()

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

shutdownNow

public void shutdownNow()

Deprecated.

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