[platform-ui-dev] [CN] Changes for CommonActionProvider/NavigatorActionS

[Michael Elder <mdelder@xxxxxxxxxx>]

Extended Team:

Changes have been made which require reaction from clients of the Common
Navigator framework's Navigator Action Service.

Clients must (at a minimum) make the following changes to respond to the
breakages:
(1)  Clients must respond to remove any references to
org.eclipse.ui.navigator.ICommonActionProvider, change their action
providers to subclass CommonActionProvider, and make (what should be
obvious changes) to correct the method signatures of CommonActionProvider,
which now subclasses org.eclipse.ui.actions.ActionGroup.

(2) Clients must also remove any references to the interface
org.eclipse.ui.navigator.INavigatorActionService. Now, an API class,
org.eclipse.ui.navigator.NavigatorActionService, which extends
org.eclipse.ui.actions.ActionGroup provides the functionality of the
original interface. The signatures are roughly the same as before, but some
methods (which were not known to be widely used yet by clients) were
removed.

Changes have been applied for the following bugzilla entries. These changes
are focused around
improving the Navigator Action support as per comments in
https://bugs.eclipse.org/bugs/show_bug.cgi?id=121254.

[CommonNavigator] Allow menu insertion points to be extensible per viewer
https://bugs.eclipse.org/bugs/show_bug.cgi?id=122525

[CommonNavigator] Open up INavigatorActionService as instantiatable API
https://bugs.eclipse.org/bugs/show_bug.cgi?id=122520

[CommonNavigator] CommonActionProvider should subclass ActionGroup
https://bugs.eclipse.org/bugs/show_bug.cgi?id=122517

[CommonNavigator] Improve CommonActionProvider's init() method
https://bugs.eclipse.org/bugs/show_bug.cgi?id=122518

[CommonNavigator] CommonActionProvider should be made an API-level abstract
class
https://bugs.eclipse.org/bugs/show_bug.cgi?id=122515


The changelong from the release to CVS:
Releasing improvements to Navigator Action Service framework [..]
+[Bug 122525] The viewer extension point was restructured in a non-breaking
way to support better popup menu customization for navigator clients.
+[Bug 122520] The Navigator Action Service is now instantiatable as API as
an enhanced subclass of org.eclipse.ui.actions.ActionGroup.
+[Bug 122518] The init() method of what was ICommonActionProvider has been
streamlined to take a single "Configuration" element named
'CommonActionProviderConfig".
+[Bug 122517] The CommonActionProvider class was promoted to API, changed
to subclass org.eclipse.ui.actions.ActionGroup, and adopt the new form of
the init() method.
+[Bug 122515] The interface ICommonActionProvider was removed.



-------------------------------------------------------------------------
Kind Regards,

Michael D. Elder
Rational Studio / Services Tools Development
IBM RTP Lab
Ext: (919) 543-8356
T/L:  441-8356
mdelder@xxxxxxxxxx