EMF Compare — How To Open Compare Dialog

Version 3.1.0.201506080946

Table of Contents

  1. Preparing the input
  2. Preparing the configuration
    1. ComparisonEditorInput
    2. ComparisonScopeEditorInput
  3. Opening the compare UI
  4. End-to-end examples
    1. With pre-computed comparison
    2. With a comparison scope

This is only valid since release 2.1M4.

In this page you will learn how to open a dialog displaying the result of a comparison.

Preparing the input

The first thing to do is to choose an EMF Compare sub-implementation of the class of CompareEditorInput.

Two implementations are provided:

Both are available from the org.eclipse.emf.compare.ide.ui plug-in, in the package org.eclipse.emf.compare.ide.ui.internal.editor. This is still provisional API so we may break it any time.

Preparing the configuration

When instantiating an EMF Compare specific implementation of CompareEditorInput, you have to give it at least three paramaters:

CompareConfiguration configuration = new CompareConfiguration();

// ancestor may be null
ICompareEditingDomain editingDomain = EMFCompareEditingDomain.create(left, right, ancestor); 

You can even give your own command(s) stack(s) if you need to know about executed merge commands.

AdapterFactory adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);

Depending on the choosen sub-implementation of CompareEditorInput, you may need to provide additional parameters.

ComparisonEditorInput

You must provide a Comparison object, the result of the comparison computation of EMFCompare.

EMFCompare comparator = EMFCompare.builder().build();
Comparison comparison = comparator.compare(EMFCompare.createDefaultScope(left, right, ancestor));

ComparisonScopeEditorInput

You must provide the comparator (instance of EMFCompare) and the scope of the comparison.

EMFCompare comparator = EMFCompare.builder().build();
IComparisonScope scope = EMFCompare.createDefaultScope(left, right, ancestor);

Opening the compare UI

Then, you can call the black magic method from Eclipse Compare framework. You have two choices. You may either open the compare UI wihtin a modal dialog or within an editor. Just call one of the two following methods:

End-to-end examples

With pre-computed comparison

public void compare(Notifier left, Notifier right, Notifier ancestor) {
    EMFCompare comparator = EMFCompare.builder().build();
    Comparison comparison = comparator.compare(EMFCompare.createDefaultScope(left, right, ancestor));

    ICompareEditingDomain editingDomain = EMFCompareEditingDomain.create(left, right, ancestor);
    AdapterFactory adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);
    CompareEditorInput input = new ComparisonEditorInput(new CompareConfiguration(), comparison, editingDomain, adapterFactory);

    CompareUI.openCompareDialog(input); // or CompareUI.openCompareEditor(input);
}

With a comparison scope

public void compare(Notifier left, Notifier right, Notifier ancestor) {
    EMFCompare comparator = EMFCompare.builder().build();
    IComparisonScope scope = EMFCompare.createDefaultScope(left, right, ancestor));

    ICompareEditingDomain editingDomain = EMFCompareEditingDomain.create(left, right, ancestor);
    AdapterFactory adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);
    CompareEditorInput input = new ComparisonScopeEditorInput(new CompareConfiguration(), 
        editingDomain, adapterFactory, comparator, scope);

    CompareUI.openCompareDialog(input); // or CompareUI.openCompareEditor(input);
}

Part of EMF Compare Documentation

Version 3.1.0.201506080946