# Difference between revisions of "EMF Compare/GMF Notation model Comparison"

Line 1: | Line 1: | ||

− | The GMF diagram comparison | + | The GMF diagram comparison task can be splitted into four parts. First, we must be able to compare GMF Notation models, then we have to know how we handle the link with the comparison of the semantic model (i.e. the elements represented by the diagram). Third, we have to know how to integrate existing GMF editor within the EMF Compare editor. Finally, we have to know how to create generic markers on the diagram to give a feedback of the computed differences to the user. |

== Notation model comparison == | == Notation model comparison == | ||

− | The whole notation | + | Notation model comparison need its own MatchEngine and DiffEngine. The whole notation metamodel will not be taken into account. The difference computation will only occur on a subpart as depicted below: |

[[Image:gmf_notation_compare.png]] | [[Image:gmf_notation_compare.png]] | ||

− | The nodes and edges will be matched by their XMI IDs. Containment between nodes will be handled in a generic way (i.e. by the GenericMatchEngine). | + | The nodes and edges will be matched by their XMI IDs. Containment between nodes will be handled in a generic way (i.e. by the super class GenericMatchEngine). |

Only following differences will be computed: | Only following differences will be computed: | ||

Line 29: | Line 29: | ||

=== Merge === | === Merge === | ||

− | As a we don't know from the notation model how labels are build and from which feature(s) of the semantic model, the merge operation of labels modification must be applied on the notation model to trigger the appropriate underlying commands on the semantic model. This merger operation can be triggerred only if the label is editable (ask to the editpart of the view ''' | + | As a we don't know from the notation model how labels are build and from which feature(s) of the semantic model, the merge operation of labels modification must be applied on the notation model to trigger the appropriate underlying commands on the semantic model. This merger operation can be triggerred only if the label is editable (=> ask to the editpart of the view '''isEditModeEnabled()''') |

The merge of a move a node or an edge never triggers a merge on the semantic model, only on the graphical notation. The merge is a simple copy of values of bendpoints/layout constraints. | The merge of a move a node or an edge never triggers a merge on the semantic model, only on the graphical notation. The merge is a simple copy of values of bendpoints/layout constraints. | ||

Line 44: | Line 44: | ||

viewer_left.createControl(composite); | viewer_left.createControl(composite); | ||

viewer_left.getControl().setBackground(ColorConstants.listBackground); | viewer_left.getControl().setBackground(ColorConstants.listBackground); | ||

+ | |||

+ | The resize of the left/right/ancestor panes has to be handled gracefully like this: | ||

+ | |||

+ | viewer_left.getControl().setBounds(x, y, leftWidth, height); | ||

+ | viewer_right.getControl().setBounds(x + leftWidth + centerWidth, y, rightWidth, height); | ||

+ | |||

+ | === Initialization === | ||

+ | |||

+ | The left/right/ancestor viewers has to be initialized with a proper editing domain. This creation takes the resourceSet as input: | ||

+ | |||

+ | DiagramEditingDomainFactory.getInstance().createEditingDomain(resourceset); | ||

+ | |||

+ | Then, the viewers has to be configured like this: | ||

+ | |||

+ | viewer_left.setEditDomain(new DefaultEditDomain(null)); // GEF editDomain | ||

+ | viewer_left.setEditPartFactory(EditPartService.getInstance()); | ||

+ | viewer_left.setRootEditPart(new DiagramRootEditPart(diag_left.getMeasurementUnit())); | ||

+ | viewer_left.setContents(diag_left); // the diagram from the notation model | ||

+ | |||

+ | It is also possible to make the viewer uneditable by browsing all children of the rootEditPart of each viewer, but then, we will not be able to ask for the '''editability''' of views. It should be better to add a top layer that forbid the editing. | ||

== Markers for GMF diagrams == | == Markers for GMF diagrams == |

## Revision as of 09:22, 29 April 2011

The GMF diagram comparison task can be splitted into four parts. First, we must be able to compare GMF Notation models, then we have to know how we handle the link with the comparison of the semantic model (i.e. the elements represented by the diagram). Third, we have to know how to integrate existing GMF editor within the EMF Compare editor. Finally, we have to know how to create generic markers on the diagram to give a feedback of the computed differences to the user.

## Contents

## Notation model comparison

Notation model comparison need its own MatchEngine and DiffEngine. The whole notation metamodel will not be taken into account. The difference computation will only occur on a subpart as depicted below:

The nodes and edges will be matched by their XMI IDs. Containment between nodes will be handled in a generic way (i.e. by the super class GenericMatchEngine).

Only following differences will be computed:

- Addition / Removal of a node
- Addition / Removal of an edge
- Change of a Label on an edge or on a node (type id = 40xx)
- Move of a node within the diagram (with a configurable translation threshold for the move its location x/y).
- Move of an edge within the diagram (total number of bendpoints, change of bendpoints - sourceX, sourceY, targetX, targetY - and positions of the anchors).

## Link with the semantic comparison

For many cases, we need the semantic comparison to be done before the graphical one. The work on logical model integration should give us this facility by computing the differences of a whole resource set instead of just the current resource containing the notation model.

The link with the semantic comparison had to be provided for the labels. For each element of type.startsWith("40"), we have to get the text of the label et compare them. They are not stored directly into the notation model.

Move operations of Edge and Node never correspond to semantic change.

For addition and removal of nodes and edges, graphical differences may or may not corresponds to a semantic change. For instance, a graphical element may be removed because it has been hidden or deleted from the diagram. It does not correspond to a change in the semantic model. This graphical change does not have to be linked to a semantic change. In the other case, the addition or the removal of a node or an edge must match an addition or a deletion in the semantic model.

### Merge

As a we don't know from the notation model how labels are build and from which feature(s) of the semantic model, the merge operation of labels modification must be applied on the notation model to trigger the appropriate underlying commands on the semantic model. This merger operation can be triggerred only if the label is editable (=> ask to the editpart of the view **isEditModeEnabled()**)

The merge of a move a node or an edge never triggers a merge on the semantic model, only on the graphical notation. The merge is a simple copy of values of bendpoints/layout constraints.

Addition/Removal of node or edge trigger the merge of the semantic difference if it is associated to one, and the merge operation of the graphical difference otherwise. This merge operation consist of re-create the element if it has been deleted from the diagram, or to restor the hidden status of this view (View.isVisible())

## GMF editor integration within Comparison editor

The integration of GMF editor within the comparison editor has to be done through specific contentMergeViewer (org.eclipse.compare.contentMergeViewers extension point) and maybe a specific structureMergerViewer (org.eclipse.compare.structureMergeViewers extension point) to provide the separation between graphical differences and semantic differences.

The content merge viewer has to instantiate DiagramGraphicalViewer inside its **createControls()** method:

viewer_left = new DiagramGraphicalViewer(); viewer_left.createControl(composite); viewer_left.getControl().setBackground(ColorConstants.listBackground);

The resize of the left/right/ancestor panes has to be handled gracefully like this:

viewer_left.getControl().setBounds(x, y, leftWidth, height); viewer_right.getControl().setBounds(x + leftWidth + centerWidth, y, rightWidth, height);

### Initialization

The left/right/ancestor viewers has to be initialized with a proper editing domain. This creation takes the resourceSet as input:

DiagramEditingDomainFactory.getInstance().createEditingDomain(resourceset);

Then, the viewers has to be configured like this:

viewer_left.setEditDomain(new DefaultEditDomain(null)); // GEF editDomain viewer_left.setEditPartFactory(EditPartService.getInstance()); viewer_left.setRootEditPart(new DiagramRootEditPart(diag_left.getMeasurementUnit())); viewer_left.setContents(diag_left); // the diagram from the notation model

It is also possible to make the viewer uneditable by browsing all children of the rootEditPart of each viewer, but then, we will not be able to ask for the **editability** of views. It should be better to add a top layer that forbid the editing.