Package dk.gtz.graphedit.viewmodel

Class ViewModelDiff

java.lang.Object
dk.gtz.graphedit.viewmodel.ViewModelDiff
public class ViewModelDiff extends Object
Represents a difference between two graphs. A diff consists of deletions and additions of both vertices and edges. Note that if e.g. a vertex has changed an attribute it is considered deleted and a new value added.

  • Method Details

    • empty

      public static ViewModelDiff empty(String syntaxStyle)
      Create a new empty diff
      Parameters:
      syntaxStyle - The syntax style of the new diff
      Returns:
      A new empty diff

    • getVertexDeletions

      public List<ViewModelVertex> getVertexDeletions()
      Get the vertices that should be deleted.
      Returns:
      A list of viewmodel vertices.

    • getEdgeDeletions

      public List<ViewModelEdge> getEdgeDeletions()
      Get the edges that should be deleted.
      Returns:
      A list of viewmodel edges.

    • getVertexAdditions

      public List<ViewModelVertex> getVertexAdditions()
      Get the vertices that should be added.
      Returns:
      A list of viewmodel vertices.

    • getEdgeAdditions

      public List<ViewModelEdge> getEdgeAdditions()
      Get the edges that should be added.
      Returns:
      A list of viewmodel edges.

    • getSyntaxStyle

      public String getSyntaxStyle()
      Get the syntax style that this diff operates on.
      Returns:
      The syntax style name.

    • size

      public int size()
      Get the combined size of changes.
      Returns:
      The size of changes.

    • isEmpty

      public boolean isEmpty()
      Checks if the diff has no changes. This is useful for detecting if two graphs are excactly equal.
      Returns:
      True if no changes are present, otherwise false.

    • areComparable

      public static boolean areComparable(ViewModelProjectResource a, ViewModelProjectResource b)
      Checks if two resources are comparable and if a diff can be calculated.
      Parameters:
      a - The first project resource.
      b - The second project resource.
      Returns:
      True if the syntaxes are the same, otherwise false.

    • compare

      public static ViewModelDiff compare(ViewModelProjectResource a, ViewModelProjectResource b) throws UncomparableException
      Compare two resources and produce a diff.
      Parameters:
      a - The first project resource.
      b - The second project resource.
      Returns:
      A new diff that contains the changes needed to transform a to b
      Throws:
      UncomparableException - If the two resources aren't comparable.

    • apply

      public static void apply(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Apply the changes of a diff to the provided resource.
      Parameters:
      resource - The resource to apply the diff to.
      diff - The diff to apply to the resource.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • applyAdditiveOnly

      public static void applyAdditiveOnly(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Apply the changes of a diff to the provided resource, but only apply the additions.
      Parameters:
      resource - The resource to apply the diff to.
      diff - The diff to apply to the resource.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • applyCopy

      public static ViewModelProjectResource applyCopy(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Apply the changes of a diff to a copy of the provided resource and return the copy
      Parameters:
      resource - The resource to apply the diff to.
      diff - The diff to apply to the resource.
      Returns:
      A new copy of the resource with the changes applied.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • revert

      public static void revert(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Inversely apply the changes of a diff to the provided resource.
      Parameters:
      resource - The resource to revert the diff on.
      diff - The diff to revert on the resource.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • revertSubtractiveOnly

      public static void revertSubtractiveOnly(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Inversely apply the changes of a diff to the provided resource, but only apply the deletions.
      Parameters:
      resource - The resource to revert the diff on.
      diff - The diff to revert on the resource.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • revertCopy

      public static ViewModelProjectResource revertCopy(ViewModelProjectResource resource, ViewModelDiff diff) throws UncomparableException
      Inversely apply the changes of a diff to a copy of the provided resource and return the copy
      Parameters:
      resource - The resource to revert the diff on.
      diff - The diff to revert on the resource.
      Returns:
      A new copy of the resource with the changes reverted.
      Throws:
      UncomparableException - if the provided resource is not of the expected syntax.

    • equals

      public boolean equals(Object other)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object