org.ginsim.core.graph.objectassociation

Class ObjectAssociationManager

java.lang.Object

org.ginsim.core.graph.objectassociation.ObjectAssociationManager

public class ObjectAssociationManager
extends Object

The association manager can be used as proxy to retrieve or create associated objects. It loads all known specific managers and maintains the list of objects associated to all graphs.

Author:

Lionel Spinelli, Aurelien Naldi

Method Summary

Modifier and Type	Method and Description
void	addObject(Graph graph, String key, Object obj) Allow to associate objects with a graph to retrieve them later.
void	fireUserUpdate(Graph<?,?> graph, String oldKey, String newKey) Signal that a data user has been updated (removed or renamed)
void	fireUserUpdate(Graph<?,?> graph, String prefix, String oldKey, String newKey) Signal that a data user has been updated (removed or renamed)
ServiceClassInfo[]	getDataManagerInfo(Class graphType)
static ObjectAssociationManager	getInstance()
Collection<Map.Entry<Class,List<GraphAssociatedObjectManager>>>	getManagedClasses() Give access to the list of classes for which object managers are registered
Object	getObject(Graph graph, String key, boolean create) Allow to associate objects with a graph to retrieve them later.
GraphAssociatedObjectManager	getObjectManager(Class graph_class, String key) Give access to the Object manager in charge of the given object
GraphAssociatedObjectManager	getObjectManager(String key) Give access to the Object manager in charge of the given object
List<GraphAssociatedObjectManager>	getObjectManagerList() Give access to the list of registered object managers that are not associated with a graph class
List<GraphAssociatedObjectManager>	getObjectManagerList(Class graph_class) Give access to the list of registered object managers for the given graph class
void	removeAllObjects(Graph graph) Remove all references from associated objects
void	removeObject(Graph graph, String key) remove an object previously associated to a graph with addObject(Object, Object).

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ObjectAssociationManager getInstance()

fireUserUpdate

public void fireUserUpdate(Graph<?,?> graph,
                           String prefix,
                           String oldKey,
                           String newKey)

Signal that a data user has been updated (removed or renamed)

Parameters:

graph - graph to which the user was associated

prefix - prefix to add before the IDs, can be null

oldKey - old ID under which the user was known

newKey - new ID, or null if it was removed

fireUserUpdate

public void fireUserUpdate(Graph<?,?> graph,
                           String oldKey,
                           String newKey)

Signal that a data user has been updated (removed or renamed)

Parameters:

graph - graph to which the user was associated

oldKey - old ID under which the user was known

newKey - new ID, or null if it was removed

getObjectManagerList

public List<GraphAssociatedObjectManager> getObjectManagerList()

Give access to the list of registered object managers that are not associated with a graph class

Returns:

the list of registered object managers

getManagedClasses

public Collection<Map.Entry<Class,List<GraphAssociatedObjectManager>>> getManagedClasses()

Give access to the list of classes for which object managers are registered

Returns:

the set of class associated to specialised object managers

getObjectManagerList

public List<GraphAssociatedObjectManager> getObjectManagerList(Class graph_class)

Give access to the list of registered object managers for the given graph class

Returns:

the list of registered object managers

getObjectManager

public GraphAssociatedObjectManager getObjectManager(String key)

Give access to the Object manager in charge of the given object

Returns:

the Object manager in charge of the given object, null if no Manager is defined for this object

getObjectManager

public GraphAssociatedObjectManager getObjectManager(Class graph_class,
                                                     String key)

Give access to the Object manager in charge of the given object

Returns:

the Object manager in charge of the given object, null if no Manager is defined for this object

getObject

public Object getObject(Graph graph,
                        String key,
                        boolean create)

Allow to associate objects with a graph to retrieve them later. this (and addObject(key, obj)) makes it easy.

Parameters:

key -

create - if true, a non-defined object will be created

Returns:

the associated object

See Also:

addObject(Graph, String, Object)

addObject

public void addObject(Graph graph,
                      String key,
                      Object obj)

Allow to associate objects with a graph to retrieve them later.

Parameters:

key -

obj -

See Also:

getObject(Graph, String, boolean), removeObject(Graph, String)

removeObject

public void removeObject(Graph graph,
                         String key)

remove an object previously associated to a graph with addObject(Object, Object).

Parameters:

key -

See Also:

getObject(Graph, String, boolean), addObject(Graph, String, Object)

removeAllObjects

public void removeAllObjects(Graph graph)

Remove all references from associated objects

Parameters:

graph -

getDataManagerInfo

public ServiceClassInfo[] getDataManagerInfo(Class graphType)