org.lsst.ccs.services

Class AbstractAgentLockServiceDelegate

java.lang.Object

org.lsst.ccs.services.AbstractAgentLockServiceDelegate

All Implemented Interfaces:

AgentPresenceListener, AgentLockServiceDelegate

Direct Known Subclasses:

LocalAgentLockService, RemoteAgentLockService

public abstract class AbstractAgentLockServiceDelegate
extends Object
implements AgentLockServiceDelegate, AgentPresenceListener

Field Summary

Fields

Modifier and Type	Field and Description
protected List<AgentLockService.AgentLevelListener>	agentLevelListeners
protected Map<String,Integer>	agentLevels
protected List<AgentLockService.AgentLockUpdateListener>	agentLockUpdateListeners
protected Map<String,AgentLock>	heldLocks
protected Semaphore	levelListenersSemaphore
protected Object	lockLevelUpdate
protected Semaphore	lockListenersSemaphore
protected static Logger	log
protected AgentLockService	svc

Constructor Summary

Constructors

Constructor and Description
AbstractAgentLockServiceDelegate(AgentLockService svc)

Method Summary

Modifier and Type	Method and Description
void	addAgentLevelListener(AgentLockService.AgentLevelListener l)
void	addAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener slul)
void	connected(AgentInfo... agents) Client side code that listens for agent connections and tries to keep a record of its lock/levels.
protected Agent	getAgent()
protected AgentStateService	getAgentStateService()
List<String>	getAllWorkerAgents()
Map<String,AgentLock>	getHeldLocks()
int	getLevelForAgent(String agentName) Get this agent's authorized level at which it can operate the given agentName.
List<String>	getLockableAgents()
List<String>	getLockedAgents()
AgentLock	getLockForAgent(String agentName)
protected void	notifyLevelListeners(String agentName, int level)
protected void	notifyLockListeners(String agentName, AgentLock lock)
void	preInit()
void	removeAgentLevelListener(AgentLockService.AgentLevelListener l)
void	removeAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener l)
protected void	setLevelInternal(String agentName, int level)
protected void	setLockInternal(String agentName, AgentLock lock)

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.services.AgentLockServiceDelegate

getLocks, lockAgent, preStart, setLevelForAgent, unlockAgent, validateLock

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

connecting, disconnected, disconnecting

Field Detail

log

protected static final Logger log

svc

protected AgentLockService svc

agentLevelListeners

protected final List<AgentLockService.AgentLevelListener> agentLevelListeners

agentLockUpdateListeners

protected final List<AgentLockService.AgentLockUpdateListener> agentLockUpdateListeners

agentLevels

protected final Map<String,Integer> agentLevels

heldLocks

protected final Map<String,AgentLock> heldLocks

lockLevelUpdate

protected final Object lockLevelUpdate

levelListenersSemaphore

protected final Semaphore levelListenersSemaphore

lockListenersSemaphore

protected final Semaphore lockListenersSemaphore

Constructor Detail

AbstractAgentLockServiceDelegate

public AbstractAgentLockServiceDelegate(AgentLockService svc)

Method Detail

getAgent

protected Agent getAgent()

getAgentStateService

protected AgentStateService getAgentStateService()

preInit

public void preInit()

Specified by:

preInit in interface AgentLockServiceDelegate

getLevelForAgent

public int getLevelForAgent(String agentName)

Get this agent's authorized level at which it can operate the given agentName. It returns 0 if this agent does not hold a lock on agentName.

Specified by:

getLevelForAgent in interface AgentLockServiceDelegate

Parameters:

agentName - the agent to get the level for.

Returns:

a level. If there is no level defined for this agent, return 0.

getLockForAgent

public AgentLock getLockForAgent(String agentName)

Specified by:

getLockForAgent in interface AgentLockServiceDelegate

getHeldLocks

public Map<String,AgentLock> getHeldLocks()

Specified by:

getHeldLocks in interface AgentLockServiceDelegate

addAgentLevelListener

public void addAgentLevelListener(AgentLockService.AgentLevelListener l)

Specified by:

addAgentLevelListener in interface AgentLockServiceDelegate

removeAgentLevelListener

public void removeAgentLevelListener(AgentLockService.AgentLevelListener l)

Specified by:

removeAgentLevelListener in interface AgentLockServiceDelegate

addAgentLockUpdateListener

public void addAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener slul)

Specified by:

addAgentLockUpdateListener in interface AgentLockServiceDelegate

removeAgentLockUpdateListener

public void removeAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener l)

Specified by:

removeAgentLockUpdateListener in interface AgentLockServiceDelegate

setLockInternal

protected void setLockInternal(String agentName,
                               AgentLock lock)
                        throws UnauthorizedLockException,
                               IOException

Throws:

UnauthorizedLockException

IOException

notifyLockListeners

protected void notifyLockListeners(String agentName,
                                   AgentLock lock)

setLevelInternal

protected void setLevelInternal(String agentName,
                                int level)
                         throws UnauthorizedLevelException,
                                IOException

Throws:

UnauthorizedLevelException

IOException

notifyLevelListeners

protected void notifyLevelListeners(String agentName,
                                    int level)

connected

public void connected(AgentInfo... agents)

Client side code that listens for agent connections and tries to keep a record of its lock/levels.

Specified by:

connected in interface AgentPresenceListener

getLockableAgents

public List<String> getLockableAgents()

Specified by:

getLockableAgents in interface AgentLockServiceDelegate

getLockedAgents

public List<String> getLockedAgents()

Specified by:

getLockedAgents in interface AgentLockServiceDelegate

getAllWorkerAgents

public List<String> getAllWorkerAgents()

Specified by:

getAllWorkerAgents in interface AgentLockServiceDelegate