de.saxsys.synchronizefx.core.metamodel

Class MetaModel

java.lang.Object

de.saxsys.synchronizefx.core.metamodel.MetaModel

public class MetaModel
extends Object

Generates and applies commands necessary to keep domain models synchronous.

Constructor Summary

Constructors

Constructor and Description
MetaModel(TopologyLayerCallback topology) Creates a MetaModel where the root object of the domain model is received from another node.
MetaModel(TopologyLayerCallback topology, Object root) Creates a MetaModel which serves a new domain model.

Method Summary

Methods

Modifier and Type	Method and Description
void	commandsForDomainModel(CommandsForDomainModelCallback callback) This method creates the commands necessary to reproduce the entire domain model.
void	execute(List<Command> commands) Executes commands to change the domain model of the user.

Methods inherited from class java.lang.Object

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

Constructor Detail

MetaModel

public MetaModel(TopologyLayerCallback topology)

Creates a MetaModel where the root object of the domain model is received from another node.

Parameters:

topology - used to interact with the lower layer which is probably represented by the class that called this constructor.

MetaModel

public MetaModel(TopologyLayerCallback topology,
         Object root)

Creates a MetaModel which serves a new domain model.

Parameters:

topology - see MetaModel(TopologyLayerCallback)

root - The root object of the domain model that should be served.

See Also:

MetaModel(TopologyLayerCallback)

Method Detail

execute

public void execute(List<Command> commands)

Executes commands to change the domain model of the user.

This method is not Thread-safe. All callers must make sure that this method is called sequentially e.g by using a single-thread executor. The thread in which this method is called will also be used to execute changes on JavaFX properties so clients that have bound the GUI to properties of the domain model should make sure that this method is called in the JavaFX GUI thread.

These commands have usually been created by an other instance of MetaModel in an other JVM which send them via TopologyLayerCallback.sendCommands(List) or produced them through commandsForDomainModel(CommandsForDomainModelCallback).

Parameters:

commands - The commands that should be executed.

commandsForDomainModel

public void commandsForDomainModel(CommandsForDomainModelCallback callback)

This method creates the commands necessary to reproduce the entire domain model.

The API of this method may looks a bit odd as the commands produced are returned via a callback instead of return but this is necessary to ensure that no updated are lost for newly connecting peers.

Make sure that commands you receive via TopologyLayerCallback.sendCommands(List) are not send to the peer you've requested this initial set of commands for before your callback is called. Make also sure that future calls of TopologyLayerCallback.sendCommands(List) will send the changes to this new peer before your callback returns.

It is guaranteed that your callback is only called once and that this call happens before commandsForDomainModel(CommandsForDomainModelCallback) returns.

Parameters:

callback - The callback that takes the commands.