org.lsst.ccs.services

Class AgentCommandDictionaryService

java.lang.Object

org.lsst.ccs.services.AgentCommandDictionaryService

All Implemented Interfaces:

ServiceLifecycle, AgentService

public class AgentCommandDictionaryService
extends Object
implements ServiceLifecycle, AgentService

A service to manage the Command Dictionary of a given agent. It has two components to it: - command dictionary management: it builds a command dictionary for all components on the lookup tree that have methods annotated with the Command annotation. It also provides an API that can be used to add commands to a given path from objects that are not on the lookup tree. - client side command dictionary record keeping: for Consoles only. It listens to the buses for the presence of Agents and it keeps an online snapshot of the currently available dictionaries on the buses. Rules to add command dictionaries: - dictionaries can only be added in the HasLifecycle:init phase. All other attempts will fail with a RuntimeException. Dictionary publication on the status bus: this service is responsible for publishing an Agent's command dictionary: - every time a CONSOLE is connected to the buses - upon startup as soon as the full dictionary is ready the dictionary is published in a StatusCommandDicionary status message.

Author:

LSST CCS Team

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AgentCommandDictionaryService.AgentCommandDictionaryCommands
static class	AgentCommandDictionaryService.AgentCommandDictionaryEvent An event fired to AgentCommandDictionaryListeners when an agent command dictionary has changed.
static interface	AgentCommandDictionaryService.AgentCommandDictionaryListener A Listener to receive notifications of CommandDictionary changes.

Constructor Summary

Constructors

Constructor and Description
AgentCommandDictionaryService()

Method Summary

Modifier and Type	Method and Description
void	addAgentCommandDictionaryListener(AgentCommandDictionaryService.AgentCommandDictionaryListener listener)
void	addCommandSetToObject(Object obj, Object objectToAddTo) Adds a CommandSet to extend the set of commands recognized by this Agent.
void	afterInit()
void	afterStart()
HashMap<String,Dictionary>	getAgentCommandDictionary()
AgentDictionaryCommand	getAgentDictionaryCommand(String destination, String commandName, int nArgs) Get an agent DictionaryCommand by name and with a given number of arguments
String	getAgentServiceName() Get the name of this service.
CommandSet	getCommandSet(String name)
long	getDictionaryChecksum()
void	preInit()
void	preStart() Called from the enclosing Subsystem when org.lsst.ccs.Subsystem#start() has been called.
void	removeAgentCommandDictionaryListener(AgentCommandDictionaryService.AgentCommandDictionaryListener listener)
boolean	startForAgent(AgentInfo agentInfo) This method is invoked after an agent service is created to see if this service is to be started for the tiven Agent.

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.ServiceLifecycle

preBuild, preShutdown

Constructor Detail

AgentCommandDictionaryService

public AgentCommandDictionaryService()

Method Detail

getAgentServiceName

public String getAgentServiceName()

Description copied from interface: AgentService

Get the name of this service. This name will be used to add the given service to the lookup tree.

Specified by:

getAgentServiceName in interface AgentService

Returns:

the AgentService name.

startForAgent

public boolean startForAgent(AgentInfo agentInfo)

Description copied from interface: AgentService

This method is invoked after an agent service is created to see if this service is to be started for the tiven Agent.

Specified by:

startForAgent in interface AgentService

Returns:

true if the service is to be added to the given agent.

preInit

public void preInit()

Specified by:

preInit in interface ServiceLifecycle

preStart

public void preStart()

Description copied from interface: ServiceLifecycle

Called from the enclosing Subsystem when org.lsst.ccs.Subsystem#start() has been called.

The preceding lifecycle step is HasLifecycle.postInit()

The following lifecycle step is HasLifecycle.start() At the time it is called :

• the PhaseState is INITIALIZING
• connection with the messaging layer is effective, the enclosing subsystem has started StatusHeartBeat publication

Specified by:

preStart in interface ServiceLifecycle

afterStart

public void afterStart()

Specified by:

afterStart in interface ServiceLifecycle

afterInit

public void afterInit()

Specified by:

afterInit in interface ServiceLifecycle

getDictionaryChecksum

public long getDictionaryChecksum()

getCommandSet

public CommandSet getCommandSet(String name)

addCommandSetToObject

public void addCommandSetToObject(Object obj,
                                  Object objectToAddTo)

Adds a CommandSet to extend the set of commands recognized by this Agent.

Parameters:

obj - The object with the commands

objectToAddTo - the object to add the commands to.

getAgentCommandDictionary

public HashMap<String,Dictionary> getAgentCommandDictionary()

getAgentDictionaryCommand

public AgentDictionaryCommand getAgentDictionaryCommand(String destination,
                                                        String commandName,
                                                        int nArgs)

Get an agent DictionaryCommand by name and with a given number of arguments

addAgentCommandDictionaryListener

public void addAgentCommandDictionaryListener(AgentCommandDictionaryService.AgentCommandDictionaryListener listener)

removeAgentCommandDictionaryListener

public void removeAgentCommandDictionaryListener(AgentCommandDictionaryService.AgentCommandDictionaryListener listener)