AgentMessagingLayer (LSST Camera Control Software

java.lang.Object
- org.lsst.ccs.messaging.AgentMessagingLayer

```
public class AgentMessagingLayer
extends Object
```
This interface provides messaging methods for a component (eg an agent) to be able to communicate on the buses. Provided methods allow to add/remove message listeners on each of the buses, to send message on each of the buses, to specify a unique CommandExecutor associated to the agent and a list of CommandOriginator.

Author:

LSST CCS Team

Constructor Summary

Constructors
Modifier Constructor and Description

protected AgentMessagingLayer(AgentInfo agentInfo)

Constructors
Modifier	Constructor and Description
`protected`	`AgentMessagingLayer(AgentInfo agentInfo)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addCommandMessageListener(CommandMessageListener listener)` Adds a listener on the Command bus.
`void`	`addCommandMessageListener(CommandMessageListener listener, BusMessageFilter filter)` Adds a listener on the Command bus with a filter.
`void`	`addLogMessageListener(LogMessageListener listener)` Adds a listener on the Log bus.
`void`	`addLogMessageListener(LogMessageListener listener, BusMessageFilter filter)` Adds a listener on the Log bus with a filter.
`void`	`addStatusMessageListener(StatusMessageListener listener)` Adds a listener on the Status bus.
`void`	`addStatusMessageListener(StatusMessageListener listener, BusMessageFilter filter)` Adds a listener on the Status bus with a filter.
`AgentInfo`	`getAgentInfo()`
`String`	`getAgentName()`
`AgentPresenceManager`	`getAgentPresenceManager()`
`protected org.lsst.ccs.messaging.BusApplicationLayer`	`getApplicationLayer()`
`void`	`removeCommandMessageListener(CommandMessageListener listener)` Removes a listener on the Command bus
`void`	`removeLogMessageListener(LogMessageListener listener)` Removes a listener on the Log bus
`void`	`removeStatusMessageListener(StatusMessageListener listener)` Removes a listener on the Status bus
`void`	`sendCommandReply(CommandReply reply)` Sends a Command Reply on the Command Bus.
`void`	`sendCommandRequest(CommandRequest cmd, CommandOriginator originator)` Sends a Command Request on the Command Bus.
`void`	`sendLogMessage(LogMessage msg)` Sends a Log Message on the Log Bus
`void`	`sendStatusMessage(StatusMessage msg)` Sends a Status Message on the Status Bus
`protected void`	`setCommandExecutor(CommandExecutor executor)` Defines the component able to execute an incoming command
`void`	`shutdownBusAccess()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AgentMessagingLayer
```
protected AgentMessagingLayer(AgentInfo agentInfo)
```
- Method Detail
  - getAgentInfo
```
public AgentInfo getAgentInfo()
```
  - getAgentName
```
public String getAgentName()
```
  - getApplicationLayer
```
protected org.lsst.ccs.messaging.BusApplicationLayer getApplicationLayer()
```
  - shutdownBusAccess
```
public void shutdownBusAccess()
```
  - getAgentPresenceManager
```
public AgentPresenceManager getAgentPresenceManager()
```
  - addLogMessageListener
```
public void addLogMessageListener(LogMessageListener listener)
```
    Adds a listener on the Log bus. By default the listener is negate passed messages published from this AgentMessagingLayer.
    
    Parameters:
    
    listener - the listener to be added on the Log bus
  - addLogMessageListener
```
public void addLogMessageListener(LogMessageListener listener,
                                  BusMessageFilter filter)
```
    Adds a listener on the Log bus with a filter. The listener is passed bus messages that pass the filter. If the filter is null, all messages are passed to the filter.
    
    Parameters:
    
    listener - the listener to be added on the Log bus
    
    filter - The BusMessageFilter to be applied to the incoming Bus Messages
  - addStatusMessageListener
```
public void addStatusMessageListener(StatusMessageListener listener)
```
    Adds a listener on the Status bus. By default the listener is negate passed messages published from this AgentMessagingLayer.
    
    Parameters:
    
    listener - the listener to be added on the Status bus
  - addStatusMessageListener
```
public void addStatusMessageListener(StatusMessageListener listener,
                                     BusMessageFilter filter)
```
    Adds a listener on the Status bus with a filter. The listener is passed bus messages that pass the filter. If the filter is null, all messages are passed to the filter.
    
    Parameters:
    
    listener - the listener to be added on the Status bus
    
    filter - The BusMessageFilter to be applied to the incoming Bus Messages
  - addCommandMessageListener
```
public void addCommandMessageListener(CommandMessageListener listener)
```
    Adds a listener on the Command bus. By default the listener is negate passed messages published from this AgentMessagingLayer.
    
    Parameters:
    
    listener - the listener to be added on the Command bus
  - addCommandMessageListener
```
public void addCommandMessageListener(CommandMessageListener listener,
                                      BusMessageFilter filter)
```
    Adds a listener on the Command bus with a filter. The listener is passed bus messages that pass the filter. If the filter is null, all messages are passed to the filter.
    
    Parameters:
    
    listener - the listener to be added on the Command bus
    
    filter - The BusMessageFilter to be applied to the incoming Bus Messages
  - removeLogMessageListener
```
public void removeLogMessageListener(LogMessageListener listener)
```
    Removes a listener on the Log bus
    
    Parameters:
    
    listener - the listener to be removed on the Log bus
  - removeStatusMessageListener
```
public void removeStatusMessageListener(StatusMessageListener listener)
```
    Removes a listener on the Status bus
    
    Parameters:
    
    listener - the listener to be removed on the Status bus
  - removeCommandMessageListener
```
public void removeCommandMessageListener(CommandMessageListener listener)
```
    Removes a listener on the Command bus
    
    Parameters:
    
    listener - the listener to be removed on the Command bus
  - sendLogMessage
```
public void sendLogMessage(LogMessage msg)
```
    Sends a Log Message on the Log Bus
    
    Parameters:
    
    msg - The message to be sent on the Log bus
  - sendStatusMessage
```
public void sendStatusMessage(StatusMessage msg)
```
    Sends a Status Message on the Status Bus
    
    Parameters:
    
    msg - The message to be sent on the Status bus
  - sendCommandRequest
```
public void sendCommandRequest(CommandRequest cmd,
                               CommandOriginator originator)
```
    Sends a Command Request on the Command Bus. This message will be received by the CommandExecutor and the list of CommandMessageListener
    
    Parameters:
    
    cmd - The CommandRequest to be sent on the Command bus
    
    originator - The component that has requested the execution of the command
  - sendCommandReply
```
public void sendCommandReply(CommandReply reply)
```
    Sends a Command Reply on the Command Bus. This message will be received by the CommandOriginator and the list of CommandMessageListener The reply can be a Nack, Ack, Error or Result
    
    Parameters:
    
    reply - The CommandReply to be sent on the Command bus
  - setCommandExecutor
```
protected void setCommandExecutor(CommandExecutor executor)
```
    Defines the component able to execute an incoming command
    
    Parameters:
    
    executor -

Class AgentMessagingLayer

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AgentMessagingLayer

Method Detail

getAgentInfo

getAgentName

getApplicationLayer

shutdownBusAccess

getAgentPresenceManager

addLogMessageListener

addLogMessageListener

addStatusMessageListener

addStatusMessageListener

addCommandMessageListener

addCommandMessageListener

removeLogMessageListener

removeStatusMessageListener

removeCommandMessageListener

sendLogMessage

sendStatusMessage

sendCommandRequest

sendCommandReply

setCommandExecutor