net.roboconf.messaging.internal.client.test

Class TestClientDm

java.lang.Object

net.roboconf.messaging.internal.client.test.TestClientDm

All Implemented Interfaces:

IClient, IDmClient

public class TestClientDm
extends Object
implements IDmClient

A class to mock the messaging server and the IaaS.

Author:

Vincent Zurczak - Linagora, Pierre Bourret - Université Joseph Fourier

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
AtomicBoolean	connected
AtomicBoolean	failMessageSending
List<Message>	sentMessages

Constructor Summary

Constructors

Constructor and Description
TestClientDm()

Method Summary

Methods

Modifier and Type	Method and Description
void	closeConnection() Closes the connection with the message server.
void	deleteMessagingServerArtifacts(net.roboconf.core.model.beans.Application application) Deletes all the server artifacts related to this application.
String	getMessageServerIp()
String	getMessageServerPassword()
String	getMessageServerUsername()
boolean	isConnected()
void	listenToAgentMessages(net.roboconf.core.model.beans.Application application, IClient.ListenerCommand command) Configures the listener for messages sent by agents.
void	listenToTheDm(IClient.ListenerCommand command) Configures the listener for messages from the DM.
void	openConnection() Opens a connection with the message server.
void	propagateAgentTermination(net.roboconf.core.model.beans.Application application, net.roboconf.core.model.beans.Instance rootInstance) Propagates to all the agents the fact that a given agent is not here anymore.
void	sendMessageToAgent(net.roboconf.core.model.beans.Application application, net.roboconf.core.model.beans.Instance instance, Message message) Sends a message to an agent.
void	sendMessageToTheDm(Message msg) Sends a message to the DM.
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.

Methods inherited from class java.lang.Object

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

Field Detail

sentMessages

public final List<Message> sentMessages

connected

public AtomicBoolean connected

failMessageSending

public AtomicBoolean failMessageSending

Constructor Detail

TestClientDm

public TestClientDm()

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

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

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

sendMessageToAgent

public void sendMessageToAgent(net.roboconf.core.model.beans.Application application,
                      net.roboconf.core.model.beans.Instance instance,
                      Message message)
                        throws IOException

Description copied from interface: IDmClient

Sends a message to an agent.

Specified by:

sendMessageToAgent in interface IDmClient

Parameters:

application - the application associated with the given agent

instance - an instance managed on the agent (used to find the root instance name)

message - the message to send

Throws:

IOException - if something went wrong

listenToAgentMessages

public void listenToAgentMessages(net.roboconf.core.model.beans.Application application,
                         IClient.ListenerCommand command)
                           throws IOException

Description copied from interface: IDmClient

Configures the listener for messages sent by agents.

Specified by:

listenToAgentMessages in interface IDmClient

Parameters:

application - the application associated with the given agents

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

Throws:

IOException - if something went wrong

sendMessageToTheDm

public void sendMessageToTheDm(Message msg)
                        throws IOException

Description copied from interface: IClient

Sends a message to the DM.

Specified by:

sendMessageToTheDm in interface IClient

Parameters:

msg - 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

deleteMessagingServerArtifacts

public void deleteMessagingServerArtifacts(net.roboconf.core.model.beans.Application application)
                                    throws IOException

Description copied from interface: IDmClient

Deletes all the server artifacts related to this application.

This method must be called when ALL the agents have closed their connection and BEFORE the DM's connection is closed.

Specified by:

deleteMessagingServerArtifacts in interface IDmClient

Parameters:

application - the application whose messaging artifacts must be deleted

Throws:

IOException - if something went wrong

isConnected

public boolean isConnected()

Specified by:

isConnected in interface IClient

Returns:

true if the client is connected, false otherwise

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

propagateAgentTermination

public void propagateAgentTermination(net.roboconf.core.model.beans.Application application,
                             net.roboconf.core.model.beans.Instance rootInstance)
                               throws IOException

Description copied from interface: IDmClient

Propagates to all the agents the fact that a given agent is not here anymore.

Generally, when an agent undeploys something, it sends notifications to other agents, which themselves invoke their "update" method. However, when the DM terminates a virtual machine, the agent does not always send these notifications to the other agents. Therefore, the DM has to do it. Since it has the application model, it can do it.

The DM should notify all the potential agents that may be concerned. Roughly, it is equivalent to unpublishing all the exports of all the instances that were available on the terminated machine.

Specified by:

propagateAgentTermination in interface IDmClient

Parameters:

application - the application the agent is associated with

rootInstance - the root instance associated with the agent

Throws:

IOException - if something went wrong

getMessageServerIp

public String getMessageServerIp()

Returns:

the messageServerIp

getMessageServerUsername

public String getMessageServerUsername()

Returns:

the messageServerUsername

getMessageServerPassword

public String getMessageServerPassword()

Returns:

the messageServerPassword