Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
E4/3X API Survey
Contents
Overview
The purpose of this page is to provide a gross overview of APIs found within 3.X platform and their applicability to 4.0. For each API there is a brief note summarizing their condition in e4, be that deprecated, superseded, or still useful as well as a list of the applicable classes/interfaces. For organizational purposes it would be helpful to segregate the list by source plug-in, and within each plug in by logical grouping (if applicable).
This list is in no way exhaustive or authoritative.
org.eclipse.ui (org.eclipse.ui.workbench)
Workbench
This area covers the top-level conceptual beast that is "the workbench."
- PlatformUI
- IWorkbench
- IWorkbenchWindow
- IWorkbenchPage
- WorkbenchAdvisor
- IServiceLocator
Layouts
- IPerspectiveRegistry
- IPerspectiveFactory
- IPerspectiveDescriptor
Parts
- IEditorPart
- IEditorReference
- IViewPart
- IViewReference
- IEditorRegistry
- IViewRegistry
- IPartService
- INavigationHistory
Preferences
- PreferenceManager
Wizards
Are our classifications of wizards necessary?
- IWizardRegistry
Model (Decorators, Workbench model, dynamism)
- IDecoratorManager
- WorkbenchLabelProvider
- IElementFactory
- IExtensionTracker
- StatusManager
Working Sets
Working sets, in general, are a somewhat awkward construction. They are often used as a filter on your workspace but are implemented as a bag. It might be useful in e4 to deprecated working sets in favour of a proper model "view" API.
- IWorkingSetManager
- IWorkingSet
- IWorkingSetUpdater
- IWorkingSetNewWizard
- IWorkingSetElementAdapter
Commands (Operations)
- IWorkbenchOperationSupport
Contributions (Menus, Toolbars, Keybindings, Action Sets, Object Contributions)
Themes
With the addition of proper CSS handling Themes would likely be made redundant.
- ITheme
- IThemeManager
- IThemePreview
Activities (Capabilities)
If everything in the workbench is backed by a model, are activities still needed? Could suppression of contributions be seen as a filter on that model?
- IWorkbenchActivitySupport
- ITriggerPointAdvisor
User Experience (Intro, Help, Browser)
Intro, at the workbench level, is effectively built as a hack on top of views. With a more flexible view model it may be possible to do away with intro entirely.
- IIntroManager
- IWorkbenchHelpSystem
- IWorkbenchBrowserSupport