Jump to: navigation, search

Eclipse4/API/AppContext

Services and Context Values

This section will describe which elements are guaranteed to be available for injection through the IEclipseContext. The most common of these will be the 'standard' services but will also reference some other 'value' elements (i.e. the injected value is *not* an interface itself but some discreet value such as a preference or model event).

Basic Services

EModelService

This service presents API appropriate for working with the UI Model. If contains methods to search for model elements via a variety of search parameters a well as operations that can be used to manipulate the model to achieve changes in the UI.

EPartService

This service provides API that deals with the runtime aspects of managin the current workbench UI such as opening new parts or getting / setting the 'active' part...

Can currently NOT used to open new parts as you cannot define the container, see https://bugs.eclipse.org/bugs/show_bug.cgi?id=390971 Lars.Vogel@gmail.com

EBindingService

This service allows manipulation of the key binding structures.

This services is used by the model to push key bindings into the runtime. It needs polish and I don't think it should be API for Kepler. Pwebster.ca.ibm.com

EContextService

Provides API to control the active 'chain' within a context structure.

The EContextService is important to programmatic clients, for activating contexts in their @PostConstruct or managing context activations based on the state of their controls (which widgets have focus, etc). Pwebster.ca.ibm.com
Except for deferUpdates(*), that should be marked as @noreference Pwebster.ca.ibm.com

ECommandService

Provides API to construct Commands.

ECommandService allows interaction with the Command API, accessing commands and creating parameterized commands for execution. It's like a global dictionary. Pwebster.ca.ibm.com

EHandlerService

This provides API to manage Handlers.

Why do the Execute methods take in Parameterized Commands (perhaps Execute should be in the CommandService and take a Handler?)

What's 'getContext' for ?

EMenuService

Provides a single API to register context menus.

In the UI Model a MPart can have any number of menus, each with a unique id. Do we need this or should we have a 'showMenu(id)' method ?<span style="font-style: italic;" />

ESelectionService

This allows for registration of listeners regarding the current selection. Note that this has more functionality in it than the @Inject approach since it provides 'post selection' (i.e. deferred) listeners as well as regular listeners.

IEventBroker

Allows access to the OSGI event broker and can be used to register / unregister listeners on the UIModel.