]> gerrit.simantics Code Review - simantics/platform.git/blobdiff - bundles/org.simantics.structural.synchronization/src/org/simantics/structural/synchronization/utils/MappingBase.java
Refactoring of simulator toolkit
[simantics/platform.git] / bundles / org.simantics.structural.synchronization / src / org / simantics / structural / synchronization / utils / MappingBase.java
diff --git a/bundles/org.simantics.structural.synchronization/src/org/simantics/structural/synchronization/utils/MappingBase.java b/bundles/org.simantics.structural.synchronization/src/org/simantics/structural/synchronization/utils/MappingBase.java
new file mode 100644 (file)
index 0000000..3c96a3f
--- /dev/null
@@ -0,0 +1,222 @@
+package org.simantics.structural.synchronization.utils;
+
+import java.io.PrintWriter;
+
+import gnu.trove.map.hash.THashMap;
+import gnu.trove.procedure.TObjectObjectProcedure;
+import gnu.trove.procedure.TObjectProcedure;
+import gnu.trove.set.hash.THashSet;
+
+/**
+ * The entry point to the mapping structure between Simantics database and a
+ * designated solver. It is used to synchronize changes from Simantics to the
+ * solver.
+ * 
+ * @author Hannu Niemistö
+ */
+abstract public class MappingBase<T extends ComponentBase<T>> {
+
+       abstract public T getConfiguration();
+    
+    /**
+     * Set of all components indexed by their UID.
+     */
+    transient protected THashMap<String, T> configurationByUid;
+    
+    /** 
+     * Set of components whose removal is delayed because they might
+     * have been moved somewhere else.
+     */
+    transient THashSet<T> pendingRemoval = new THashSet<T>();
+    
+    /**
+     * This is a structure that is used to return the state of the removed modules
+     * when the removal is undone.
+     */
+    public transient StateUndoContextBase undoContext;
+    
+    public transient ComponentFactory<T> componentFactory;
+    
+    /**
+     * The synchronization has processed all change sets before this change set 
+     * (excluding this change set).
+     * It means that next synchronization operation should start examining changes
+     * made in this revision and revisions after this.
+     */
+    public long currentRevision;
+    
+    /**
+     * Tells whether the uids in the components can be used
+     * in the synchronization. This is normally true, but
+     * may be set temporarily false when export/import:in 
+     * the model.
+     */
+    private boolean trustUids;
+
+    public MappingBase() {
+       this(null, -1L, false);
+    }
+
+    public MappingBase(T configuration, boolean trustUids) {
+       this(configuration, -1L, trustUids);
+    }
+
+    public MappingBase(T configuration, long currentRevision, boolean trustUids) {
+       undoContext = createUndoContext();
+       componentFactory = createComponentFactory();
+        if(trustUids)
+            createConfigurationById(configuration);
+        this.currentRevision = currentRevision;
+        this.trustUids = trustUids;
+    }
+    
+    abstract public StateUndoContextBase createUndoContext();
+    abstract public ComponentFactory<T> createComponentFactory();
+
+    protected void createConfigurationById(T configuration) {
+        THashMap<String, T> configurationByUid = new THashMap<String, T>();
+        browseConfiguration(configurationByUid, configuration);
+        this.configurationByUid = configurationByUid;
+    }
+
+    private void browseConfiguration(
+            THashMap<String, T> configurationByUid,
+            T configuration) {
+        configurationByUid.put(configuration.uid, configuration);
+        for(T child : configuration.getChildren()) {
+            browseConfiguration(configurationByUid, child);
+            child.parent = configuration;
+        }
+    }
+
+    public T detachOrCreateComponent(String uid) {
+        T result = configurationByUid.get(uid);
+        if(result == null) {
+            result = componentFactory.create(uid);
+            configurationByUid.put(uid, result);
+        }
+        else {
+            if(result.getParent() == null)
+                pendingRemoval.remove(result);
+            else
+                result.getParent().detachByUid(uid);
+        }
+        return result;
+    }
+
+    /**
+     * Marks that the component should be removed. The actual removal
+     * is delayed until the call of {@link #removePending} so that if the
+     * component is not actually removed but moved or renamed, we don't lose
+     * its state.
+     */
+    public void addPendingRemoval(T component) {
+        pendingRemoval.add(component);
+    }
+
+    public void printUidMap() {
+        printUidMap(new PrintWriter(System.out));
+    }
+
+    public void printUidMap(final PrintWriter out) {
+        out.println("Component tree");
+        out.print("    ");
+        getConfiguration().printConfiguration(out, 1);
+        if(configurationByUid != null) {
+            out.println("UIDs");
+            configurationByUid.forEachEntry(new TObjectObjectProcedure<String, T>() {
+                @Override
+                public boolean execute(String a, T b) {
+                    out.println("    " + a + " (" + b.solverComponentName + ", " + b.componentId + ", " + b.uid + ")");
+                    return true;
+                }
+            });
+        }
+    }
+
+    /**
+     * Removes the component recursively.
+     */
+    public void remove(final Solver solver, T component) {
+        if(configurationByUid != null)
+            configurationByUid.remove(component.uid);
+        if(component.getChildMap() != null)
+            component.getChildMap().forEachValue(new TObjectProcedure<T>() {
+                @Override
+                public boolean execute(T child) {
+                    remove(solver, child);
+                    return true;
+                }
+            });
+        if(component.componentId > 0 && !component.attached)
+            solver.remove(component.componentId);
+    }
+    
+    /**
+     * Saves undo state recursively
+     */
+    public void saveUndoState(final Solver solver, T component) {
+        if(component.getChildMap() != null)
+            component.getChildMap().forEachValue(new TObjectProcedure<T>() {
+                @Override
+                public boolean execute(T child) {
+                    saveUndoState(solver, child);
+                    return true;
+                }
+            });
+        else if(component.componentId > 0 && !component.attached)
+            undoContext.saveState(solver, component.componentId, component.uid);
+    }
+
+    /**
+     * Removes components that are marked pending with {@link #addPendingRemoval} method.
+     */
+    public void removePending(final Solver solver) {
+        pendingRemoval.forEach(new TObjectProcedure<T>() {
+            @Override
+            public boolean execute(T component) {
+                saveUndoState(solver, component);
+                return true;
+            }
+        });
+        pendingRemoval.forEach(new TObjectProcedure<T>() {
+            @Override
+            public boolean execute(T component) {
+                remove(solver, component);
+                return true;
+            }
+        });
+        pendingRemoval.clear();
+    }
+    
+    /**
+     * Changes the {@link #trustUids} flag.
+     */
+    public void setTrustUids(boolean trustUids) {
+        if(trustUids != this.trustUids) {
+            this.trustUids = trustUids;
+            if(trustUids) {
+                T configuration = getConfiguration();
+                if(configuration != null)
+                    createConfigurationById(configuration);
+            }
+        }
+        if(!trustUids)
+            configurationByUid = null;
+    }
+    
+    public boolean getTrustUids() {
+        return trustUids;
+    }
+
+    public void dispose() {
+        if (configurationByUid != null)
+            configurationByUid.clear();
+        pendingRemoval.clear();
+    }
+    
+    public boolean hasPendingRemovals() {
+        return !pendingRemoval.isEmpty();
+    }
+
+}