net.roboconf.messaging.internal.client.rabbitmq

Class RabbitMqClientAgent

java.lang.Object

net.roboconf.messaging.internal.client.rabbitmq.RabbitMqClientAgent

All Implemented Interfaces:

IAgentClient, IClient

public class RabbitMqClientAgent
extends Object
implements IAgentClient

The RabbitMQ client for an agent.

Author:

Vincent Zurczak - Linagora

Nested Class Summary

Nested classes/interfaces inherited from interface net.roboconf.messaging.client.IClient

IClient.ListenerCommand

Field Summary

Fields

Modifier and Type	Field and Description
static String	THOSE_THAT_IMPORT

Constructor Summary

Constructors

Constructor and Description
RabbitMqClientAgent()

Method Summary

Methods

Modifier and Type	Method and Description
void	closeConnection() Closes the connection with the message server.
boolean	isConnected()
void	listenToExportsFromOtherAgents(IClient.ListenerCommand command, net.roboconf.core.model.beans.Instance instance) Configures the listener for the exports from other agents.
void	listenToRequestsFromOtherAgents(IClient.ListenerCommand command, net.roboconf.core.model.beans.Instance instance) Configures the listener for requests from other agents.
void	listenToTheDm(IClient.ListenerCommand command) Configures the listener for messages from the DM.
void	openConnection() Opens a connection with the message server.
void	publishExports(net.roboconf.core.model.beans.Instance instance) Publishes the exports for a given instance.
void	publishExports(net.roboconf.core.model.beans.Instance instance, String facetOrComponentName) Publishes specific exports for a given instance.
void	requestExportsFromOtherAgents(net.roboconf.core.model.beans.Instance instance) Requests other agents to export their variables on the messaging server.
void	sendMessageToTheDm(Message message) Sends a message to the DM.
void	setApplicationName(String applicationName) Sets the application name.
void	setMessageQueue(LinkedBlockingQueue<Message> messageQueue) Sets the message queue where the client can store the messages to process.
void	setParameters(String messageServerIp, String messageServerUsername, String messageServerPassword) Sets the connection parameters.
void	setRootInstanceName(String rootInstanceName) Sets the name of the root instance associated with the agent.
void	unpublishExports(net.roboconf.core.model.beans.Instance instance) Un-publishes the exports for a given instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

THOSE_THAT_IMPORT

public static final String THOSE_THAT_IMPORT

See Also:

Constant Field Values

Constructor Detail

RabbitMqClientAgent

public RabbitMqClientAgent()

Method Detail

setParameters

public void setParameters(String messageServerIp,
                 String messageServerUsername,
                 String messageServerPassword)

Description copied from interface: IClient

Sets the connection parameters.

Specified by:

setParameters in interface IClient

Parameters:

messageServerIp - the IP address of the messaging server

messageServerUsername - the user name to connect to the server

messageServerPassword - the password to connect to the server

setMessageQueue

public void setMessageQueue(LinkedBlockingQueue<Message> messageQueue)

Description copied from interface: IClient

Sets the message queue where the client can store the messages to process.

Specified by:

setMessageQueue in interface IClient

Parameters:

messageQueue - the message queue

isConnected

public boolean isConnected()

Specified by:

isConnected in interface IClient

Returns:

true if the client is connected, false otherwise

setRootInstanceName

public void setRootInstanceName(String rootInstanceName)

Description copied from interface: IAgentClient

Sets the name of the root instance associated with the agent.

Specified by:

setRootInstanceName in interface IAgentClient

openConnection

public void openConnection()
                    throws IOException

Description copied from interface: IClient

Opens a connection with the message server.

Specified by:

openConnection in interface IClient

Throws:

IOException

closeConnection

public void closeConnection()
                     throws IOException

Description copied from interface: IClient

Closes the connection with the message server.

There is no need to check IClient.isConnected() before invoking this method.

Specified by:

closeConnection in interface IClient

Throws:

IOException

setApplicationName

public void setApplicationName(String applicationName)

Description copied from interface: IAgentClient

Sets the application name.

Specified by:

setApplicationName in interface IAgentClient

publishExports

public void publishExports(net.roboconf.core.model.beans.Instance instance)
                    throws IOException

Description copied from interface: IAgentClient

Publishes the exports for a given instance.

This method indicates to other instances that they can use the variables exported by THIS instance.

Specified by:

publishExports in interface IAgentClient

Parameters:

instance - the instance whose exports must be published

Throws:

IOException - if something went wrong

publishExports

public void publishExports(net.roboconf.core.model.beans.Instance instance,
                  String facetOrComponentName)
                    throws IOException

Description copied from interface: IAgentClient

Publishes specific exports for a given instance.

Specified by:

publishExports in interface IAgentClient

Parameters:

instance - the instance whose exports must be published

facetOrComponentName - the prefix of the variables to publish

Throws:

IOException - if something went wrong

unpublishExports

public void unpublishExports(net.roboconf.core.model.beans.Instance instance)
                      throws IOException

Description copied from interface: IAgentClient

Un-publishes the exports for a given instance.

This method indicates to other instances that the variables exported by THIS instance cannot be used anymore.

Specified by:

unpublishExports in interface IAgentClient

Parameters:

instance - the instance whose exports must be published

Throws:

IOException - if something went wrong

listenToRequestsFromOtherAgents

public void listenToRequestsFromOtherAgents(IClient.ListenerCommand command,
                                   net.roboconf.core.model.beans.Instance instance)
                                     throws IOException

Description copied from interface: IAgentClient

Configures the listener for requests from other agents.

Such requests aim at asking an agent to publish its exports. The agent will do so only if it exports a variable prefixed that is required by THIS instance.

Specified by:

listenToRequestsFromOtherAgents in interface IAgentClient

Parameters:

command - ListenerCommand#START to start listening, ListenerCommand#STOP to stop listening

instance - the instance that need exports from other agents

Throws:

IOException - if something went wrong

requestExportsFromOtherAgents

public void requestExportsFromOtherAgents(net.roboconf.core.model.beans.Instance instance)
                                   throws IOException

Description copied from interface: IAgentClient

Requests other agents to export their variables on the messaging server.

This should be called when a new instance is registered on the agent. It guarantees that any new instance can be notified about the instances located on other agents.

Specified by:

requestExportsFromOtherAgents in interface IAgentClient

Parameters:

instance - the instance that need exports from other agents

Throws:

IOException - if something went wrong

listenToExportsFromOtherAgents

public void listenToExportsFromOtherAgents(IClient.ListenerCommand command,
                                  net.roboconf.core.model.beans.Instance instance)
                                    throws IOException

Description copied from interface: IAgentClient

Configures the listener for the exports from other agents.

Specified by:

listenToExportsFromOtherAgents in interface IAgentClient

Parameters:

command - ListenerCommand#START to start listening, ListenerCommand#STOP to stop listening

instance - the instance that determine which exports must be listened to

Throws:

IOException - if something went wrong

sendMessageToTheDm

public void sendMessageToTheDm(Message message)
                        throws IOException

Description copied from interface: IClient

Sends a message to the DM.

Specified by:

sendMessageToTheDm in interface IClient

Parameters:

message - the message to send

Throws:

IOException - if something went wrong

listenToTheDm

public void listenToTheDm(IClient.ListenerCommand command)
                   throws IOException

Description copied from interface: IClient

Configures the listener for messages from the DM.

Specified by:

listenToTheDm in interface IClient

Parameters:

command - IClient.ListenerCommand.START to stop listening, IClient.ListenerCommand.STOP to stop listening

Throws:

IOException - if something went wrong