org.lsst.ccs.services

Class AgentVersionsService

java.lang.Object

org.lsst.ccs.services.AgentVersionsService

All Implemented Interfaces:

HasLifecycle, AgentPresenceListener, ServiceLifecycle, AgentService

public class AgentVersionsService
extends Object
implements AgentService, ServiceLifecycle, HasLifecycle, AgentPresenceListener

An Agent Service to handle information related to the distribution. This information includes versions for: - the current running agent - the toolkit it's using - the distribution it's running in This service also provides a way to verify that the current versions are supported by the cluster it's running in. This service is activated for all Agents.

Author:

The LSST CCS Team

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AgentVersionsService.VersionCommands
static class	AgentVersionsService.VersionConstraint

Field Summary

Fields

Modifier and Type	Field and Description
static String	AGENT
static String	AGENT_VERSION
static String	DISTRIBUTION
static String	DISTRIBUTION_VERSION
static String	TOOLKIT
static String	TOOLKIT_VERSION

Constructor Summary

Constructors

Constructor and Description
AgentVersionsService()

Method Summary

Modifier and Type	Method and Description
void	afterInit()
void	connecting(AgentInfo... agents) Indicates that the list of agents represented by agents is present on the buses.
void	disconnected(AgentInfo... agents) Invoked when one or more agents are disconnected from this cluster, either because the shutdown or because they were lost.
protected Properties	extractVersionConstraintPropertiesFor(String key, Properties props)
String	getAgentServiceName() Get the name of this service.
Map<String,DistributionInfo>	getAllDistributionInfo()
void	preBuild()
void	preInit()
void	preShutdown()
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

afterBuild, afterStart, preStart

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

build, init, postBuild, postInit, postShutdown, postStart, shutdown, start

Methods inherited from interface org.lsst.ccs.messaging.AgentPresenceListener

connected, disconnecting

Field Detail

AGENT

public static final String AGENT

See Also:

Constant Field Values

TOOLKIT

public static final String TOOLKIT

See Also:

Constant Field Values

DISTRIBUTION

public static final String DISTRIBUTION

See Also:

Constant Field Values

AGENT_VERSION

public static final String AGENT_VERSION

See Also:

Constant Field Values

TOOLKIT_VERSION

public static final String TOOLKIT_VERSION

See Also:

Constant Field Values

DISTRIBUTION_VERSION

public static final String DISTRIBUTION_VERSION

See Also:

Constant Field Values

Constructor Detail

AgentVersionsService

public AgentVersionsService()

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.

preBuild

public void preBuild()

Specified by:

preBuild in interface ServiceLifecycle

preInit

public void preInit()

Specified by:

preInit in interface ServiceLifecycle

afterInit

public void afterInit()

Specified by:

afterInit in interface ServiceLifecycle

preShutdown

public void preShutdown()

Specified by:

preShutdown in interface ServiceLifecycle

connecting

public void connecting(AgentInfo... agents)

Description copied from interface: AgentPresenceListener

Indicates that the list of agents represented by agents is present on the buses. This method is invoked when the listener is added with all the agents that are already connected. At this point not all services on the connecting agents are guaranteed to have completely started. This method should be used only to receive a notification that an agent is connecting. For a guarantee that an agent information is fully present, please use the #connected methods. The implementation should return immediately : any blocking operations should be scheduled on a separate thread.

Specified by:

connecting in interface AgentPresenceListener

disconnected

public void disconnected(AgentInfo... agents)

Description copied from interface: AgentPresenceListener

Invoked when one or more agents are disconnected from this cluster, either because the shutdown or because they were lost. The implementation should return immediately : any blocking operations should be scheduled on a separate thread.

Specified by:

disconnected in interface AgentPresenceListener

extractVersionConstraintPropertiesFor

protected Properties extractVersionConstraintPropertiesFor(String key,
                                                           Properties props)

getAllDistributionInfo

public Map<String,DistributionInfo> getAllDistributionInfo()