AgentMessagingLayer (LSST CCS - Messaging Layer 3.1.2 API)

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

Method Summary

All Methods Static 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, Predicate<BusMessage<? extends Serializable,?>> 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, Predicate<BusMessage<? extends Serializable,?>> 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, Predicate<BusMessage<? extends Serializable,?>> filter)` Adds a listener on the Status bus with a filter.
`static AgentMessagingLayer`	`createInstance(AgentInfo agentInfo)` Build an Instance of an AgentMessagingLayer for a given Agent by providing the AgentInfo object.
`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
`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

- Method Detail
  - createInstance
```
public static AgentMessagingLayer createInstance(AgentInfo agentInfo)
```
    Build an Instance of an AgentMessagingLayer for a given Agent by providing the AgentInfo object.
    
    Parameters:
    
    agentInfo - The AgentInfo of the object for which we are creating the AgentMessagingLayer.
    
    Returns:
    
    The corresponding AgentMessagingLayer.
  - 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,
                                  Predicate<BusMessage<? extends Serializable,?>> 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,
                                     Predicate<BusMessage<? extends Serializable,?>> 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,
                                      Predicate<BusMessage<? extends Serializable,?>> 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
```
public void setCommandExecutor(CommandExecutor executor)
```
    Defines the component able to execute an incoming command
    
    Parameters:
    
    executor -

Class AgentMessagingLayer

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createInstance

getAgentInfo

getAgentName

getApplicationLayer

shutdownBusAccess

getAgentPresenceManager

addLogMessageListener

addLogMessageListener

addStatusMessageListener

addStatusMessageListener

addCommandMessageListener

addCommandMessageListener

removeLogMessageListener

removeStatusMessageListener

removeCommandMessageListener

sendLogMessage

sendStatusMessage

sendCommandRequest

sendCommandReply

setCommandExecutor