org.lsst.ccs.messaging.jgroups

Class JGroupsBusMessagingLayer

java.lang.Object

org.lsst.ccs.messaging.jgroups.JGroupsBusMessagingLayer

All Implemented Interfaces:

Closeable, AutoCloseable, BusMessagingLayer, MessagingLayer, ProvidesDisconnectionInformation

public class JGroupsBusMessagingLayer
extends Object
implements BusMessagingLayer, ProvidesDisconnectionInformation

Each Bus is represented by a JGroups cluster.

Each agent creates a JChannel, setName to name of agent and connect to corresponding Bus/cluster (so each agent may have up to 3 JChannel connected).
Each of these 3 channels have a JGroups Address.

for sending messages to an agent we have to find its Address in the group AND we have to find the addresses of the multiple anonymous agents that will receive a copy

There is a dictionary to match agent name to jGroups Address. for each agent there is an Address except for anonymous agent that can be matched to multiple addresses.

< * p/> ImPortant every Jchannel in the JVM MUST be closed!

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_UDP_PROTOCOL

Method Summary

Modifier and Type	Method and Description
void	addMessageListener(String agentName, BusMessageForwarder forwarder, org.lsst.ccs.bus.definition.Bus... buses)
void	close()
void	closeFor(String agentName, org.lsst.ccs.bus.definition.Bus... buses)
void	connect(MessagingAccessLayer accessLayer)
void	disconnect(MessagingAccessLayer accessLayers)
Set<String>	getRegisteredLocalAgents(org.lsst.ccs.bus.definition.Bus... buses)
void	register(String agentName, org.lsst.ccs.bus.definition.Bus... buses)
void	removeMessageListener(String agentName, BusMessageForwarder forwarder, org.lsst.ccs.bus.definition.Bus... buses)
<T extends org.lsst.ccs.bus.messages.BusMessage> void	sendMessage(String senderAgent, org.lsst.ccs.bus.definition.Bus bus, T message)

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.messaging.BusMessagingLayer

getRegisteredLocalAgents, parseDestination

Field Detail

DEFAULT_UDP_PROTOCOL

public static final String DEFAULT_UDP_PROTOCOL

See Also:

Constant Field Values

Method Detail

register

public void register(String agentName,
                     org.lsst.ccs.bus.definition.Bus... buses)
              throws IOException,
                     DuplicateAgentNameException

Specified by:

register in interface BusMessagingLayer

Throws:

IOException

DuplicateAgentNameException

getRegisteredLocalAgents

public Set<String> getRegisteredLocalAgents(org.lsst.ccs.bus.definition.Bus... buses)

Specified by:

getRegisteredLocalAgents in interface BusMessagingLayer

closeFor

public void closeFor(String agentName,
                     org.lsst.ccs.bus.definition.Bus... buses)

Specified by:

closeFor in interface BusMessagingLayer

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface BusMessagingLayer

Throws:

IOException

sendMessage

public <T extends org.lsst.ccs.bus.messages.BusMessage> void sendMessage(String senderAgent,
                                                                         org.lsst.ccs.bus.definition.Bus bus,
                                                                         T message)
                                                                  throws IOException

Specified by:

sendMessage in interface MessagingLayer

Throws:

IOException

addMessageListener

public void addMessageListener(String agentName,
                               BusMessageForwarder forwarder,
                               org.lsst.ccs.bus.definition.Bus... buses)

Specified by:

addMessageListener in interface BusMessagingLayer

removeMessageListener

public void removeMessageListener(String agentName,
                                  BusMessageForwarder forwarder,
                                  org.lsst.ccs.bus.definition.Bus... buses)

Specified by:

removeMessageListener in interface BusMessagingLayer

connect

public void connect(MessagingAccessLayer accessLayer)
             throws DuplicateAgentNameException,
                    IOException

Specified by:

connect in interface MessagingLayer

Throws:

DuplicateAgentNameException

IOException

disconnect

public void disconnect(MessagingAccessLayer accessLayers)

Specified by:

disconnect in interface MessagingLayer