org.lsst.ccs.services

Interface AgentLockService.AgentLockUpdateListener

Enclosing class:

AgentLockService

public static interface AgentLockService.AgentLockUpdateListener

Interface for being notified of lock update events. This listener is invoked when any lock update has happened on the buses.

Method Summary

Modifier and Type	Method and Description
default void	onAgentHeldLockUpdate(String agentName, AgentLock lock) Called when the current agent acquires or releases a new lock
default void	onAgentLevelChange(String agentName, int level) Called when the level on a (local) lock is changed
default void	onAgentLockUpdate(String agentName, String owner, AgentLock lock) Called when the current agent is locked or unlocked.
default void	onGlobalLockUpdate(String agentName, String owner, AgentLock lock) Called when any agent on the network is locked or unlocked

Method Detail

onAgentHeldLockUpdate

default void onAgentHeldLockUpdate(String agentName,
                                   AgentLock lock)

Called when the current agent acquires or releases a new lock

Parameters:

agentName - the target agent for which there has been a lock update. the lock owner is ourselves

lock - the new lock for agentName. It is null if agentName was unlocked.

onAgentLockUpdate

default void onAgentLockUpdate(String agentName,
                               String owner,
                               AgentLock lock)

Called when the current agent is locked or unlocked. Not active for the local implementation.

Parameters:

agentName - the target agent for which there has been a lock update.

owner - the lock owner

lock - the lock for agentName. For the remote implementaion, the AgentLock is an AgentLockInfo instance and the status field provides information on the state change.

onGlobalLockUpdate

default void onGlobalLockUpdate(String agentName,
                                String owner,
                                AgentLock lock)

Called when any agent on the network is locked or unlocked

Parameters:

agentName - the target agent for which there has been a lock update. Not active for the local implementation.

owner - the lock owner

lock - the lock for agentName. For the remote implementaion, the AgentLock is an AgentLockInfo instance and the status field provides information on the state change.

onAgentLevelChange

default void onAgentLevelChange(String agentName,
                                int level)

Called when the level on a (local) lock is changed

Parameters:

agentName - the target agent for which there has been a lock update.

level - the new level