org.lsst.ccs.services

Class AbstractAgentLockServiceDelegate

java.lang.Object

org.lsst.ccs.services.AbstractAgentLockServiceDelegate

All Implemented Interfaces:

AgentPresenceListener, AgentLockServiceDelegate, AgentLoginService.AgentLoginUpdateListener

Direct Known Subclasses:

LocalAgentLockService, RemoteAgentLockService

public abstract class AbstractAgentLockServiceDelegate
extends Object
implements AgentLockServiceDelegate, AgentPresenceListener, AgentLoginService.AgentLoginUpdateListener

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,Integer>	agentLevels
protected List<AgentLockService.AgentLockUpdateListener>	agentLockUpdateListeners
protected Map<String,AgentLock>	allLocks
protected boolean	enforceLevel
protected Map<String,AgentLock>	heldLocks
protected Object	listenerUpdatesLock
protected static Logger	log
protected AgentLock	myCurrentLock
protected AgentLockService	svc

Constructor Summary

Constructors

Constructor and Description
AbstractAgentLockServiceDelegate(AgentLockService svc)

Method Summary

Modifier and Type	Method and Description
void	addAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener aluListener)
protected void	addHeldLock(AgentLock lock)
protected Agent	getAgent()
protected AgentStateService	getAgentStateService()
List<String>	getAllWorkerAgents()
List<String>	getAttachableAgents()
AgentLock	getCurrentLock()
List<String>	getDetachableAgents()
AgentLock	getExistingLockForAgent(String agentName)
Map<String,AgentLock>	getHeldLocks()
int	getLevelForAgent(String agentName) Get this agent's authorized level at which it can operate the given agentName.
List<String>	getLocallyLockedAgents()
List<String>	getLockableAgents()
List<String>	getLockedAgents()
AgentLock	getLockForAgent(String agentName)
Map<String,AgentLock>	getLocks()
int	getMaxLevel(String userid, String agentName)
protected void	notifyGlobalLockListeners(String agentName, AgentLock lock)
protected void	notifyHeldLockListeners(String agentName, AgentLock lock)
protected void	notifyLevelListeners(String agentName, int level)
protected void	notifyLockListeners(String agentName, String owner, AgentLock lock)
protected void	notifyLockVisibility(String oldUserid, String newUserid)
void	onAgentLoginUpdate(String oldUserId, String newUserId) Called upon login
void	preInit()
void	preStart()
void	removeAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener aluListener)
protected void	removeCurrentLock()
protected void	removeHeldLock(String agentName, AgentLock info)
protected void	setCurrentLock(AgentLock lock)
protected void	setLevelInternal(String agentName, int level)
String	validateLock(DictionaryCommand command, AgentLock lock, int level)

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

attachLock, destroyLock, detachLock, lockAgent, setLevelForAgent, unlockAgent

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

connected, connecting, disconnected, disconnecting

Field Detail

log

protected static final Logger log

svc

protected AgentLockService svc

agentLockUpdateListeners

protected final List<AgentLockService.AgentLockUpdateListener> agentLockUpdateListeners

agentLevels

protected final Map<String,Integer> agentLevels

heldLocks

protected final Map<String,AgentLock> heldLocks

allLocks

protected final Map<String,AgentLock> allLocks

myCurrentLock

protected volatile AgentLock myCurrentLock

enforceLevel

protected final boolean enforceLevel

listenerUpdatesLock

protected final Object listenerUpdatesLock

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

preStart

public void preStart()

Specified by:

preStart 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 = Command.NORMAL 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

getExistingLockForAgent

public AgentLock getExistingLockForAgent(String agentName)

Specified by:

getExistingLockForAgent in interface AgentLockServiceDelegate

getHeldLocks

public Map<String,AgentLock> getHeldLocks()

Specified by:

getHeldLocks in interface AgentLockServiceDelegate

addHeldLock

protected void addHeldLock(AgentLock lock)
                    throws UnauthorizedLockException

Throws:

UnauthorizedLockException

removeHeldLock

protected void removeHeldLock(String agentName,
                              AgentLock info)
                       throws UnauthorizedLockException

Throws:

UnauthorizedLockException

setCurrentLock

protected void setCurrentLock(AgentLock lock)

getCurrentLock

public AgentLock getCurrentLock()

removeCurrentLock

protected void removeCurrentLock()

addAgentLockUpdateListener

public void addAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener aluListener)

Specified by:

addAgentLockUpdateListener in interface AgentLockServiceDelegate

removeAgentLockUpdateListener

public void removeAgentLockUpdateListener(AgentLockService.AgentLockUpdateListener aluListener)

Specified by:

removeAgentLockUpdateListener in interface AgentLockServiceDelegate

notifyLockListeners

protected void notifyLockListeners(String agentName,
                                   String owner,
                                   AgentLock lock)

notifyHeldLockListeners

protected void notifyHeldLockListeners(String agentName,
                                       AgentLock lock)

notifyGlobalLockListeners

protected void notifyGlobalLockListeners(String agentName,
                                         AgentLock lock)

notifyLevelListeners

protected void notifyLevelListeners(String agentName,
                                    int level)

notifyLockVisibility

protected void notifyLockVisibility(String oldUserid,
                                    String newUserid)

onAgentLoginUpdate

public void onAgentLoginUpdate(String oldUserId,
                               String newUserId)

Description copied from interface: AgentLoginService.AgentLoginUpdateListener

Called upon login

Specified by:

onAgentLoginUpdate in interface AgentLoginService.AgentLoginUpdateListener

setLevelInternal

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

Throws:

UnauthorizedLevelException

getLockableAgents

public List<String> getLockableAgents()

Specified by:

getLockableAgents in interface AgentLockServiceDelegate

getLocallyLockedAgents

public List<String> getLocallyLockedAgents()

Specified by:

getLocallyLockedAgents in interface AgentLockServiceDelegate

getLockedAgents

public List<String> getLockedAgents()

Specified by:

getLockedAgents in interface AgentLockServiceDelegate

getDetachableAgents

public List<String> getDetachableAgents()

Specified by:

getDetachableAgents in interface AgentLockServiceDelegate

getAttachableAgents

public List<String> getAttachableAgents()

Specified by:

getAttachableAgents in interface AgentLockServiceDelegate

getAllWorkerAgents

public List<String> getAllWorkerAgents()

Specified by:

getAllWorkerAgents in interface AgentLockServiceDelegate

getLocks

public Map<String,AgentLock> getLocks()

Specified by:

getLocks in interface AgentLockServiceDelegate

validateLock

public String validateLock(DictionaryCommand command,
                           AgentLock lock,
                           int level)

Specified by:

validateLock in interface AgentLockServiceDelegate

getMaxLevel

public int getMaxLevel(String userid,
                       String agentName)

Specified by:

getMaxLevel in interface AgentLockServiceDelegate