Recent changes to EMFEditOverview

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 21:22:50 -0000

--- v8
+++ v9
@@ -98,7 +98,7 @@
 Like content providers, changes in label behavior can be made by subclassing `AdapterFactoryLabelProvider` and/or changes to item providers.
 





-## Property Sheet ## 
+## Property Sheet ##
 ***
 The property sheet is an Eclipse viewer which specializes in allowing the user to retrieve and edit modeled object properties.  The property sheet, `propertySheetPage`, is an instance of the Eclipse UI object [PropertySheetPage](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/PropertySheetPage.html) that uses an `AdapterFactoryContentProvider` acting as an [IPropertySourceProvider](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySourceProvider.html) to retrieve an [IPropertySource](http://help.eclipse.org/help33/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySource.html) corresponding to a specific EMF object.  The `IPropertySource` (a wrapper for the UI independent [IItemPropertySource](http://download.eclipse.org/modeling/emf/emf/javadoc/2.5.0/org/eclipse/emf/edit/provider/IItemPropertySource.html), which the item providers implement) is used to retrieve the properties (i.e. the contents of the object) and a list of [IPropertyDescriptor](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertyDescriptor.html)s that contain the ID and property labels of the EMF Object.

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 21:22:14 -0000

--- v7
+++ v8
@@ -20,17 +20,17 @@

 ### Setting a Content Provider for a Viewer in REALEditor.java ###

-:::java
-public void createPages() {
-
-...
-    // This is the page for the tree viewer
-    //
-    {
-      ...
-      treeViewer.setContentProvider(new AdapterFactoryContentProvider(adapterFactory));
-    }
-...
+    :::java
+    public void createPages() {
+    
+    ...
+        // This is the page for the tree viewer
+        //
+        {
+          ...
+          treeViewer.setContentProvider(new AdapterFactoryContentProvider(adapterFactory));
+        }
+    ...

@@ -39,12 +39,12 @@
 

  
 In REALEditor.java code:

-:::java
-protected void initializeEditingDomain() {
-
-    // Create an adapter factory that yields item providers.
-    //
-    adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);
+    :::java
+    protected void initializeEditingDomain() {
+    
+        // Create an adapter factory that yields item providers.
+        //
+        adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);

     adapterFactory.addAdapterFactory(new ResourceItemProviderAdapterFactory());
     adapterFactory.addAdapterFactory(new RealItemProviderAdapterFactory());
@@ -70,17 +70,17 @@

 ### Setting a Label Provider for a Viewer in REALEditor.java ###

-:::java
-public void createPages() {
-
-...
-    // This is the page for the tree viewer
-    //
-    {
-      ...
-      treeViewer.setLabelProvider(new AdapterFactoryLabelProvider(adapterFactory));
-    }
-...
+    :::java
+    public void createPages() {
+    
+    ...
+        // This is the page for the tree viewer
+        //
+        {
+          ...
+          treeViewer.setLabelProvider(new AdapterFactoryLabelProvider(adapterFactory));
+        }
+    ...

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 14:50:20 -0000

--- v6
+++ v7
@@ -119,7 +119,7 @@
  * [ItemProviderAdapter](http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ItemProviderAdapter.html)
 





-## Sauce Codes ##
+## Source Code ##
 ***
  * [AdapterFactoryContentProvider](http://kickjava.com/src/org/eclipse/emf/edit/ui/provider/AdapterFactoryContentProvider.java.htm)
  * [AdapterFactoryLabelProvider](http://kickjava.com/src/org/eclipse/emf/edit/ui/provider/AdapterFactoryLabelProvider.java.htm)

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 01:41:43 -0000

--- v5
+++ v6
@@ -20,16 +20,18 @@

 ### Setting a Content Provider for a Viewer in REALEditor.java ###

-    :::java
-    public void createPages() {
-    ...
+:::java
+public void createPages() {
+
+...
     // This is the page for the tree viewer
     //
     {
       ...
       treeViewer.setContentProvider(new AdapterFactoryContentProvider(adapterFactory));
     }
-    ...
+...
+

 ### `AdapterFactoryContentProvider` and `adapterFactory` ###
@@ -37,12 +39,13 @@
 

  
 In REALEditor.java code:

-    :::java
-    protected void initializeEditingDomain() {
+:::java
+protected void initializeEditingDomain() {

     // Create an adapter factory that yields item providers.
     //
     adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);
+
     adapterFactory.addAdapterFactory(new ResourceItemProviderAdapterFactory());
     adapterFactory.addAdapterFactory(new RealItemProviderAdapterFactory());
     adapterFactory.addAdapterFactory(new ReflectiveItemProviderAdapterFactory());
@@ -67,17 +70,19 @@

 ### Setting a Label Provider for a Viewer in REALEditor.java ###

-    :::java
-    public void createPages() {
+:::java
+public void createPages() {

-    ...
+...
     // This is the page for the tree viewer
     //
     {
       ...
       treeViewer.setLabelProvider(new AdapterFactoryLabelProvider(adapterFactory));
     }
-    ...
+...
+
+

 ### `AdapterFactoryLabelProvider` and `adapterFactory` ###
@@ -93,7 +98,7 @@
 Like content providers, changes in label behavior can be made by subclassing `AdapterFactoryLabelProvider` and/or changes to item providers.
 





-## Property Sheet ##
+## Property Sheet ## 
 ***
 The property sheet is an Eclipse viewer which specializes in allowing the user to retrieve and edit modeled object properties.  The property sheet, `propertySheetPage`, is an instance of the Eclipse UI object [PropertySheetPage](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/PropertySheetPage.html) that uses an `AdapterFactoryContentProvider` acting as an [IPropertySourceProvider](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySourceProvider.html) to retrieve an [IPropertySource](http://help.eclipse.org/help33/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySource.html) corresponding to a specific EMF object.  The `IPropertySource` (a wrapper for the UI independent [IItemPropertySource](http://download.eclipse.org/modeling/emf/emf/javadoc/2.5.0/org/eclipse/emf/edit/provider/IItemPropertySource.html), which the item providers implement) is used to retrieve the properties (i.e. the contents of the object) and a list of [IPropertyDescriptor](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertyDescriptor.html)s that contain the ID and property labels of the EMF Object.

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 01:38:42 -0000

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 01:37:12 -0000

EMFEditOverview modified by Tom Swain

Tom Swain — Fri, 08 Nov 2013 01:27:03 -0000

--- v2
+++ v3
@@ -33,7 +33,7 @@

 ### `AdapterFactoryContentProvider` and `adapterFactory` ###
-An [AdapterFactoryContentProvider](http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/ui/provider/AdapterFactoryContentProvider.html) serves as a wrapper for an `AdapterFactory`, specifically [adapterFactory] in the code.  The `adapterFactory` is an instance of a [ComposedAdapterFactory](http://publib.boulder.ibm.com/infocenter/ratdevz/v7r5/topic/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ComposedAdapterFactory.html) which contains a [ResourceItemAdapterFactory](http://download.eclipse.org/modeling/emf/emf/javadoc/2.4.3/org/eclipse/emf/edit/provider/resource/ResourceItemProviderAdapterFactory.html), a `RealItemProviderAdapterFactory`, and a [ReflectiveItemProviderAdapterFactory](AdapterFactory)(http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ReflectiveItemProviderAdapterFactory.html).  The `RealItemProviderAdapterFactory` creates/contains all of the ItemProviders needed for our EMF model objects (the others are not of great importance right now).
+An [AdapterFactoryContentProvider](http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/ui/provider/AdapterFactoryContentProvider.html) serves as a wrapper for an `AdapterFactory`, specifically [adapterFactory](AdapterFactory) in the code.  The `adapterFactory` is an instance of a [ComposedAdapterFactory](http://publib.boulder.ibm.com/infocenter/ratdevz/v7r5/topic/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ComposedAdapterFactory.html) which contains a [ResourceItemAdapterFactory](http://download.eclipse.org/modeling/emf/emf/javadoc/2.4.3/org/eclipse/emf/edit/provider/resource/ResourceItemProviderAdapterFactory.html), a `RealItemProviderAdapterFactory`, and a [ReflectiveItemProviderAdapterFactory](AdapterFactory)(http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ReflectiveItemProviderAdapterFactory.html).  The `RealItemProviderAdapterFactory` creates/contains all of the ItemProviders needed for our EMF model objects (the others are not of great importance right now).
 

  
 In REALEditor.java code:

EMFEditOverview modified by Tom Swain

Tom Swain — Thu, 07 Nov 2013 19:59:46 -0000

--- v1
+++ v2
@@ -20,16 +20,16 @@

 ### Setting a Content Provider for a Viewer in REALEditor.java ###

-  :::java
-  public void createPages() {
-  ...
+    :::java
+    public void createPages() {
+    ...
     // This is the page for the tree viewer
     //
     {
       ...
       treeViewer.setContentProvider(new AdapterFactoryContentProvider(adapterFactory));
     }
-  ...
+    ...

 ### `AdapterFactoryContentProvider` and `adapterFactory` ###
@@ -37,13 +37,12 @@
 

  
 In REALEditor.java code:

-:::java
-protected void initializeEditingDomain() {
+    :::java
+    protected void initializeEditingDomain() {

     // Create an adapter factory that yields item providers.
     //
     adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);
-
     adapterFactory.addAdapterFactory(new ResourceItemProviderAdapterFactory());
     adapterFactory.addAdapterFactory(new RealItemProviderAdapterFactory());
     adapterFactory.addAdapterFactory(new ReflectiveItemProviderAdapterFactory());
@@ -68,19 +67,17 @@

 ### Setting a Label Provider for a Viewer in REALEditor.java ###

-:::java
-public void createPages() {
+    :::java
+    public void createPages() {

-...
+    ...
     // This is the page for the tree viewer
     //
     {
       ...
       treeViewer.setLabelProvider(new AdapterFactoryLabelProvider(adapterFactory));
     }
-...
-
-
+    ...

 ### `AdapterFactoryLabelProvider` and `adapterFactory` ###
@@ -96,7 +93,7 @@
 Like content providers, changes in label behavior can be made by subclassing `AdapterFactoryLabelProvider` and/or changes to item providers.
 





-## Property Sheet ## 
+## Property Sheet ##
 ***
 The property sheet is an Eclipse viewer which specializes in allowing the user to retrieve and edit modeled object properties.  The property sheet, `propertySheetPage`, is an instance of the Eclipse UI object [PropertySheetPage](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/PropertySheetPage.html) that uses an `AdapterFactoryContentProvider` acting as an [IPropertySourceProvider](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySourceProvider.html) to retrieve an [IPropertySource](http://help.eclipse.org/help33/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertySource.html) corresponding to a specific EMF object.  The `IPropertySource` (a wrapper for the UI independent [IItemPropertySource](http://download.eclipse.org/modeling/emf/emf/javadoc/2.5.0/org/eclipse/emf/edit/provider/IItemPropertySource.html), which the item providers implement) is used to retrieve the properties (i.e. the contents of the object) and a list of [IPropertyDescriptor](http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/views/properties/IPropertyDescriptor.html)s that contain the ID and property labels of the EMF Object.

EMFEditOverview modified by Tom Swain

Tom Swain — Thu, 07 Nov 2013 19:55:09 -0000

EMF.edit Overview

EMF.edit is a model editing framework in EMF that provides adapters (ItemProviders), property sources, a command creation and execution framework, and automated code generators for model editors. It is designed primarily to work with JFace UI widgets and viewers, but can work within any UI framework.

According to IBM's EMF.Edit Framework article, the EMF.edit framework specifically provides:

Content and label provider classes, property source support, and other convenience classes that allow EMF models to be displayed using standard desktop (JFace) viewers and property sheets.
A command framework, including a set of generic command implementation classes for building editors that support fully automatic undo and redo.
A code generator capable of generating everything needed to build a complete editor plug-in for your EMF model. It produces a properly structured editor that conforms to the recommended style for Eclipse EMF model editors. You can then customize the code however you like, without losing your connection to the model.

This article will give an overview of how the EMF.Edit framework relates specifically to REAL, and will brainstorm some ideas of what methods can be used to achieve the goals of an expanded GUI (in-cell editing, sorting, pop-ups, expanded context menus, etc.).

EMF.edit Overview

Content Providers

Content providers navigate the contents of a model object saved to a resource. They must implement a content provider interface (e.g. ITreeContentProvider, IStructuredContentProvider). Each JFace viewer in the generated editor code sets its content provider to new instance of an AdapterFactoryContentProvider which implements IContentProvider, ITreeContentProvider, and IStructuredContentProvider (See below).

Setting a Content Provider for a Viewer in REALEditor.java

:::java
public void createPages() {
...
// This is the page for the tree viewer
//
{
...
treeViewer.setContentProvider(new AdapterFactoryContentProvider(adapterFactory));
}
...

`AdapterFactoryContentProvider` and `adapterFactory`

An AdapterFactoryContentProvider serves as a wrapper for an AdapterFactory, specifically [adapterFactory] in the code. The adapterFactory is an instance of a ComposedAdapterFactory which contains a ResourceItemAdapterFactory, a RealItemProviderAdapterFactory, and a ReflectiveItemProviderAdapterFactory(http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.emf.doc/references/javadoc/org/eclipse/emf/edit/provider/ReflectiveItemProviderAdapterFactory.html). The RealItemProviderAdapterFactory creates/contains all of the ItemProviders needed for our EMF model objects (the others are not of great importance right now).

In REALEditor.java code:

:::java
protected void initializeEditingDomain() {

// Create an adapter factory that yields item providers.
//
adapterFactory = new ComposedAdapterFactory(ComposedAdapterFactory.Descriptor.Registry.INSTANCE);

adapterFactory.addAdapterFactory(new ResourceItemProviderAdapterFactory());
adapterFactory.addAdapterFactory(new RealItemProviderAdapterFactory());
adapterFactory.addAdapterFactory(new ReflectiveItemProviderAdapterFactory());
...

Usage

All access to the EMF object contents is provided through the content providers. For instance, when a user expands a parent item in a TreeViewer object in the UI, the TreeViewer will use its content provider to call getChildren() to retrieve its children's contents. Specifically, AdapterFactoryContentProvider will delegate to its adapterFactory member variable, which will in turn use its RealItemProviderAdapterFactory to grab the appropriate ItemProvider to call its own get getChildren() method.

The chain of method calls:
|TreeViewer (User expands EMF object in the UI)|->|AdapterFactoryContentProvider (as IContentProvider calling getChildren())|->|adapterFactory (delegating adapt())|->|RealItemProviderFactory (calling adapt() to adapt the object to an ITreeItemContentProvider)|->|ItemProvider (as ITreeItemContentProvider calling getChildren())|->|EMF Object|

Thoughts

To change how content is provided to the UI, AdapterFactoryContentProvider should be subclassed and appropriate changes should be made in item providers (see NMIVOS for more details).

Label Providers

Label providers retrieve label text and icons from EMF objects in a resource. They must implement some form of an ILabelProvider. Each JFace viewer in the EMF generated editor sets its label provider to an AdapterFactoryLabelProvider which implements ILabelProvider, IBaseLabelProvider and ITableLabelProvider.

Setting a Label Provider for a Viewer in REALEditor.java

:::java
public void createPages() {

...
// This is the page for the tree viewer
//
{
...
treeViewer.setLabelProvider(new AdapterFactoryLabelProvider(adapterFactory));
}
...

`AdapterFactoryLabelProvider` and `adapterFactory`

Similar to the relationship between AdapterFactoryContentProvider and adapterFactory, AdapterFactoryLabelProvider serves as a wrapper for adapterFactory. See above for more information.

Usage

Viewers get the text and icons for EMF objects by calling getText() and getImage(), respectively. As usual, this involves a long delegation chain from UI viewer to EMF object.

The chain of method calls:
|TreeViewer|->|AdapterFactoryLabelProvider (as ILabelProvider)|->|adapterFactory (delegating adapt())|->|RealItemProviderFactory (calling adapt())|->|ItemProvider (as IItemLabelProvider)|->|EMF Object|

Thoughts

Like content providers, changes in label behavior can be made by subclassing AdapterFactoryLabelProvider and/or changes to item providers.

Property Sheet ##

The property sheet is an Eclipse viewer which specializes in allowing the user to retrieve and edit modeled object properties. The property sheet, propertySheetPage, is an instance of the Eclipse UI object PropertySheetPage that uses an AdapterFactoryContentProvider acting as an IPropertySourceProvider to retrieve an IPropertySource corresponding to a specific EMF object. The IPropertySource (a wrapper for the UI independent IItemPropertySource, which the item providers implement) is used to retrieve the properties (i.e. the contents of the object) and a list of IPropertyDescriptors that contain the ID and property labels of the EMF Object.

Retrieval of an `IPropertySource`

The IPropertySourceProvider retrieves an IPropertySource by a call to getPropertySource().
|PropertySheetPage|->|AdapterFactoryContentProvider (as IPropertySourceProvider calling getPropertySource())|->|adapterFactory (delegating adapt()) |->|REALItemProviderAdapterFactory (calling adapt())|->|ItemProvider (as an IItemPropertySource wrapped in a newly created IPropertySource)|->|EMF Object|

Retrieval of `IPropertyDescriptor`s

Once an IPropertySource is retrieved, the property sheet calls getPropertyDescriptors() on the property source to retrieve a list of IPropertyDescriptors. getPropertyDescriptors() is implemented in the item providers using a similar wrapping pattern to getPropertySource() (see pg 50, fig. 3.8 in the EMF book for more details).

Recent changes to EMFEditOverview

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMF.edit Overview

Content Providers

Setting a Content Provider for a Viewer in REALEditor.java

`AdapterFactoryContentProvider` and `adapterFactory`

Usage

Thoughts

Label Providers

Setting a Label Provider for a Viewer in REALEditor.java

`AdapterFactoryLabelProvider` and `adapterFactory`

Usage

Thoughts

Property Sheet ##

Retrieval of an `IPropertySource`

Retrieval of `IPropertyDescriptor`s

EMF Reference

Sauce Codes

See Also

Recent changes to EMFEditOverview

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMFEditOverview modified by Tom Swain

EMF.edit Overview

Content Providers

Setting a Content Provider for a Viewer in REALEditor.java

AdapterFactoryContentProvider and adapterFactory

Usage

Thoughts

Label Providers

Setting a Label Provider for a Viewer in REALEditor.java

AdapterFactoryLabelProvider and adapterFactory

Usage

Thoughts

Property Sheet ##

Retrieval of an IPropertySource

Retrieval of IPropertyDescriptors

EMF Reference

Sauce Codes

See Also

`AdapterFactoryContentProvider` and `adapterFactory`

`AdapterFactoryLabelProvider` and `adapterFactory`

Retrieval of an `IPropertySource`

Retrieval of `IPropertyDescriptor`s