org.universAAL.middleware.container.pojo.dummyManagers

Class DummySpaceManager

java.lang.Object

org.universAAL.middleware.container.pojo.dummyManagers.DummySpaceManager

All Implemented Interfaces:

Manager, SpaceManager

public class DummySpaceManager
extends Object
implements SpaceManager

Author:

amedrano

Field Summary

Fields inherited from interface org.universAAL.middleware.managers.api.SpaceManager

COMUNICATION_TIMEOUT_KEY, COMUNICATION_TIMEOUT_VALUE, DEFAULT_PEER_ROLE, PEER_ID_FILE

Constructor Summary

Constructors

Constructor and Description
DummySpaceManager(PeerCard myCard)

Method Summary

Modifier and Type	Method and Description
void	addSpaceListener(SpaceListener arg0) Add a new Space listener.
void	dispose() Release all the resources
Map<String,SpaceDescriptor>	getManagedSpaces() This method return a map of Space managed by this MW instance
MatchingResult	getMatchingPeers(Map<String,Serializable> arg0) A method for identifying a possible set of Peer in the space that can be used for installing a part of the universAAL application. The matching algorithm returns only the Peer of the space that match the following rules For each key of the Map with null value, an attribute with any value must be available on the matching Peer For each key of the Map with a not null value, an attribute with same value must be available on the matching Peer.
PeerCard	getMyPeerCard() This method returns the PeerCard of the current MW instance
Map<String,Serializable>	getPeerAttributes(List<String> arg0, PeerCard arg1)
Map<String,PeerCard>	getPeers() This method return the list of neighborhood peers joined to the current Space. NOTE: The list does not contains the invoker
SpaceDescriptor	getSpaceDescriptor() This method returns the SpaceDescriptor of the Space where the MW belongs to or null if the mw instance does not join to any Space.
Set<SpaceCard>	getSpaces() This method returns the list of Space discovered
boolean	init() Initialize the Space Manager
void	join(SpaceCard arg0) method to join an existing Space according the configuration file: -to configure the peering channel -to send a join request -to receive the join response -to get the SpaceDescriptor -to configure the communication channels
void	leaveSpace(SpaceDescriptor arg0) Method used to leave an Space
void	loadConfigurations(Dictionary arg0) This method sets all the configurations for the SpaceManager
void	removeSpaceListener(SpaceListener arg0) Remove a Space Listener

Methods inherited from class java.lang.Object

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

Constructor Detail

DummySpaceManager

public DummySpaceManager(PeerCard myCard)

Parameters:

myCard -

Method Detail

dispose

public void dispose()

Description copied from interface: Manager

Release all the resources

Specified by:

dispose in interface Manager

init

public boolean init()

Description copied from interface: Manager

Initialize the Space Manager

Specified by:

init in interface Manager

Returns:

true if the initialization is completed, false otherwise

loadConfigurations

public void loadConfigurations(Dictionary arg0)

Description copied from interface: Manager

This method sets all the configurations for the SpaceManager

Specified by:

loadConfigurations in interface Manager

Parameters:

arg0 - Dictionary of configurations

addSpaceListener

public void addSpaceListener(SpaceListener arg0)

Description copied from interface: SpaceManager

Add a new Space listener.

Specified by:

addSpaceListener in interface SpaceManager

getSpaceDescriptor

public SpaceDescriptor getSpaceDescriptor()

Description copied from interface: SpaceManager

This method returns the SpaceDescriptor of the Space where the MW belongs to or null if the mw instance does not join to any Space.

Specified by:

getSpaceDescriptor in interface SpaceManager

Returns:

SpaceDescriptor

getSpaces

public Set<SpaceCard> getSpaces()

Description copied from interface: SpaceManager

This method returns the list of Space discovered

Specified by:

getSpaces in interface SpaceManager

Returns:

Set of Space found

getManagedSpaces

public Map<String,SpaceDescriptor> getManagedSpaces()

Description copied from interface: SpaceManager

This method return a map of Space managed by this MW instance

Specified by:

getManagedSpaces in interface SpaceManager

Returns:

getMatchingPeers

public MatchingResult getMatchingPeers(Map<String,Serializable> arg0)

Description copied from interface: SpaceManager

A method for identifying a possible set of Peer in the space that can be used for installing a part of the universAAL application.
The matching algorithm returns only the Peer of the space that match the following rules

• For each key of the Map with null value, an attribute with any value must be available on the matching Peer
• For each key of the Map with a not null value, an attribute with same value must be available on the matching Peer. The #equals(Object) is used for checking if the value are the same
Please consider the following example:

• The space contains four peer: A, B, C, D, and E
• The attributes of the peer A are { container=Foo, tool=OSGi, version=3.0 }
• The attributes of the peer B are { container=Karaf, tool=Bar, version=1.0 }
• The attributes of the peer C are { container=Karaf, tool=OSGi, version=3.0 }
• The attributes of the peer D are { container=Karaf, tool=OSGi }
• The attributes of the peer E are { container=Karaf, tool=OSGi, version=2.5 }
• The Map filter is set to { container=Karaf, tool=OSGI, version=null }
The MatchingResult will contain the peers C and E, while the other were discarded because
• peer A is skipped because container=Foo, but container=Karaf was searched
• peer B is skipped because tool=Bar, but tool=OSGi was searched
• peer D is skipped because the attribute version is missing

Specified by:

getMatchingPeers in interface SpaceManager

Parameters:

arg0 - a Map that contains a pair of String as Key and Object as value which will be used for looking for matching among the one available on the space

Returns:

MatchingResult representing the filtering result

getMyPeerCard

public PeerCard getMyPeerCard()

Description copied from interface: SpaceManager

This method returns the PeerCard of the current MW instance

Specified by:

getMyPeerCard in interface SpaceManager

Returns:

PeerCard

getPeerAttributes

public Map<String,Serializable> getPeerAttributes(List<String> arg0,
                                                  PeerCard arg1)

Specified by:

getPeerAttributes in interface SpaceManager

Parameters:

arg0 - The list of attribute to get value,

arg1 - PeerCard the peer card that identifies the peer that we want to read attribute from

Returns:

a Map with the pair String, Serializable representing the attribute requested along with its value.

getPeers

public Map<String,PeerCard> getPeers()

Description copied from interface: SpaceManager

This method return the list of neighborhood peers joined to the current Space.
NOTE: The list does not contains the invoker

Specified by:

getPeers in interface SpaceManager

Returns:

Map of peers: peerID, PeerCard

join

public void join(SpaceCard arg0)

Description copied from interface: SpaceManager

method to join an existing Space according the configuration file: -to configure the peering channel -to send a join request -to receive the join response -to get the SpaceDescriptor -to configure the communication channels

Specified by:

join in interface SpaceManager

leaveSpace

public void leaveSpace(SpaceDescriptor arg0)

Description copied from interface: SpaceManager

Method used to leave an Space

Specified by:

leaveSpace in interface SpaceManager

removeSpaceListener

public void removeSpaceListener(SpaceListener arg0)

Description copied from interface: SpaceManager

Remove a Space Listener

Specified by:

removeSpaceListener in interface SpaceManager