Migration Guide

From 0.4 to 0.5

• ViewerInitializer has been removed: all creation and initialization of viewers is performed using ViewerFactory (src); its API has been revised and simplified.
• the packages factories and builders have been removed and their classes have been moved to other packages. If you get compiler errors, a simple "Organize Imports" should fix the imports. If you use the DSL a simple regeneration should fix things.
• IViewerMouseListener has been moved from the listeners package to the viewers package.
• classes in editor.outline have been moved into editors package.
• The creation of caption labels for forms and dialogs has slightly changed, concerning the default behavior (https://bugs.eclipse.org/bugs/show_bug.cgi?id=472691): we take the text from IItemPropertyDescriptor (src) if the EObject provides it. (This does not happen for table column headers, since we don't have any EObject when we build the table columns). If you used to call this method on a FormFeatureCaptionProvider (src) or DialogFeatureCaptionProvider (src)

  public Label getLabel(Composite parent, EClass eClass, EStructuralFeature feature)
  

  be warned that this method has changed its signature into

  public Label getLabel(Composite parent, EObject o, EStructuralFeature feature)
  

  and of course also its semantics, since you need to pass an EObject not its EClass.
• a new method is available in EditingMenuBuilder (src), actionChange: If you want to implement more complex menu commands that do not only add elements to a container, you can use the method actionChange, specifying the label for the menu, the model's element that will be affected by the changes specified as a lambda expression (the third argument). The lambda expression will also get the specified model's element as argument. (This is related to https://bugs.eclipse.org/bugs/show_bug.cgi?id=475188). Please also have a look at the updated documentation of section Contextual Menu: the already existing actionAdd should be used with care, since it might leave the model with dangling references -- with that respect we also updated the first example First Example, so that it uses actionChange to implement correctly what we used to achieve with actionAdd.
• Adding context menu to a viewer has been extremely simplified (https://bugs.eclipse.org/bugs/show_bug.cgi?id=455727): A context menu can be added to any StructuredViewer by using an injected ViewerContextMenuHelper (src). This provides some methods for adding the context menu

  @Inject ViewerContextMenuHelper contextMenuHelper;
  (...)
  
  // simplest form
  contextMenuHelper.addViewerContextMenu(viewer);
  
  // if you have an AdapterFactoryEditingDomain already
  contextMenuHelper.addViewerContextMenu(viewer, editingDomain);
  
  // if you're inside an IWorkbenchPart
  contextMenuHelper.addViewerContextMenu(viewer, editingDomain, part);
  

• Drag and drop support has been separated from context menu support (https://bugs.eclipse.org/bugs/show_bug.cgi?id=475914): thus, adding context menu does NOT automatically add drag and drop. Drag and drop can be added to any StructuredViewer by using an injected ViewerDragAndDropHelper (src), using its methods addDragAndDrop.
• Saveable table views and table views reacting on selection do not require an implementation of the method getContents(), which has also been removed from the API, from the Configurator (src) methods, and from the configurator section in the DSL: contents retrieval is completely delegated to the new TableViewerContentProvider (src), whose default implementation is able to automatically retrieve all the contents of a given type (i.e., EClass) automatically. The DSL provides the new tableViewerContentProvider specification, see the new section Table Viewer Content Provider.
• Similarly, table views reacting on selection do not require an implementation of the method getEStructuralFeature(): they require an implementation of getEClass() which specifies the type of the objects to be shown in the table. getEStructuralFeature() has also been removed from the API, from the Configurator (src) methods, and from the configurator section in the DSL: contents retrieval is not performed using a feature (which is limitative): it is completely delegated to the new TableViewerContentProvider (src), whose default implementation is able to automatically retrieve all the contents of a given type (i.e., EClass) automatically.

From 0.3 to 0.4

• EmptyResourceInitializer has been removed: you should now use ResourceManager (src), see section Resource Manager
• ResourceSaveManager has been removed: you should now use ResourceSaveStrategy (src), see section Resource Save Strategy
• Project wizards have been redesigned: they generate a module.parsley that uses the configurator for specifying required information (see section Configurator and the updated first example, section First Example)