The Context Framework allows components such as Dockable Panes and Actions to communicate in a loosly coupled way - even across bundle boundaries.

The basic abstraction is the org.drombler.commons.context.Context interface. You can use it to look for instances of the specified type and listen for changes of its content.

1. Content Providers

To add content to a Context you need a mutable Context implementation such as: org.drombler.commons.context.SimpleContext

Typical content providers are:

  • Editor Dockable Panes (the object to edit, custom implementations of action command interfaces such as org.drombler.acp.core.standard.action.Savable to interact with actions such as the "Save" action)

  • View Dockable Panes with a "current selection"

2. Content Consumers

Content consumers query a Context for some type and listen for changes in a Context content using a ContextListener.

Typical content consumers are:

  • View Dockable Panes (show some information about an object)

  • Actions (look for instances of their action command interface)

3. Active Context

The Active Context provides access to the content of the local Context of the currently active object (in Drombler FX: Dockable Pane).

Actions and Dockable Panes interested in the Active Context can implement the following interface: org.drombler.commons.context.ActiveContextSensitive

Drombler FX will inject the Active Context.

Note: Don’t forget to listen for changes in the Active Context content using a ContextListener!

See Getting Started and Actions, Menus and Toolbars for samples.

4. Application Context

The Application-wide Context provides access to the combined content of the local Context of all currently open Dockable Panes.

Actions and Dockable Panes interested in the Application-wide Context can implement the following interface: org.drombler.commons.context.ApplicationContextSensitive

Drombler FX will inject the Application Context.

Note: Don’t forget to listen for changes in the Application Context content using a ContextListener!

See Actions, Menus and Toolbars for a sample.