de.saxsys.synchronizefx.core.metamodel

Class WeakObjectRegistry

java.lang.Object

de.saxsys.synchronizefx.core.metamodel.WeakObjectRegistry

public class WeakObjectRegistry
extends Object

Maps arbitrary objects to UUID without storing hard references to them.

Objects in this registry that have no hard references to them in some other place may be removed from this registry at any time.

Constructor Summary

Constructors

Constructor and Description
WeakObjectRegistry()

Method Summary

Methods

Modifier and Type	Method and Description
Optional<Object>	getById(UUID id) Returns the object that is identified by an id.
Object	getByIdOrFail(UUID id) Returns the object that is identified by an id.
Optional<UUID>	getId(Object object) Returns the id for an object.
UUID	getIdOrFail(Object object) Returns the id for an object.
UUID	registerIfUnknown(Object object) Registers an object in the meta model if it is not already registered.
void	registerObject(Object object, UUID id) Registers an object in this model identified by a pre existing id.

Methods inherited from class java.lang.Object

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

Constructor Detail

WeakObjectRegistry

public WeakObjectRegistry()

Method Detail

getById

public Optional<Object> getById(UUID id)

Returns the object that is identified by an id.

Parameters:

id - The id of the object that should be returned.

Returns:

The object if one is registered by this id or an empty Optional if not.

getByIdOrFail

public Object getByIdOrFail(UUID id)
                     throws ObjectToIdMappingException

Returns the object that is identified by an id.

Parameters:

id - The id of the object that should be returned.

Returns:

The object if one is registered by this id.

Throws:

ObjectToIdMappingException - When no object with the given id is registered.

getId

public Optional<UUID> getId(Object object)

Returns the id for an object.

Parameters:

object - The object thats id should be returned.

Returns:

The id of this object if it has an id assigned and an empty Optional if not.

getIdOrFail

public UUID getIdOrFail(Object object)
                 throws ObjectToIdMappingException

Returns the id for an object.

Parameters:

object - The object thats id should be returned.

Returns:

The id of this object if it has an id assigned.

Throws:

ObjectToIdMappingException - When no id for this object has been assigned.

registerIfUnknown

public UUID registerIfUnknown(Object object)

Registers an object in the meta model if it is not already registered.

Parameters:

object - The object to register.

Returns:

The id of the object. It doesn't matter if the object was just registered or already known.

registerObject

public void registerObject(Object object,
                  UUID id)

Registers an object in this model identified by a pre existing id.

Parameters:

object - The object to register.

id - The id by which this object is identified.