Archive

Posts Tagged ‘eclipse’

Help! I Programmatically Created a Resource in my Project, but My Code Doesn’t Find It!

January 1, 2011 5 comments

Let’s say that you wanted to test the existence of a file you programmatically created in your project. While there are a lot of situations where you might create an IResource on the fly, creating a file for use in a test is not a bad example.

The test code could look like this (TestUtilities is a convenience class that does things for me):

...
import org.junit.Assert;
...
    @Test
    public void testFileExistsTrue() throws IOException, CoreException {
        _project = TestUtilities.createProject("x"); //$NON-NLS-1$
        TestUtilities.createTemplateFileInProjectAt(_project, CustomSchemaSupport.SCHEMA_FOLDER_NAME, CustomSchemaSupport.FILENAME);

        boolean actual = _customSchemaSupport.fileExists(_project);

        try {
            Assert.assertTrue(actual);
        } finally {
            // always do this before returning
            _project.delete(true, null);
        }
    }

Read more…

Writing an Eclipse Plug-in (Part 24): Common Navigator: Configuring the submenus (Presentation…again)

August 29, 2010 9 comments

When we last left our erstwhile travelers (that would be all of you) they were surfing the quantum wave on their way to a future refactoring of their past to allow them to simultaneously feel proud of their work and embarrassed that they were following some guy who is making it all up as he goes along causing them to need refactoring in the first place.

Hey. Refactoring happens. All the time. Just ask evolution (only don’t mention the alligators).

What I will post about is adding behavior to our menu items. After having added 4 (count ’em) new menu items it is time to make them actually do something. What should they do? Well, they are going to add elements into their respective XML files (and respectively) while looking like they are adding items into their respective category nodes in the navigator.
Read more…

Writing an Eclipse Plug-in (Part 23): Common Navigator: Rewriting History

August 14, 2010 3 comments


[I am now using Git for my source control using the EGit plug-in. Of course it is only partially working. One of my projects has fully committed and the others say they are in staging no matter how many times I tell EGit to Commit. Sigh.

Also, starting with this post I am also going to make the code in this convoluted journey available for download in each post as well as the Missing Zip Files page. It will always be available in the format of whatever Eclipse I happen to be using at the time (7/18/10: Eclipse 3.6 Helios Release) so don’t blame me if you are using an older version and something doesn’t work the way I describe it. If you follow me you walk the edge. Of course, in switching to EGit I have no idea where the code for Parts 21 and 22 have gone. I hate when that happens.

Don’t forget to add your favorite plug-ins: in my case that means EGit, EclEmma, Eclipse-CS, and UMLet]

[Woo hoo! Eclipse 3.6 is finally released! I can’t wait to be one of the first to download it! Hey! Where is everybody? Oh, it was released June 23? Really? I hate when I miss an opening party…by almost two months…but it was because I was busy…in Miami…meeting with Michael Westin…]

Well, long time no hear! Yes, I am trying to write these posts a little more often than I have been, but it is amazing how real life gets in the way…what with the cat coming in and out of the box and the squirrels distracting me to no end (don’t get me started on the platypus). I guess I may be stuck with only one post per month (maybe less).

I promise not to beat myself up over it.

Speaking of which: when I started this post the sun was out scorching everything, and I was doing everything I could to stay out of its path. After a failed attempt at getting back into running (you know, diet and exercise will help you live forever, unless you exercise wrong thereby screwing up your leg muscles making it almost impossible to walk), but after a successful attempt to eat better (salad and seafood, anyone?) it is time to pay attention to the things that keep us getting up in the morning and make life worth living (no, not sex, drugs, and rock and roll, though they help): Eclipse plug-ins.

I was going to write a post on genetic programming, but I suspect the cat hid my Koza book because it thought I was going to write a fitness function to force it to choose one state or another. I’ll do that on my next visit to Copenhagen.

What I will post about is, well, fixing the past. Usually, that is quite difficult, but we will make an exception and pretend that we can fix what we did, not because it was wrong, but because our needs have changed (that’s my story and I’m sticking to it).
Read more…

Writing an Eclipse Plug-in (Part 21): Return of the Popup Menu (Displaying Resources)

[In case anyone cares: I have upgraded to Eclipse 3.6 RC1]

Welcome to the second of what will probably be 4 posts on creating popup menus using the Common Navigator Framework.

In the last post we created a two item popup that appears when there are no resources displayed or selected. In this post we will have the popup menu appear even when we right click on a resource.

How (are we doing it?)

Perform the following on the customnavigator plug-in project.

  1. Delete the navigatorContent enablement adapt entries for both CustomNewActionProvider and CustomRefreshActionProvider.
    • plugin.xml –> Extensions
    • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomNewActionProvider –> (enablement) –> (or) –> org.eclipse.core.resources.IResource (adapt) –> Delete
    • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomRefreshActionProvider –> (enablement) –> (or) –> org.eclipse.core.resources.IResource (adapt) –> Delete
  2. Add two enablement instanceof entries for both CustomNewActionProvider and CustomRefreshActionProvider.
    • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomNewActionProvider –> (enablement) –> (or) –> New –> instanceof
      • value: customnavigator.navigator.ICustomProjectElement
    • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomRefreshActionProvider –> (enablement) –> (or) –> New –> instanceof
      • value: customnavigator.navigator.ICustomProjectElement
  3. Start the runtime workbench, create a Custom Project, go to the Custom Perspective and right click on the project. You should see the popup menu.

Why (did we do it that way?)

First, let’s do that simplest thing I can think of: have a popup menu appear with one menu item. Once that is in place the rest are mechanical steps.

In order to have a new popup menu appear Eclipse needs to recognize the resource so that it will show just the menus you want and no others. How do we do that? By setting up an enablement with our custom project type.

Perform the following on the customnavigator plug-in project.

Go to plugin.xml –> Extensions.

Remove the entry for IResource (adapt):

  • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomNewActionProvider –> (enablement) –> (or) –> org.eclipse.core.resources.IResource (adapt) –> Delete

That entry told Eclipse to open the popup when the selected resource was of type IResource. Well the custom project does not include the IResource. We don’t need it for now. What we do need is for the popup to open when any of our custom types is selected. Since all of the custom nodes implement ICustomProjectElement we use that instead.

  • org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomNewActionProvider –> (enablement) –> (or) –> New –> instanceof
    • value: customnavigator.navigator.ICustomProjectElement

Why use instanceof instead of adapt? An adapt entry means that the selected object, in this case CustomProjectParent, can be adapted (converted) into the listed type, originally IResource, Since a CustomProjectParent does not implement IResource anywhere in its inheritance hierarchy the adapt will never work. Adapt means that we would have to change the custom node types while instanceof puts the onus on Eclipse. You know where my vote goes.

Perform the same steps for CustomRefreshActionProvider:

  1. org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomRefreshActionProvider –> (enablement) –> (or) –> org.eclipse.core.resources.IResource (adapt) –> Delete
  2. org.eclipse.ui.navigator.navigatorContent –> customnavigator.popup.actionprovider.CustomRefreshActionProvider –> (enablement) –> (or) –> New –> instanceof
    • value: customnavigator.navigator.ICustomProjectElement
  3. Start the runtime workbench, create a Custom Project, go to the Custom Perspective and right click on the project. You should see the popup menu.

While I was doing this I found that the above did not work. It turned out that my Launch configuration thought I only needed 73 of the existing plug-ins while I needed a few more. It is possible that your Launch Configuration might not have enough dependencies selected. In Eclipse 3.6 RC1 this needed 80 out of 375 plug-ins. The only other plug-in I have installed is EGit.

What Just Happened?

Not a lot just happened. Changing the adapt entry to instanceof specific to our custom project type was enough to get the popup to behave the way we needed. Not a lot of work.

What we need to do next is create New behavior for:

  • New Schema Table
  • New Schema View
  • New Schema Filter
  • New Stored Procedure

That will take commands, handlers and command images.

Our current setup creates new projects, schema files and deployment files. Oops. We’ll have to change that. Next time. Maybe.

After that we’ll add properties pages to each node type fix the New menus in the toolbar and main menu.

The cat is tired. It may be time to do some genetic programming posts.

Code

<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
   <extension
         point="org.eclipse.ui.views">
      <category
            id="customnavigator.category"
            name="%category.name">
      </category>
      <view
            allowMultiple="false"
            category="customnavigator.category"
            class="org.eclipse.ui.navigator.CommonNavigator"
            icon="icons/navigator.png"
            id="customnavigator.navigator"
            name="%view.name">
      </view>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.viewer">
      <viewer
            viewerId="customnavigator.navigator">
         <popupMenu
               id="customnavigator.navigator#PopupMenu">
            <insertionPoint
                  name="group.new">
            </insertionPoint>
            <insertionPoint
                  name="group.build"
                  separator="true">
            </insertionPoint>
         </popupMenu>
      </viewer>
      <viewerContentBinding
            viewerId="customnavigator.navigator">
         <includes>
            <contentExtension
                  pattern="customnavigator.navigatorContent">
            </contentExtension>
         </includes>
      </viewerContentBinding>
      <viewerActionBinding
            viewerId="customnavigator.navigator">
         <includes>
            <actionExtension
                  pattern="customnavigator.popup.actionprovider.CustomNewAction">
            </actionExtension>
            <actionExtension
                  pattern="customnavigator.popup.actionprovider.CustomRefreshAction">
            </actionExtension>
         </includes>
      </viewerActionBinding>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.navigatorContent">
      <navigatorContent
            activeByDefault="true"
            contentProvider="customnavigator.navigator.ContentProvider"
            id="customnavigator.navigatorContent"
            labelProvider="customnavigator.navigator.LabelProvider"
            name="%navigatorContent.name">
         <triggerPoints>
            <instanceof
                  value="org.eclipse.core.resources.IWorkspaceRoot">
            </instanceof>
         </triggerPoints>
         <commonSorter
               class="customnavigator.sorter.SchemaCategorySorter"
               id="customnavigator.sorter.schemacategorysorter">
            <parentExpression>
               <or>
                  <instanceof
                        value="customnavigator.navigator.CustomProjectSchema">
                  </instanceof>
               </or>
            </parentExpression>
         </commonSorter>
      </navigatorContent>
      <actionProvider
            class="customnavigator.popup.actionprovider.CustomNewActionProvider"
            id="customnavigator.popup.actionprovider.CustomNewAction">
         <enablement>
            <or>
               <instanceof
                     value="customnavigator.navigator.ICustomProjectElement">
               </instanceof>
               <adapt
                     type="java.util.Collection">
                  <count
                        value="0">
                  </count>
               </adapt>
            </or>
         </enablement>
      </actionProvider>
      <actionProvider
            class="customnavigator.popup.actionprovider.CustomRefreshActionProvider"
            id="customnavigator.popup.actionprovider.CustomRefreshAction">
         <enablement>
            <or>
               <instanceof
                     value="customnavigator.navigator.ICustomProjectElement">
               </instanceof>
               <adapt
                     type="java.util.Collection">
                  <count
                        value="0">
                  </count>
               </adapt>
            </or>
         </enablement>
      </actionProvider>
      <commonWizard
            type="new"
            wizardId="customplugin.wizard.new.custom">
         <enablement></enablement>
      </commonWizard>
   </extension>

</plugin>

Writing an Eclipse Plug-in (Part 20): Return of the Popup Menu (For an Empty Navigator)

April 4, 2010 4 comments

[This is a long post. It also feels like a bit of a mess. Whoda thought that creating a popup menu when there are no resources available in a navigator could be so non-trivial?]

So what’s the problem (or as they say in marketing speak: what is the challenge)?

The challenge (or as they say in real life: the pain) is quite easy to describe: when I right click in the custom navigator the popup menu appears. When I create a custom project and right-click on it the popup menu does not appear.

That behavior has to stop or I am turning this blog around right now (I’m not kidding! I’ll turn around right now!).

Alright. I lied. We actually have two problems:

  1. Remove the undefined menu items from the popup when nothing is available or selected
  2. Enable a specific set of menus when a Custom Project has been created

What this means is we have to decide when menu items appear/disappear or are enabled/disabled based on items being selected/unselected.

Sounds like a lot of combinations. Sounds like a job for a UML State diagram which I actually like when I am writing a real application. The issue here is that I am still kinda just messing with this and the state diagram makes me become too serious (I find that even the squirrels start to complain).

So let’s list the menu items we know so far:

  • New Custom Project
  • New Schema File
  • New Stored Procedure File
  • Open Project
  • Close Project
  • Copy
  • Paste
  • Delete
  • Import
  • Export
  • Refresh
  • Properties

Looks like a lot. Let’s think about this: copy, paste and delete don’t mean what they usually do, except for projects. I expect them to only copy/paste/delete the nodes they represent not entire files. Let’s leave them for last so let’s just remove them.

Open and Close project sounds too cool to be true. They will come after we do copy, paste and delete (and while we’re at it, how about working sets? Nah.).

Import and Export are also unknown. Since importing/exporting anything but Custom Projects seems rather odd, and we don’t know what it means to import or export Custom Projects, they will have to go too.

That leaves us with:

  • New Custom Project
  • New Schema File
  • New Stored Procedure File
  • Refresh
  • Properties

Much more managable. Also, we can expand what it means to be a schema and stored procedure in the Custom Navigator: the schema’s child nodes have New behavior as does the Stored Procedure node. So the list really looks like this:

  • New Custom Project
  • New Schema Table
  • New Schema View
  • New Schema Filter
  • New Stored Procedure
  • Refresh
  • Properties

When nothing is selected the following are enabled:

  • New Custom Project
  • Refresh

We can’t go around randomly creating Tables, Views and Filters just because, now can we?

When a Custom Project, or any custom resource, is selected the following are enabled:

  • New Custom Project
  • New Schema Table
  • New Schema View
  • New Schema Filter
  • New Stored Procedure
  • Refresh
  • Properties

As Richard Dreyfus once yelled into the open air: What does it mean?

What the above means is that the easiest way to control the popup menu for this custom navigator is to make one (or in this case two) rather than rely on the default popup and reconfigure it as we go. I tried desperately to avoid it, but in order to remove the default presentation of New, Import and Export it is just plain ol’ easier to make a new popup menu. Dems the breaks.

Tasks for this post and the next:

  1. Create a popup menu when the Custom navigator is empty
  2. Create a popup menu when a resource is selected in the Custom navigator

How (are we doing it?)

Time to back track. Remove the following:

  1. Remove all three commonWizard entries found under org.eclipse.ui.navigator.navigatorContent. That removes the menu entries under the popup menu New.
  2. Remove navigatorplugin –> plugin.xml –> org.eclipse.ui.menus
  3. Remove org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding) entry.

That was the easy stuff. The more involved steps for this post are:

  1. Define the popup menu and its insertionPoints
  2. Define the actionProvider
  3. Define the actionExtension
  4. Implement the action provider code (if not implementing the command framework)

Sounds pretty straightforward doesn’t it?

Let’s see how well we do.

  1. Define the popup menu and its insertionPoints
    1. Create a viewer entry in org.eclipse.ui.viewer
      • org.eclipse.ui.navigator.viewer –> New –> viewer
        • viewerId: customnavigator.navigator
    2. Create a popupMenu entry under the viewer
      • customnavigator.navigator (viewer) –> New –> popupMenu
        • id: customnavigator.navigator#PopupMenu
    3. Add two insertion points under the popupMenu
      • customnavigator.navigator#PopupMenu (popupMenu) –> New –> insertionPoint
        • name: group.new
      • customnavigator.navigator#PopupMenu (popupMenu) –> New –> insertionPoint
        • name: group.build
  2. Define the actionProviders
    1. org.eclipse.ui.navigator.navigatorContent –> New –> actionProvider
      • class: customnavigator.popup.actionprovider.CustomNewActionProvider
      • id: customnavigator.popup.actionprovider.CustomNewAction
      • customnavigator.popup.actionprovider.CustomNewActionProvider (actionProvider) –> enablement –> New –> or
      • or –> New –> adapt
        • type: org.eclipse.core.resources.IResource
      • or –> New –> adapt
        • type: java.util.Collection
      • java.util.Collection –> New –> count
        • value: 0
    2. org.eclipse.ui.navigator.navigatorContent –> New –> actionProvider
      • class: customnavigator.popup.actionprovider.CustomRefreshActionProvider
      • id: customnavigator.popup.actionprovider.CustomRefreshAction
      • customnavigator.popup.actionprovider.CustomRefreshActionProvider (actionProvider) –> enablement –> New –> or
      • or –> New –> adapt
        • type: org.eclipse.core.resources.IResource
      • or –> New –> adapt
        • type: java.util.Collection
      • java.util.Collection –> New –> count
        • value: 0
  3. Define the actionExtensions
    • org.eclipse.ui.navigator.viewer –> New –> viewerActionBinding
      • viewerId: customnavigator.navigator
    • customnavigator.navigator (viewerActionBinding) –> New –> includes
      • includes –> New –> actionExtension
      • pattern: customnavigator.popup.actionprovider.CustomNewAction
    • org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding) –> (includes) –> New –> actionExtension and change pattern to:
      • pattern: customnavigator.popup.actionprovider.CustomRefreshAction
  4. Implement the action provider code in the customnavigator plug-in
    customnavigator.popup.actionprovider.CustomNewActionProvider

    /**
     * Coder beware: this code is not warranted to do anything.
     * Some or all of this code is taken from the Eclipse code base.
     *
     * Copyright Mar 28, 2010 Carlos Valcarcel
     */
    package customnavigator.popup.actionprovider;
    
    import org.eclipse.jface.action.IMenuManager;
    import org.eclipse.jface.action.MenuManager;
    import org.eclipse.jface.action.Separator;
    import org.eclipse.ui.IWorkbenchWindow;
    import org.eclipse.ui.PlatformUI;
    import org.eclipse.ui.actions.ActionFactory;
    import org.eclipse.ui.navigator.CommonActionProvider;
    import org.eclipse.ui.navigator.ICommonActionExtensionSite;
    import org.eclipse.ui.navigator.ICommonMenuConstants;
    import org.eclipse.ui.navigator.ICommonViewerWorkbenchSite;
    import org.eclipse.ui.navigator.WizardActionGroup;
    
    public class CustomNewActionProvider extends CommonActionProvider {
    
        private static final String NEW_MENU_NAME = &quot;common.new.menu&quot;;//$NON-NLS-1$
    
        private ActionFactory.IWorkbenchAction showDlgAction;
    
        private WizardActionGroup newWizardActionGroup;
    
        private boolean contribute = false;
    
        @Override
        public void init(ICommonActionExtensionSite anExtensionSite) {
    
            if (anExtensionSite.getViewSite() instanceof ICommonViewerWorkbenchSite) {
                IWorkbenchWindow window = ((ICommonViewerWorkbenchSite) anExtensionSite.getViewSite()).getWorkbenchWindow();
                showDlgAction = ActionFactory.NEW.create(window);
    
                newWizardActionGroup = new WizardActionGroup(window, PlatformUI.getWorkbench().getNewWizardRegistry(), WizardActionGroup.TYPE_NEW, anExtensionSite.getContentService());
    
                contribute = true;
            }
        }
    
        @Override
        public void fillContextMenu(IMenuManager menu) {
            IMenuManager submenu = new MenuManager(
                    &quot;New&quot;,
                    NEW_MENU_NAME);
            if(!contribute) {
                return;
            }
    
            // fill the menu from the commonWizard contributions
            newWizardActionGroup.setContext(getContext());
            newWizardActionGroup.fillContextMenu(submenu);
    
            submenu.add(new Separator(ICommonMenuConstants.GROUP_ADDITIONS));
    
            // Add other ..
            submenu.add(new Separator());
            submenu.add(showDlgAction);
    
            // append the submenu after the GROUP_NEW group.
            menu.insertAfter(ICommonMenuConstants.GROUP_NEW, submenu);
        }
    
        @Override
        public void dispose() {
            if (showDlgAction!=null) {
                showDlgAction.dispose();
                showDlgAction = null;
            }
            super.dispose();
        }
    }
    

    customnavigator.popup.actionprovider.CustomRefreshActionProvider

    /**
     * Coder beware: this code is not warranted to do anything.
     * Some or all of this code is taken from the Eclipse code base.
     *
     * Copyright Apr 4, 2010 Carlos Valcarcel
     */
    package customnavigator.popup.actionprovider;
    
    import java.lang.reflect.InvocationTargetException;
    import java.util.Iterator;
    
    import org.eclipse.core.resources.IProject;
    import org.eclipse.core.resources.WorkspaceJob;
    import org.eclipse.core.runtime.CoreException;
    import org.eclipse.core.runtime.IAdaptable;
    import org.eclipse.core.runtime.IProgressMonitor;
    import org.eclipse.core.runtime.IStatus;
    import org.eclipse.core.runtime.Status;
    import org.eclipse.core.runtime.jobs.ISchedulingRule;
    import org.eclipse.jface.action.IMenuManager;
    import org.eclipse.jface.resource.ImageDescriptor;
    import org.eclipse.jface.viewers.IStructuredSelection;
    import org.eclipse.jface.viewers.StructuredViewer;
    import org.eclipse.jface.window.IShellProvider;
    import org.eclipse.osgi.util.NLS;
    import org.eclipse.swt.widgets.Shell;
    import org.eclipse.ui.IActionBars;
    import org.eclipse.ui.IWorkbenchCommandConstants;
    import org.eclipse.ui.actions.ActionFactory;
    import org.eclipse.ui.actions.RefreshAction;
    import org.eclipse.ui.actions.WorkspaceModifyOperation;
    import org.eclipse.ui.navigator.CommonActionProvider;
    import org.eclipse.ui.navigator.ICommonActionExtensionSite;
    import org.eclipse.ui.navigator.ICommonMenuConstants;
    
    import customnavigator.Activator;
    
    /**
     * The bulk of this code is taken from
     * org.eclipse.ui.internal.navigator.resources.actions.ResourceMgmtActionProvider
     * which is provided with Eclipse in case you want to look up the original.
     *
     * @author carlos
     */
    public class CustomRefreshActionProvider extends CommonActionProvider {
    
        private RefreshAction refreshAction;
    
        private Shell         shell;
    
        /*
         * (non-Javadoc)
         * @see
         * org.eclipse.ui.navigator.CommonActionProvider#init(org.eclipse.ui.navigator.ICommonActionExtensionSite)
         */
        @Override
        public void init(ICommonActionExtensionSite aSite) {
            super.init(aSite);
            shell = aSite.getViewSite().getShell();
            makeActions();
        }
    
        @Override
        public void fillActionBars(IActionBars actionBars) {
            actionBars.setGlobalActionHandler(ActionFactory.REFRESH.getId(), refreshAction);
            updateActionBars();
        }
    
        /**
         * Adds the refresh resource actions to the context menu.
         *
         * @param menu
         * context menu to add actions to
         */
        @SuppressWarnings(&quot;rawtypes&quot;)
        @Override
        public void fillContextMenu(IMenuManager menu) {
            IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
            boolean hasClosedProjects = false;
            Iterator resources = selection.iterator();
    
            while (resources.hasNext() &amp;&amp; (!hasClosedProjects)) {
                Object next = resources.next();
                IProject project = null;
    
                if (next instanceof IProject) {
                    project = (IProject) next;
                } else if (next instanceof IAdaptable) {
                    project = (IProject) ((IAdaptable) next).getAdapter(IProject.class);
                }
    
                if (project == null) {
                    continue;
                }
    
                if (!project.isOpen()) {
                    hasClosedProjects = true;
                }
            }
    
            if (!hasClosedProjects) {
                refreshAction.selectionChanged(selection);
                menu.appendToGroup(ICommonMenuConstants.GROUP_BUILD, refreshAction);
            }
        }
    
        protected void makeActions() {
            IShellProvider sp = new IShellProvider() {
                @SuppressWarnings(&quot;synthetic-access&quot;)
                @Override
                public Shell getShell() {
                    return shell;
                }
            };
    
            refreshAction = new RefreshAction(sp) {
                @Override
                public void run() {
                    final IStatus[] errorStatus = new IStatus[1];
                    errorStatus[0] = Status.OK_STATUS;
                    final WorkspaceModifyOperation op = (WorkspaceModifyOperation) createOperation(errorStatus);
                    WorkspaceJob job = new WorkspaceJob(&quot;refresh&quot;) { //$NON-NLS-1$
    
                        @SuppressWarnings(&quot;synthetic-access&quot;)
                        @Override
                        public IStatus runInWorkspace(IProgressMonitor monitor) throws CoreException {
                            try {
                                op.run(monitor);
                                if (shell != null &amp;&amp; !shell.isDisposed()) {
                                    shell.getDisplay().asyncExec(new Runnable() {
                                        @Override
                                        public void run() {
                                            StructuredViewer viewer = getActionSite().getStructuredViewer();
                                            if (viewer != null &amp;&amp; viewer.getControl() != null &amp;&amp; !viewer.getControl().isDisposed()) {
                                                viewer.refresh();
                                            }
                                        }
                                    });
                                }
                            } catch (InvocationTargetException e) {
                                String msg = NLS.bind(&quot;Exception in {0}. run: {1}&quot;, getClass().getName(), e.getTargetException());
                                throw new CoreException(new Status(IStatus.ERROR, Activator.PLUGIN_ID, IStatus.ERROR, msg, e
                                        .getTargetException()));
                            } catch (InterruptedException e) {
                                return Status.CANCEL_STATUS;
                            }
                            return errorStatus[0];
                        }
    
                    };
                    ISchedulingRule rule = op.getRule();
                    if (rule != null) {
                        job.setRule(rule);
                    }
                    job.setUser(true);
                    job.schedule();
                }
            };
            refreshAction.setDisabledImageDescriptor(getImageDescriptor(&quot;icons/refresh_nav_disabled.gif&quot;));//$NON-NLS-1$
            refreshAction.setImageDescriptor(getImageDescriptor(&quot;icons/refresh_nav_enabled.gif&quot;));//$NON-NLS-1$
            refreshAction.setActionDefinitionId(IWorkbenchCommandConstants.FILE_REFRESH);
        }
    
        /**
         * Returns the image descriptor with the given relative path.
         */
        protected ImageDescriptor getImageDescriptor(String relativePath) {
            return Activator.getIDEImageDescriptor(relativePath);
    
        }
    
        @Override
        public void updateActionBars() {
            IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
            refreshAction.selectionChanged(selection);
        }
    
    }
    

    Add the following to customnavigator.Activator:

    public class Activator extends AbstractUIPlugin {
    ...
        public static ImageDescriptor getIDEImageDescriptor(String imagePath) {
            return AbstractUIPlugin.imageDescriptorFromPlugin(Activator.PLUGIN_ID, imagePath);
        }
    }
    

    Add the following icons to the customnavigator icons folder:
    refresh_nav_enabled.gif:

    refresh_nav_disabled.gif:

Don’t forget:

  • Fix the warnings in MANIFEST.MF and plugin.xml.
  • Open the Externalize Strings Wizard and move the two strings to messages.properties in the folder with the action provider code.

Why (did we do it that way?)

To do today’s tasks it is necessary to clean the deck. That means removing all the wonderous things that took advantage of all the default GUI hooks and basically putting them back with new hooks. Think of it like spring cleaning…without spring or the cleaning.

Since we have already decided to have only the menu entries we really need we have to remove the commonWizard and org.eclipse.ui.menus entries for now. Don’t worry, we’ll put them back. It will be easier and cleaner to add them in sequence rather than removing some pieces, moving things around and hoping they work eventually.

  1. Remove all three commonWizard entries found under org.eclipse.ui.navigator.navigatorContent. That removes the menu entries under the popup menu New.
  2. Remove navigatorplugin –> plugin.xml –> org.eclipse.ui.menus

    As you should already know from the last post, the menuContribution entry found under org.eclipse.ui.menus let’s you directly add new menu items to an existing popup by giving Eclipse the path to the menu being affected. We’ll use this again later. Some things are too good to give up for long.

  3. Remove org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding) entry.The value of actionExtension –> pattern refers to the ids of the actionProvider classes that execute the default behavior when a popup menu item is selected. For example, the value we just removed, org.eclipse.ui.navigator.resources.*, refers to the actionProvider ids found in the org.eclipse.ui.navigator.resources plug-in. Remember how the default popup menu displays New, Import, Export and Refresh? Well, if you open org.eclipse.ui.navigator.resources –> plugin.xml you will find an actionProvider entry for the following classes (there are others, but additional actionProvider do not concern me):
    • org.eclipse.ui.internal.navigator.resources.actions.NewActionProvider
    • org.eclipse.ui.internal.navigator.resources.actions.PortingActionProvider
    • org.eclipse.ui.internal.navigator.resources.actions.ResourceMgmtActionProvider

    The ids for the above classes are:

    • org.eclipse.ui.navigator.resources.NewActions
    • org.eclipse.ui.navigator.resources.PortingActions
    • org.eclipse.ui.navigator.resources.ResourceMgmtActions

    Notice that the above ids fit the pattern org.eclipse.ui.navigator.resources.*. Eclipse doesn’t care about the class name; it cares about the id. Yes, there are other actionProviders, but they have enablement criteria that keeps them from being displayed when nothing is selected.

  4. Define the new popup menu and the insertionPoints.Time to make the donuts.

    Let’s create the popup and add one menu item. In order to do that we have to

    1. Create a viewer entry in org.eclipse.ui.viewer
    2. Create a popupMenu entry under the viewer
    3. Add an insertion point under the popupMenu
    4. Create a viewerActionBinding and actionExtension entry in org.eclipse.ui.navigator.viewer

    Do the following in the customnavigator plugin.xml Extensions tab:

    1. Create a viewer entry in org.eclipse.ui.viewer
      • org.eclipse.ui.navigator.viewer –> New –> viewer
        • viewerId: customnavigator.navigator
    2. Create a popupMenu entry under the viewer
      • customnavigator.navigator (viewer) –> New –> popupMenu
        • id: customnavigator.navigator#PopupMenu
    3. Add an insertion point under the popupMenu
      • customnavigator.navigator#PopupMenu (popupMenu) –> New –> insertionPoint
        • name: group.new
    4. Create a viewerActionBinding and actionExtension entry in org.eclipse.ui.navigator.viewer
      • org.eclipse.ui.navigator.viewer –> New –> viewerActionBinding
        • viewerId: customnavigator.navigator
      • customnavigator.navigator (viewerActionBinding) –> New –> includes
        • includes –> New –> actionExtension
        • pattern: org.eclipse.ui.navigator.resources.NewActions

    Quick note: The name group.new comes from ICommonMenuConstants found in org.eclipse.ui.navigator. Whenever possible I recommend adhering to existing naming conventions just to make things easier to find.

    Just for yucks we are using an existing action provider: org.eclipse.ui.internal.navigator.resources.actions.NewActionProvider whose id is org.eclipse.ui.navigator.resources.NewActions. What is interesting about the NewActionProvider is that it creates a new menu insertion point in the popup which allows menu items to be added as submenus. What is bad about NewActionProvider is that it does it programmatically.

    NewActionProvider.java

    public class NewActionProvider extends CommonActionProvider {
    ...
    	public void fillContextMenu(IMenuManager menu) {
    		IMenuManager submenu = new MenuManager(
    				WorkbenchNavigatorMessages.NewActionProvider_NewMenu_label,
    				NEW_MENU_NAME);
    		if(!contribute) {
    			return;
    		}
    ...
    		// THIS IS A NEW INSERTION POINT! WHODA THUNK IT?
    		menu.insertAfter(ICommonMenuConstants.GROUP_NEW, submenu);
    	}
    ...
    }
    

    That’s right, we cannot declare an insertion point for submenus in plugin.xml; the insertion point for a submenu has to be declared programmatically. Yes, code will have to be written, but we are going to steal copy most of it anyway.

  5. Start the runtime workbench and check that the popup menu appears when there is nothing displayed in the navigator. Exit the runtime workbench when you are done. Let’s create our own version of this code.
  6. Implement a version of CustomNewActionProvider to create an insertion point for the New Wizards.
    1. org.eclipse.ui.navigator.navigatorContent –> New –> actionProvider
      • class: customnavigator.popup.actionprovider.CustomNewActionProvider
      • id: customnavigator.popup.actionprovider.CustomNewAction
        • customnavigator.popup.actionprovider.CustomNewActionProvider (actionProvider) –> enablement –> New –> or
        • or –> New –> adapt
          • type: org.eclipse.core.resources.IResource
        • or –> New –> adapt
          • type: java.util.Collection
        • java.util.Collection –> New –> count
          • value: 0

    Return to customnavigator.popup.actionprovider.CustomNewActionProvider (actionProvider). Click the class link. Create the class. Add the following code:

    /**
     * Coder beware: this code is not warranted to do anything.
     * Some or all of this code is taken from the Eclipse code base.
     *
     * Copyright Mar 28, 2010 Carlos Valcarcel
     */
    package customnavigator.popup.actionprovider;
    
    import org.eclipse.jface.action.IMenuManager;
    import org.eclipse.jface.action.MenuManager;
    import org.eclipse.jface.action.Separator;
    import org.eclipse.ui.IWorkbenchWindow;
    import org.eclipse.ui.PlatformUI;
    import org.eclipse.ui.actions.ActionFactory;
    import org.eclipse.ui.navigator.CommonActionProvider;
    import org.eclipse.ui.navigator.ICommonActionExtensionSite;
    import org.eclipse.ui.navigator.ICommonMenuConstants;
    import org.eclipse.ui.navigator.ICommonViewerWorkbenchSite;
    import org.eclipse.ui.navigator.WizardActionGroup;
    
    public class CustomNewActionProvider extends CommonActionProvider {
    
        private static final String NEW_MENU_NAME = &quot;common.new.menu&quot;;//$NON-NLS-1$
    
        private ActionFactory.IWorkbenchAction showDlgAction;
    
        private WizardActionGroup newWizardActionGroup;
    
        private boolean contribute = false;
    
        @Override
        public void init(ICommonActionExtensionSite anExtensionSite) {
    
            if (anExtensionSite.getViewSite() instanceof ICommonViewerWorkbenchSite) {
                IWorkbenchWindow window = ((ICommonViewerWorkbenchSite) anExtensionSite.getViewSite()).getWorkbenchWindow();
                showDlgAction = ActionFactory.NEW.create(window);
    
                newWizardActionGroup = new WizardActionGroup(window, PlatformUI.getWorkbench().getNewWizardRegistry(), WizardActionGroup.TYPE_NEW, anExtensionSite.getContentService());
    
                contribute = true;
            }
        }
    
        @Override
        public void fillContextMenu(IMenuManager menu) {
            IMenuManager submenu = new MenuManager(
                    &quot;New&quot;,
                    NEW_MENU_NAME);
            if(!contribute) {
                return;
            }
    
            // fill the menu from the commonWizard contributions
            newWizardActionGroup.setContext(getContext());
            newWizardActionGroup.fillContextMenu(submenu);
    
            submenu.add(new Separator(ICommonMenuConstants.GROUP_ADDITIONS));
    
            // Add other ..
            submenu.add(new Separator());
            submenu.add(showDlgAction);
    
            // append the submenu after the GROUP_NEW group.
            menu.insertAfter(ICommonMenuConstants.GROUP_NEW, submenu);
        }
    
        @Override
        public void dispose() {
            if (showDlgAction!=null) {
                showDlgAction.dispose();
                showDlgAction = null;
            }
            super.dispose();
        }
    }
    

    Now associate (bind) the actionProvider to the popup through the viewerActionBinding:

    • Go to org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding) –> (includes) –> org.eclipse.ui.navigator.resources.NewActions and change pattern to:
      • pattern: customnavigator.popup.actionprovider.CustomNewAction

    Notice the use of the id, not the class name.

  7. Start the runtime workbench and check that the New popup menu appears and that it has one submenu, Other, which both appears and is enabled when there is nothing displayed in the navigator. Exit the runtime workbench when you are done.
  8. Add Custom Project to the New menu
    Let’s put back one of the pieces we removed earlier:

    • org.eclipse.ui.navigator.navigatorContent –> New –> commonWizard
      • type: new
      • wizardId: customplugin.wizard.new.custom
  9. Start the runtime workbench and check that the popup menu appears when there is nothing displayed in the navigator. Exit the runtime workbench when you are done.
  10. Add the Refresh menu
    Let’s add the Refresh menu without the functionality…just to maintain purity of thought. Besides, I confuse easily. We’ll add the code in a few steps.First, add a new insertionPoint for the Refresh menu:

    • customnavigator.navigator#PopupMenu (popupMenu) –> New –> insertionPoint
      • name: group.build
      • separator: true

    The name group.build comes from ICommonMenuConstants found in org.eclipse.ui.navigator.

    Let’s define the actionProvider for the Refresh menu:

    1. org.eclipse.ui.navigator.navigatorContent –> New –> actionProvider
      • class: customnavigator.popup.actionprovider.CustomRefreshActionProvider
      • id: customnavigator.popup.actionprovider.CustomRefreshAction
    2. customnavigator.popup.actionprovider.CustomRefreshActionProvider –> enablement –> New –> or
    3. or –> New –> adapt
      • type: org.eclipse.core.resources.IResource
    4. or –> New –> adapt
      • type: java.util.Collection
    5. java.util.Collection –> New –> count
      • value: 0

    Next, let’s steal copy, the existing code from ResourceMgmtActionProvider to create CustomRefreshActionProvider.

    Return to customnavigator.popup.actionprovider.CustomRefreshActionProvider (actionProvider). Click the class link, create the class and insert this code:

    /**
     * Coder beware: this code is not warranted to do anything.
     * Some or all of this code is taken from the Eclipse code base.
     *
     * Copyright Apr 4, 2010 Carlos Valcarcel
     */
    package customnavigator.popup.actionprovider;
    
    import java.lang.reflect.InvocationTargetException;
    import java.util.Iterator;
    
    import org.eclipse.core.resources.IProject;
    import org.eclipse.core.resources.WorkspaceJob;
    import org.eclipse.core.runtime.CoreException;
    import org.eclipse.core.runtime.IAdaptable;
    import org.eclipse.core.runtime.IProgressMonitor;
    import org.eclipse.core.runtime.IStatus;
    import org.eclipse.core.runtime.Status;
    import org.eclipse.core.runtime.jobs.ISchedulingRule;
    import org.eclipse.jface.action.IMenuManager;
    import org.eclipse.jface.resource.ImageDescriptor;
    import org.eclipse.jface.viewers.IStructuredSelection;
    import org.eclipse.jface.viewers.StructuredViewer;
    import org.eclipse.jface.window.IShellProvider;
    import org.eclipse.osgi.util.NLS;
    import org.eclipse.swt.widgets.Shell;
    import org.eclipse.ui.IActionBars;
    import org.eclipse.ui.IWorkbenchCommandConstants;
    import org.eclipse.ui.actions.ActionFactory;
    import org.eclipse.ui.actions.RefreshAction;
    import org.eclipse.ui.actions.WorkspaceModifyOperation;
    import org.eclipse.ui.navigator.CommonActionProvider;
    import org.eclipse.ui.navigator.ICommonActionExtensionSite;
    import org.eclipse.ui.navigator.ICommonMenuConstants;
    
    import customnavigator.Activator;
    
    /**
     * The bulk of this code is taken from
     * org.eclipse.ui.internal.navigator.resources.actions.ResourceMgmtActionProvider
     * which is provided with Eclipse in case you want to look up the original.
     *
     * @author carlos
     */
    public class CustomRefreshActionProvider extends CommonActionProvider {
    
        private RefreshAction refreshAction;
    
        private Shell         shell;
    
        /*
         * (non-Javadoc)
         * @see
         * org.eclipse.ui.navigator.CommonActionProvider#init(org.eclipse.ui.navigator.ICommonActionExtensionSite)
         */
        @Override
        public void init(ICommonActionExtensionSite aSite) {
            super.init(aSite);
            shell = aSite.getViewSite().getShell();
            makeActions();
        }
    
        @Override
        public void fillActionBars(IActionBars actionBars) {
            actionBars.setGlobalActionHandler(ActionFactory.REFRESH.getId(), refreshAction);
            updateActionBars();
        }
    
        /**
         * Adds the refresh resource actions to the context menu.
         *
         * @param menu
         * context menu to add actions to
         */
        @SuppressWarnings(&quot;rawtypes&quot;)
        @Override
        public void fillContextMenu(IMenuManager menu) {
            IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
            boolean hasClosedProjects = false;
            Iterator resources = selection.iterator();
    
            while (resources.hasNext() &amp;&amp; (!hasClosedProjects)) {
                Object next = resources.next();
                IProject project = null;
    
                if (next instanceof IProject) {
                    project = (IProject) next;
                } else if (next instanceof IAdaptable) {
                    project = (IProject) ((IAdaptable) next).getAdapter(IProject.class);
                }
    
                if (project == null) {
                    continue;
                }
    
                if (!project.isOpen()) {
                    hasClosedProjects = true;
                }
            }
    
            if (!hasClosedProjects) {
                refreshAction.selectionChanged(selection);
                menu.appendToGroup(ICommonMenuConstants.GROUP_BUILD, refreshAction);
            }
        }
    
        protected void makeActions() {
            IShellProvider sp = new IShellProvider() {
                @SuppressWarnings(&quot;synthetic-access&quot;)
                @Override
                public Shell getShell() {
                    return shell;
                }
            };
    
            refreshAction = new RefreshAction(sp) {
                @Override
                public void run() {
                    final IStatus[] errorStatus = new IStatus[1];
                    errorStatus[0] = Status.OK_STATUS;
                    final WorkspaceModifyOperation op = (WorkspaceModifyOperation) createOperation(errorStatus);
                    WorkspaceJob job = new WorkspaceJob(&quot;refresh&quot;) { //$NON-NLS-1$
    
                        @SuppressWarnings(&quot;synthetic-access&quot;)
                        @Override
                        public IStatus runInWorkspace(IProgressMonitor monitor) throws CoreException {
                            try {
                                op.run(monitor);
                                if (shell != null &amp;&amp; !shell.isDisposed()) {
                                    shell.getDisplay().asyncExec(new Runnable() {
                                        @Override
                                        public void run() {
                                            StructuredViewer viewer = getActionSite().getStructuredViewer();
                                            if (viewer != null &amp;&amp; viewer.getControl() != null &amp;&amp; !viewer.getControl().isDisposed()) {
                                                viewer.refresh();
                                            }
                                        }
                                    });
                                }
                            } catch (InvocationTargetException e) {
                                String msg = NLS.bind(&quot;Exception in {0}. run: {1}&quot;, getClass().getName(), e.getTargetException());
                                throw new CoreException(new Status(IStatus.ERROR, Activator.PLUGIN_ID, IStatus.ERROR, msg, e
                                        .getTargetException()));
                            } catch (InterruptedException e) {
                                return Status.CANCEL_STATUS;
                            }
                            return errorStatus[0];
                        }
    
                    };
                    ISchedulingRule rule = op.getRule();
                    if (rule != null) {
                        job.setRule(rule);
                    }
                    job.setUser(true);
                    job.schedule();
                }
            };
            refreshAction.setDisabledImageDescriptor(getImageDescriptor(&quot;icons/refresh_nav_disabled.gif&quot;));//$NON-NLS-1$
            refreshAction.setImageDescriptor(getImageDescriptor(&quot;icons/refresh_nav_enabled.gif&quot;));//$NON-NLS-1$
            refreshAction.setActionDefinitionId(IWorkbenchCommandConstants.FILE_REFRESH);
        }
    
        /**
         * Returns the image descriptor with the given relative path.
         */
        protected ImageDescriptor getImageDescriptor(String relativePath) {
            return Activator.getIDEImageDescriptor(relativePath);
    
        }
    
        @Override
        public void updateActionBars() {
            IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
            refreshAction.selectionChanged(selection);
        }
    
    }
    

    I removed any code that did not contribute to the goal: make RefreshAction work. I changed comments as well.

    Yes, there is a compile error in CustomRefreshActionProvider.getImageDescriptor(). To fix that we have to add the following method to customnavigator.Activator:

    public class Activator extends AbstractUIPlugin {
    ...
        public static ImageDescriptor getIDEImageDescriptor(String imagePath) {
            return AbstractUIPlugin.imageDescriptorFromPlugin(Activator.PLUGIN_ID, imagePath);
        }
    }
    

    Compile error fixed.

    In order for the CustomRefreshActionProvider to be called we have to add an entry under org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding):

    • org.eclipse.ui.navigator.viewer –> customnavigator.navigator (viewerActionBinding) –> (includes) –> New –> actionExtension and change pattern to:
      • pattern: customnavigator.popup.actionprovider.CustomRefreshAction

    Again, notice the use of the id, not the class name. Could I simple have one entry for all of these action providers by putting in a pattern of customnavigator.popup.actionprovider.*? Of course, but where’s the fun in that (in other words, use that kind of pattern once you understand why you are using it. Until then, create individual entries)?

  11. Start the runtime workbench and check that the expected popup menus appears when there is nothing displayed in the navigator. Exit the runtime workbench.

    For those of you wondering when we added support for F5: the key binding is added by RefreshAction.
  12. Add Refresh icons
    method makeActions() is looking for an enabled and a disabled image for Refresh. Add the following images to your customnavigator icon folder:

    refresh_nav_enabled.gif:

    refresh_nav_disabled.gif:

  13. Start the runtime workbench and check that the expected popup menus appears when there is nothing displayed in the navigator. Exit the runtime workbench.

What Just Happened?

So we took a few steps back and a few steps forward.

  • We removed the plugin.xml entries that reconfigured the default popup.
  • We created a new popup menu definition with insertion points.
  • We declared and implemented two action providers: New and Refresh.
  • We declared two action extensions that referred to the action providers.
  • We declared a commonWizard entry to add the New Custom Project Wizard to the New popup menu.

Not bad for a post that I just couldn’t find the time for. For some reason it felt like a lot to do to create a new default menu. Adding the other items will be much simpler. I hope.

In other news: some of you may have noticed that in past posts I occasionally mentioned Deployment files as a feature. I am easily confused. The only things we are going to do are Custom Projects, Schemas and Stored Procedures. Any references to anything else are red herrings, blind alleys, and otherwise dead ends. Avoid them unless you are intent on finding a place to sleep.

References

Building a Common Navigator based viewer, Part III: Configuring Menus

Code

Activator.java

package customnavigator;

import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.swt.graphics.Image;
import org.eclipse.ui.plugin.AbstractUIPlugin;
import org.osgi.framework.BundleContext;

/**
 * The activator class controls the plug-in life cycle
 */
public class Activator extends AbstractUIPlugin {

	// The plug-in ID
	public static final String PLUGIN_ID = "customnavigator"; //$NON-NLS-1$

	// The shared instance
	private static Activator plugin;
	
	/**
	 * The constructor
	 */
	public Activator() {
	    // empty for now
	}

	/*
	 * (non-Javadoc)
	 * @see org.eclipse.ui.plugin.AbstractUIPlugin#start(org.osgi.framework.BundleContext)
	 */
	@Override
    public void start(BundleContext context) throws Exception {
		super.start(context);
		plugin = this;
	}

	/*
	 * (non-Javadoc)
	 * @see org.eclipse.ui.plugin.AbstractUIPlugin#stop(org.osgi.framework.BundleContext)
	 */
	@Override
    public void stop(BundleContext context) throws Exception {
		plugin = null;
		super.stop(context);
	}

	/**
	 * Returns the shared instance
	 *
	 * @return the shared instance
	 */
	public static Activator getDefault() {
		return plugin;
	}

    public static Image getImage(String imagePath) {
        ImageDescriptor imageDescriptor = AbstractUIPlugin.imageDescriptorFromPlugin(Activator.PLUGIN_ID, imagePath);
        Image image = imageDescriptor.createImage();

        return image;
    }

    public static ImageDescriptor getIDEImageDescriptor(String imagePath) {
        return AbstractUIPlugin.imageDescriptorFromPlugin(Activator.PLUGIN_ID, imagePath);
    }
}

CustomNewActionProvider.java

/**
 * Coder beware: this code is not warranted to do anything. 
 * Some or all of this code is taken from the Eclipse code base.
 *
 * Copyright Mar 28, 2010 Carlos Valcarcel
 */
package customnavigator.popup.actionprovider;

import org.eclipse.jface.action.IMenuManager;
import org.eclipse.jface.action.MenuManager;
import org.eclipse.jface.action.Separator;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.actions.ActionFactory;
import org.eclipse.ui.navigator.CommonActionProvider;
import org.eclipse.ui.navigator.ICommonActionExtensionSite;
import org.eclipse.ui.navigator.ICommonMenuConstants;
import org.eclipse.ui.navigator.ICommonViewerWorkbenchSite;
import org.eclipse.ui.navigator.WizardActionGroup;

/**
 * Provides the new (artifact creation) menu options for a context menu.
 * 
 * <p>
 * The added submenu has the following structure
 * </p>
 * 
 * <ul>
 * <li>a set of context sensitive wizard shortcuts (as defined by
 * <b>org.eclipse.ui.navigator.commonWizard</b>), </li>
 * <li>another separator, </li>
 * <li>a generic "Other" new wizard shortcut action</li>
 * </ul>
 * 
 * @since 3.2
 * 
 */
public class CustomNewActionProvider extends CommonActionProvider {

    private static final String NEW_MENU_NAME = "common.new.menu";//$NON-NLS-1$

    private ActionFactory.IWorkbenchAction showDlgAction;

    private WizardActionGroup newWizardActionGroup;

    private boolean contribute = false;

    @Override
    public void init(ICommonActionExtensionSite anExtensionSite) {

        if (anExtensionSite.getViewSite() instanceof ICommonViewerWorkbenchSite) {
            IWorkbenchWindow window = ((ICommonViewerWorkbenchSite) anExtensionSite.getViewSite()).getWorkbenchWindow();
            showDlgAction = ActionFactory.NEW.create(window);

            newWizardActionGroup = new WizardActionGroup(window, PlatformUI.getWorkbench().getNewWizardRegistry(), WizardActionGroup.TYPE_NEW, anExtensionSite.getContentService());

            contribute = true;
        }
    }

    /**
     * Adds a submenu to the given menu with the name "group.new" see
     * {@link ICommonMenuConstants#GROUP_NEW}). The submenu contains the following structure:
     * 
     * <ul>
     * <li>a set of context sensitive wizard shortcuts (as defined by
     * <b>org.eclipse.ui.navigator.commonWizard</b>), </li>
     * <li>another separator, </li>
     * <li>a generic "Other" new wizard shortcut action</li>
     * </ul>
     */
    @Override
    public void fillContextMenu(IMenuManager menu) {
        IMenuManager submenu = new MenuManager(
                Messages.CustomNewActionProvider_popupNewLabel,
                NEW_MENU_NAME);
        if(!contribute) {
            return;
        }

        // fill the menu from the commonWizard contributions
        newWizardActionGroup.setContext(getContext());
        newWizardActionGroup.fillContextMenu(submenu);

        submenu.add(new Separator(ICommonMenuConstants.GROUP_ADDITIONS));

        // Add other ..
        submenu.add(new Separator());
        submenu.add(showDlgAction);

        // append the submenu after the GROUP_NEW group.
        menu.insertAfter(ICommonMenuConstants.GROUP_NEW, submenu);
    }

    /* (non-Javadoc)
     * @see org.eclipse.ui.actions.ActionGroup#dispose()
     */
    @Override
    public void dispose() {
        if (showDlgAction!=null) {
            showDlgAction.dispose();
            showDlgAction = null;
        }
        super.dispose();
    }
}

CustomRefreshActionProvider.java

/**
 * Coder beware: this code is not warranted to do anything. 
 * Some or all of this code is taken from the Eclipse code base.
 * 
 * Copyright Apr 4, 2010 Carlos Valcarcel
 */
package customnavigator.popup.actionprovider;

import java.lang.reflect.InvocationTargetException;
import java.util.Iterator;

import org.eclipse.core.resources.IProject;
import org.eclipse.core.resources.WorkspaceJob;
import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IAdaptable;
import org.eclipse.core.runtime.IProgressMonitor;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.core.runtime.Status;
import org.eclipse.core.runtime.jobs.ISchedulingRule;
import org.eclipse.jface.action.IMenuManager;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jface.viewers.IStructuredSelection;
import org.eclipse.jface.viewers.StructuredViewer;
import org.eclipse.jface.window.IShellProvider;
import org.eclipse.osgi.util.NLS;
import org.eclipse.swt.widgets.Shell;
import org.eclipse.ui.IActionBars;
import org.eclipse.ui.IWorkbenchCommandConstants;
import org.eclipse.ui.actions.ActionFactory;
import org.eclipse.ui.actions.RefreshAction;
import org.eclipse.ui.actions.WorkspaceModifyOperation;
import org.eclipse.ui.navigator.CommonActionProvider;
import org.eclipse.ui.navigator.ICommonActionExtensionSite;
import org.eclipse.ui.navigator.ICommonMenuConstants;

import customnavigator.Activator;

/**
 * The bulk of this code is taken from
 * org.eclipse.ui.internal.navigator.resources.actions.ResourceMgmtActionProvider
 * which is provided with Eclipse in case you want to look up the original.
 * 
 * @author carlos
 */
public class CustomRefreshActionProvider extends CommonActionProvider {

    private RefreshAction refreshAction;

    private Shell         shell;

    /*
     * (non-Javadoc)
     * @see
     * org.eclipse.ui.navigator.CommonActionProvider#init(org.eclipse.ui.navigator.ICommonActionExtensionSite)
     */
    @Override
    public void init(ICommonActionExtensionSite aSite) {
        super.init(aSite);
        shell = aSite.getViewSite().getShell();
        makeActions();
    }

    @Override
    public void fillActionBars(IActionBars actionBars) {
        actionBars.setGlobalActionHandler(ActionFactory.REFRESH.getId(), refreshAction);
        updateActionBars();
    }

    /**
     * Adds the refresh resource actions to the context menu.
     * 
     * @param menu
     * context menu to add actions to
     */
    @SuppressWarnings("rawtypes")
    @Override
    public void fillContextMenu(IMenuManager menu) {
        IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
        boolean hasClosedProjects = false;
        Iterator resources = selection.iterator();

        while (resources.hasNext() && (!hasClosedProjects)) {
            Object next = resources.next();
            IProject project = null;

            if (next instanceof IProject) {
                project = (IProject) next;
            } else if (next instanceof IAdaptable) {
                project = (IProject) ((IAdaptable) next).getAdapter(IProject.class);
            }

            if (project == null) {
                continue;
            }

            if (!project.isOpen()) {
                hasClosedProjects = true;
            }
        }
        
        if (!hasClosedProjects) {
            refreshAction.selectionChanged(selection);
            menu.appendToGroup(ICommonMenuConstants.GROUP_BUILD, refreshAction);
        }
    }

    protected void makeActions() {
        IShellProvider sp = new IShellProvider() {
            @SuppressWarnings("synthetic-access")
            @Override
            public Shell getShell() {
                return shell;
            }
        };

        refreshAction = new RefreshAction(sp) {
            @Override
            public void run() {
                final IStatus[] errorStatus = new IStatus[1];
                errorStatus[0] = Status.OK_STATUS;
                final WorkspaceModifyOperation op = (WorkspaceModifyOperation) createOperation(errorStatus);
                WorkspaceJob job = new WorkspaceJob("refresh") { //$NON-NLS-1$

                    @SuppressWarnings("synthetic-access")
                    @Override
                    public IStatus runInWorkspace(IProgressMonitor monitor) throws CoreException {
                        try {
                            op.run(monitor);
                            if (shell != null && !shell.isDisposed()) {
                                shell.getDisplay().asyncExec(new Runnable() {
                                    @Override
                                    public void run() {
                                        StructuredViewer viewer = getActionSite().getStructuredViewer();
                                        if (viewer != null && viewer.getControl() != null && !viewer.getControl().isDisposed()) {
                                            viewer.refresh();
                                        }
                                    }
                                });
                            }
                        } catch (InvocationTargetException e) {
                            String msg = NLS.bind(Messages.CustomRefreshActionProvider_invocationTargetExceptionMessage, getClass().getName(), e.getTargetException());
                            throw new CoreException(new Status(IStatus.ERROR, Activator.PLUGIN_ID, IStatus.ERROR, msg, e
                                    .getTargetException()));
                        } catch (InterruptedException e) {
                            return Status.CANCEL_STATUS;
                        }
                        return errorStatus[0];
                    }

                };
                ISchedulingRule rule = op.getRule();
                if (rule != null) {
                    job.setRule(rule);
                }
                job.setUser(true);
                job.schedule();
            }
        };
        refreshAction.setDisabledImageDescriptor(getImageDescriptor("icons/refresh_nav_disabled.gif"));//$NON-NLS-1$
        refreshAction.setImageDescriptor(getImageDescriptor("icons/refresh_nav_enabled.gif"));//$NON-NLS-1$
        refreshAction.setActionDefinitionId(IWorkbenchCommandConstants.FILE_REFRESH);
    }

    /**
     * Returns the image descriptor with the given relative path.
     */
    protected ImageDescriptor getImageDescriptor(String relativePath) {
        return Activator.getIDEImageDescriptor(relativePath);

    }

    @Override
    public void updateActionBars() {
        IStructuredSelection selection = (IStructuredSelection) getContext().getSelection();
        refreshAction.selectionChanged(selection);
    }

}

Messages.java

package customnavigator.popup.actionprovider;

import org.eclipse.osgi.util.NLS;

public class Messages extends NLS {
    private static final String BUNDLE_NAME = "customnavigator.popup.actionprovider.messages"; //$NON-NLS-1$
    public static String        CustomNewActionProvider_popupNewLabel;
    public static String CustomRefreshActionProvider_invocationTargetExceptionMessage;
    static {
        // initialize resource bundle
        NLS.initializeMessages(BUNDLE_NAME, Messages.class);
    }

    private Messages() {
    }
}

messages.properties

CustomNewActionProvider_popupNewLabel=New
CustomRefreshActionProvider_invocationTargetExceptionMessage=Exception in {0}. run: {1}

plugin.xml

<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
   <extension
         point="org.eclipse.ui.views">
      <category
            id="customnavigator.category"
            name="%category.name">
      </category>
      <view
            allowMultiple="false"
            category="customnavigator.category"
            class="org.eclipse.ui.navigator.CommonNavigator"
            icon="icons/navigator.png"
            id="customnavigator.navigator"
            name="%view.name">
      </view>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.viewer">
      <viewer
            viewerId="customnavigator.navigator">
         <popupMenu
               id="customnavigator.navigator#PopupMenu">
            <insertionPoint
                  name="group.new">
            </insertionPoint>
            <insertionPoint
                  name="group.build"
                  separator="true">
            </insertionPoint>
         </popupMenu>
      </viewer>
      <viewerContentBinding
            viewerId="customnavigator.navigator">
         <includes>
            <contentExtension
                  pattern="customnavigator.navigatorContent">
            </contentExtension>
         </includes>
      </viewerContentBinding>
      <viewerActionBinding
            viewerId="customnavigator.navigator">
         <includes>
            <actionExtension
                  pattern="customnavigator.popup.actionprovider.CustomNewAction">
            </actionExtension>
            <actionExtension
                  pattern="customnavigator.popup.actionprovider.CustomRefreshAction">
            </actionExtension>
         </includes>
      </viewerActionBinding>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.navigatorContent">
      <navigatorContent
            activeByDefault="true"
            contentProvider="customnavigator.navigator.ContentProvider"
            id="customnavigator.navigatorContent"
            labelProvider="customnavigator.navigator.LabelProvider"
            name="%navigatorContent.name">
         <triggerPoints>
            <instanceof
                  value="org.eclipse.core.resources.IWorkspaceRoot">
            </instanceof>
         </triggerPoints>
         <commonSorter
               class="customnavigator.sorter.SchemaCategorySorter"
               id="customnavigator.sorter.schemacategorysorter">
            <parentExpression>
               <or>
                  <instanceof
                        value="customnavigator.navigator.CustomProjectSchema">
                  </instanceof>
               </or>
            </parentExpression>
         </commonSorter>
      </navigatorContent>
      <actionProvider
            class="customnavigator.popup.actionprovider.CustomNewActionProvider"
            id="customnavigator.popup.actionprovider.CustomNewAction">
         <enablement>
            <or>
               <adapt
                     type="org.eclipse.core.resources.IResource">
               </adapt>
               <adapt
                     type="java.util.Collection">
                  <count
                        value="0">
                  </count>
               </adapt>
            </or>
         </enablement>
      </actionProvider>
      <actionProvider
            class="customnavigator.popup.actionprovider.CustomRefreshActionProvider"
            id="customnavigator.popup.actionprovider.CustomRefreshAction">
         <enablement>
            <or>
               <adapt
                     type="org.eclipse.core.resources.IResource">
               </adapt>
               <adapt
                     type="java.util.Collection">
                  <count
                        value="0">
                  </count>
               </adapt>
            </or>
         </enablement>
      </actionProvider>
      <commonWizard
            type="new"
            wizardId="customplugin.wizard.new.custom">
         <enablement></enablement>
      </commonWizard>
   </extension>

</plugin>

MANIFEST.MF

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: %Bundle-Name
Bundle-SymbolicName: customnavigator;singleton:=true
Bundle-Version: 1.0.2.0
Bundle-Activator: customnavigator.Activator
Require-Bundle: org.eclipse.ui,
 org.eclipse.core.runtime,
 org.eclipse.core.resources,
 org.eclipse.ui.ide;bundle-version="3.6.0",
 org.eclipse.ui.navigator,
 customplugin;bundle-version="1.0.1"
Bundle-ActivationPolicy: lazy
Bundle-RequiredExecutionEnvironment: JavaSE-1.6
Export-Package: customnavigator,
 customnavigator.navigator,
 customnavigator.popup.actionprovider,
 customnavigator.sorter

Writing an Eclipse Plug-in (Part 19): A Quick Display Fix

February 28, 2010 2 comments

[I am deep into solving a CNF issue, but since I haven’t solved it yet you will have to settle for a bug fix.]

Random bug: when the cursor hovers over the custom navigator title bar a tooltip opens letting us know that the navigator can’t find a label for the root node. The full error message is Error: no label provider for R/. Tells you everything you need to know. Except what the problem is. Or how to fix it. Or, for Eclipse novices, what R/ means.

Luckily this is something that we are not afflicted with here at Hidden Clause. The message did tell us everything we needed to know. The Custom Navigator label provider is ignoring the root node used by the navigator (the R/ referred to in the error) and returning an empty string. The code for LabelProvider.getText() is:

   public String getText(Object element) {
        String text = ""; //$NON-NLS-1$
        if (ICustomProjectElement.class.isInstance(element)) {
            text = ((ICustomProjectElement)element).getText();
        }
        // else ignore the element

        return text;
    }

(Notice how it so brilliantly ignores everything except elements of type ICustomProjectElement.)

What the message also tells us, by not telling us, is that our zero-length string appears to be causing consternation in the navigator. It is causing so much consternation that the navigator thinks no label provider is available to supply it with a default label for the root node.

That something is easily fixed in the LabelProvider. I’m not sure why Eclipse does not default to no string for the root (damn, those double negatives!), but it does not so we have to assign something to it. Since the standard behavior for other navigator views is to use the name of the view, in this case Custom Plug-in Navigator, that is what we will do.

  1. Open LabelProvider.java
  2. Change getText() to include an else if:
       public String getText(Object element) {
            String text = ""; //$NON-NLS-1$
            if (ICustomProjectElement.class.isInstance(element)) {
                text = ((ICustomProjectElement)element).getText();
            } else if (IWorkspaceRoot.class.isInstance(element)) {
                text = "Custom Plug-in Navigator";
            }
            // else ignore the element
    
            return text;
        }
    
  3. Start the runtime workbench and behold the beauty of our new string.

For Those of You Who Care

I discovered the solution to the above by putting a breakpoint in LabelProvider.getText() and walking the call tree. NavigatorContentServiceLabelProvider.findStyledText() quite explicitly changed the original empty string returned by LabelProvider.getText() into a null which caused NavigatorContentServiceLabelProvider.getStyledText() to assign the error message to the navigator view. It makes sense, it just wasn’t what I wanted.

Extra credit: Run the Externalize String Wizard on LabelProvider.java and add the new string to the message.properties file.

What Just Happened?

Fixed a bug. Contain your excitement.

The cat was not impressed and refused to come out.

Code

messages.properties

CustomProjectParent_Project_Folder=icons/project-folder.png
CustomProjectSchema_Project_Schema=icons/project-schema.png
CustomProjectSchemaFilters_Project_Schema_Filters=icons/project-schema-filters.png
CustomProjectSchemaTables_Project_Schema_Tables=icons/project-schema-tables.png
CustomProjectSchemaViews_Project_Schema_Views=icons/project-schema-views.png
CustomProjectStoredProcedures_Project_Stored_Procedures=icons/project-stored-procedures.png
LabelProvider_Custom_Plugin_Navigator=Custom Plug-in Navigator

LabelProvider.java

/**
 * Coder beware: this code is not warranted to do anything.
 *
 * Copyright Oct 17, 2009 Carlos Valcarcel
 */
package customnavigator.navigator;

import org.eclipse.core.resources.IWorkspaceRoot;
import org.eclipse.jface.viewers.ILabelProvider;
import org.eclipse.jface.viewers.ILabelProviderListener;
import org.eclipse.swt.graphics.Image;

/**
 * @author carlos
 *
 */
public class LabelProvider implements ILabelProvider {

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.ILabelProvider#getImage(java.lang.Object)
     */
    @Override
    public Image getImage(Object element) {
        Image image = null;
        
        if (ICustomProjectElement.class.isInstance(element)) {
            image = ((ICustomProjectElement)element).getImage();
        }
        // else ignore the element
        
        return image;
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.ILabelProvider#getText(java.lang.Object)
     */
    @Override
    public String getText(Object element) {
        String text = ""; //$NON-NLS-1$
        if (ICustomProjectElement.class.isInstance(element)) {
            text = ((ICustomProjectElement)element).getText();
        } else if (IWorkspaceRoot.class.isInstance(element)) {
            text = Messages.LabelProvider_Custom_Plugin_Navigator;
        }
        // else ignore the element
        
        return text;
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IBaseLabelProvider#addListener(org.eclipse.jface.viewers.ILabelProviderListener)
     */
    @Override
    public void addListener(ILabelProviderListener listener) {
        // TODO Auto-generated method stub

    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IBaseLabelProvider#dispose()
     */
    @Override
    public void dispose() {
        // TODO Auto-generated method stub

    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IBaseLabelProvider#isLabelProperty(java.lang.Object, java.lang.String)
     */
    @Override
    public boolean isLabelProperty(Object element, String property) {
        // TODO Auto-generated method stub
        return false;
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IBaseLabelProvider#removeListener(org.eclipse.jface.viewers.ILabelProviderListener)
     */
    @Override
    public void removeListener(ILabelProviderListener listener) {
        // TODO Auto-generated method stub

    }

}

Writing an Eclipse Plug-in (Part 18 – Take 2): Common Navigator: Adding submenus (Presentation/Behavior)

February 21, 2010 1 comment

Well, don’t I feel silly.

During the writing of Part 19, Adding Behavior to the menu items, I discovered something both heartening and disturbing: the addition of behavior to the New Wizards is much easier than I thought. Where I used the org.eclipse.ui.menus extension point to add the menu items to the New menu of the default popup menu I could have used the org.eclipse.ui.navigator.navigatorContent –> commonWizard extension instead. This would take care of both presentation and behavior.

Since using the org.eclipse.ui.menus to accomplish this task is wrong (yes, wrong*) I thought I would correct this obvious affront to civilization and pleasant company before the wrong kind of meme invades too many impressionable minds and causes an aggregation of incorrect behavior leading to that worst of all possible behaviors: rudeness.

Consider this a refactoring of Part 18 as the things discovered in it are still valid and will help in the controlling of the popup menu in other contexts…just not this one.

Okay! Places everyone! This time with feeling!

[Pretend that you just finished reading the brilliant advice that was Part 17 and are looking for the enlightenment that only comes from believing in God, unicorns or the Na’vi.]

And now, the moment you’ve all been waiting for: adding commands to the popup menu.

I know, you are just aquiver in anticipation.

What menus do we need to put in? Just a few. The Custom Navigator popup menu should contain:

  • New – Sub-menu with choices (Custom Project, Schema, and Deployment. Eventually we will change Schema to Tables, Views, Filters)
  • Copy – Ctrl+C (an item in a category or an entire category)
  • Paste – Ctrl+V (an item in a category or an entire category)
  • Remove – Del or Ctrl+X (an item in a category or an entire category)

We will not worry about Import/Export behavior as that will be added to the Import/Export Wizard with the associated additions to the main menu, toolbar, etc. done as appropriate (meaning later, when I care).

The thing to remember is: presentation first, behavior second. Actually, by the time we’re done we will have done both for the price of one (well, at least for the New wizards).

Where should the popup menu configuration/code go: into the customplugin or customnavigator project? Because we are directly affecting the navigator popup menu the configuration will go into the customnavigator plug-in. I promise not to regret it later when someone points out why it would really be in the customplugin project.

How (are we doing it?)

First: let’s add one menu item to the New menu.

  1. customnavigator –> plugin.xml –> Extensions –> org.eclipse.ui.navigator.navigatorContent –> New –> commonWizard
    • type: new
    • wizardId: customplugin.wizard.new.custom
  2. As a sanity check start the runtime workbench, go to the Custom Perspective and right click in the empty Custom Navigator.

    Back to the grindstone.

  3. org.eclipse.ui.navigator.navigatorContent –> New –> commonWizard
    • type: new
    • wizardId: customplugin.wizard.file.schema
  4. org.eclipse.ui.navigator.navigatorContent –> New –> commonWizard
    • type: new
    • wizardId: customplugin.wizard.file.deployment
  5. I know: you probably think that the above was too easy. You’re right. It was. In addition to the presentation we got the behavior for free. And no code so we’re ahead.

Next: let’s add three standard menus: Copy/Paste/Delete. Again, for now we will assign default commands that we will change later.

Let’s use the following icons for the copy/paste/delete menu items (yes, I copied them from Eclipse):

  1. customnavigator –> plugin.xml –> Extensions –> All Extensions –> Add –> org.eclipse.ui.menus
  2. org.eclipse.ui.menus –> New –> menuContribution
    • locationURI: popup:customnavigator.navigator?before=import
  3. popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.copy
    • label: Copy
    • icon: icons/copy_16x16.png
  4. popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.paste
    • label: Paste
    • icon: icons/paste_16x16.png
  5. popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.delete
    • label: Delete
    • icon: icons/delete_16x16.png
  6. popup:customnavigator.navigator?before=import (menuContribution) –> New –> separator
    • name: customnavigator.separator
    • visible: true

The above is a lot to do all at once so feel free to add one section at a time and check the runtime workbench. Once you add the org.eclipse.ui.menus extension along with the menuContribution and one of the commands you should be able to open the Custom Perspective, right click in the Custom Navigator and see a lovely popup menu.

The final result is beautifully displayed in the screen capture (don’t sweat the fact that Copy is not disabled. That is under the control of Eclipse and the clipboard. You will probably have a different item enabled or none).

But first: time to reveal the magic.

Why (did we do it that way?)

If you want to add a menu item to the popup menu the easiest way is to use the org.eclipse.ui.menus extension and add a menuContribution to it (hmm. That would imply there is another way to do this. Yes, using actionSets…which have been deprecated, so don’t). The menuContribution‘s locationURI is the path to the location within the popup where your new menu item should go. If we were adding our menu item at the top level popup we would simply have used a locationURI of popup:customplugin.customnavigator?after=additions; that’s right: simply using the id of the navigator places the menu item into its popup. Using the after=additions piece puts the menu items directly in the popup right after the last item…which is not where we want it.

So the $54,000 question is: what locationURI do we use to put our menu items in the correct spot?

That turns out to be the wrong question (I am starting to dislike that word).

The real question is: if there is a shortcut to adding New Wizards to the main menu, why isn’t there a way to do that with the navigator popup menu? If you recall from Part 15 we added our 3 New Wizards to the main menu by using the org.eclipse.ui.perspectiveExtensions –> perspectiveExtension –> newWizardShortcut. By simply supplying the New Wizard id Eclipse took care of adding it to the main menu File –> New and to the toolbar New button.

The real answer is: there is a way to do it and it involves the org.eclipse.ui.navigator.navigatorContent extension point. It has a child extension named commonWizards that does the equivalent behavior of the newWizardShortcut but for popup menus. On one hand, this is the greatest thing since sliced bread since we don’t have to configure as much (and did I mention no code?), but on the other hand we still have no idea how to add to a popup menu submenu such as New when the behavior we want to add has nothing to do with a wizard.

Let’s speak to that later. [Peek at the end of the post after the configuration files; I speak to the madness needed to implement the method of adding to the default popup menu supplied with the Common Navigator Framework.]

The configuration of the remaining menus now make sense. Add a new menuContribution to the org.eclipse.ui.menus extension and, using the high-level custom navigator path location URI (popup:customnavigator.navigator?before=import), we tell Eclipse to put the menus before the import section. Again, just to supply the required information we assign the internal copy, paste, and delete commandIds to the various menus.

Here are the instructions again:

  • org.eclipse.ui.menus –> New –> menuContribution
    • locationURI: popup:customnavigator.navigator?before=import
  • popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.copy
    • label: Copy
    • icon: icons/copy_16x16.png
  • popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.paste
    • label: Paste
    • icon: icons/paste_16x16.png
  • popup:customnavigator.navigator?before=import (menuContribution) –> New –> command
    • commandId: org.eclipse.ui.edit.delete
    • label: Delete
    • icon: icons/delete_16x16.png
  • popup:customnavigator.navigator?before=import (menuContribution) –> New –> separator
    • name: customnavigator.separator
    • visible: true

Doesn’t it look great? It just makes you proud to be a plug-in developer.

The next big question: why did we do it that way? Or more accurately: where is the documentation for this magic?

Part of the answer is easy: instructions on adding to a popup menu can be found here. Part of the answer is weak: I stumbled on the help documentation for commonWizard while I was looking up something else.

Time to wash up:

  • Go to the Overview tab, click on Externalize Strings Wizard and externalize the strings
  • In plugin.xml click on the MANIFEST.MF tab, click on the light bulb in the left hand margin and select Add Missing Packages

Who’s better than you?

What Just Happened?

The popup menu items have been added! With and without behavior! Who says you can’t have your cake and eat it too?

The cat is not only alive, but curious, which leads one to worry about the cat’s future.

(I hope this was a better answer to your question, Augusto. It’s always better the second time…)

* I know, I know: it still works. So what? you may say. So what?! So everything. If I had known about the commonWizard extension sooner I would have used it first as it would have eliminated the need for the Plug-in Spy and the search from the Common Navigator popup menu path to the New menu. While it is still just configuration, it is needless configuration. Needless. Need less. Compare what commonWizard needs:


to what org.eclipse.ui.menus –> menuContribution is looking for:

Use the more extensive extension when extensiveness is called for. Otherwise, strive to be simple. Like a new born baby. Or the brain of a politician.

Code

No code…again.

bundle.properties

#Properties file for customnavigator_1.0.0.7
Bundle-Name = Custom Navigator Plug-in
view.name = Custom Plug-in Navigator
category.name = Custom Projects
navigatorContent.name = Custom Navigator Content
copy.command.label = Copy
paste.command.label = Paste
delete.command.label = Delete

plugin.xml (customnavigator)

<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
   <extension
         point="org.eclipse.ui.views">
      <category
            id="customnavigator.category"
            name="%category.name">
      </category>
      <view
            allowMultiple="false"
            category="customnavigator.category"
            class="org.eclipse.ui.navigator.CommonNavigator"
            icon="icons/navigator.png"
            id="customnavigator.navigator"
            name="%view.name">
      </view>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.viewer">
      <viewerActionBinding
            viewerId="customnavigator.navigator">
         <includes>
            <actionExtension
                  pattern="org.eclipse.ui.navigator.resources.*">
            </actionExtension>
         </includes>
      </viewerActionBinding>
      <viewerContentBinding
            viewerId="customnavigator.navigator">
         <includes>
            <contentExtension
                  pattern="customnavigator.navigatorContent">
            </contentExtension>
         </includes>
      </viewerContentBinding>
   </extension>
   <extension
         point="org.eclipse.ui.navigator.navigatorContent">
      <navigatorContent
            activeByDefault="true"
            contentProvider="customnavigator.navigator.ContentProvider"
            id="customnavigator.navigatorContent"
            labelProvider="customnavigator.navigator.LabelProvider"
            name="%navigatorContent.name">
         <triggerPoints>
            <instanceof
                  value="org.eclipse.core.resources.IWorkspaceRoot">
            </instanceof>
         </triggerPoints>
         <commonSorter
               class="customnavigator.sorter.SchemaCategorySorter"
               id="customnavigator.sorter.schemacategorysorter">
            <parentExpression>
               <or>
                  <instanceof
                        value="customnavigator.navigator.CustomProjectSchema">
                  </instanceof>
               </or>
            </parentExpression>
         </commonSorter>
      </navigatorContent>
      <commonWizard
            type="new"
            wizardId="customplugin.wizard.new.custom">
         <enablement></enablement>
      </commonWizard>
      <commonWizard
            type="new"
            wizardId="customplugin.wizard.file.schema">
         <enablement></enablement>
      </commonWizard>
      <commonWizard
            type="new"
            wizardId="customplugin.wizard.file.deployment">
         <enablement></enablement>
      </commonWizard>
   </extension>
   <extension
         point="org.eclipse.ui.menus">
      <menuContribution
            locationURI="popup:customnavigator.navigator?before=import">
         <command
               commandId="org.eclipse.ui.edit.copy"
               icon="icons/copy_16x16.png"
               label="%copy.command.label"
               style="push">
         </command>
         <command
               commandId="org.eclipse.ui.edit.paste"
               icon="icons/paste_16x16.png"
               label="%paste.command.label"
               style="push">
         </command>
         <command
               commandId="org.eclipse.ui.edit.delete"
               icon="icons/delete_16x16.png"
               label="%delete.command.label"
               style="push">
         </command>
         <separator
               name="customnavigator.separator"
               visible="true">
         </separator>
      </menuContribution>
   </extension>

</plugin>

Extra Credit

So you want to add non-Wizard behavior to the default popup menu and aren’t sure how? You’ve come to the right place. Let’s look at what it means to add a new menu item to the New menu item of the default popup menu of our Custom Navigator.

But before I can answer that we have to fix something. Well, some of us have to fix something.

For those of you doing this on Windows: shield your eyes and move on to the section titled CONTINUE HERE (while goto may be considered harmful, continue here isn’t).

Now that we have all of those miscreants out of the way: those of you who need to see the answer with your own eyes, but are using Kubuntu, need to change the Eclipse key binding for the runtime workbench from Shift+Alt+F2 to Shift+Alt+F3. Why? Because in order to discover the correct path to the New menu in the popup we need the Plug-in Spy to work. The Plug-in Spy, at least on Kubuntu, does not work properly because Shift+Alt+F2 doesn’t work properly; changing the key binding from Shift+Alt+F2 to Shift+Alt+F3 works.

How do we change the key binding? Start and do the following from the runtime workbench:

  1. Window –> Preferences –> General –> Keys
  2. In the text field below the Scheme drop down type: shift+alt+f
  3. Press Delete in the Binding field to remove the current key binding
  4. With the cursor in the Binding field press the shift key, the alt key and the F3 key all at the same time.
  5. Click OK to close the Preferences window

Now the bad news: you will have to do this every time you start the runtime workbench if you want to use the Plug-in Spy unless you unset the Launch configuration to clear the workspace; by not clearing the workspace you may find weird behavior that isn’t weird but appears to be weird because the runtime workbench is not cleaning up after itself. I recommend leaving the Launch configuration alone…meaning with the Clear selection checked.

The good news: you don’t need to use the Plug-in spy that often so this manual step is something you will not do too often. Grow up or start taking stronger meds.

CONTINUE HERE

Those of you on Windows: every time I say press Shift+Alt+F3 you must press Shift+Alt+F2. Got it? Shift+Alt+F3 really mean Shift+Alt+F2 (just in Windows). Think you can handle that?

  1. Start the runtime workbench and open the Custom Perspective
  2. Press Shift+Alt+F3. Notice the cursor changes appearance
  3. Right click in the Custom Navigator and select New –> Project
  4. Oh look! A window with wonderful information!

And there it is: the path used by the active contribution location URI: common.new.menu. If you change the current path for the Copy/Paste/Delete command from popup:customplugin.customnavigator?after=additions to popup:common.new.menu?after=additions and start the runtime workbench again you will find that the menus are part of the submenus associated with New.

So where can you find all this great information on inserting a menu item in the popup menu’s New menu?

My answer is going to be very unsatisfying: I don’t know. I went through a number of plug-ins, web sites and help files and found nothing. When I remembered the Plug-in Spy, and fixed the Shift+Alt+F2 problem (Kubuntu, remember?), I was able to discover the path I was looking for.

The cat remained quiet and was of no value whatsoever.