OSGi Frameworks Tree

OSGi frameworks are displayed in a separate view in the Eclipse Workbench - the Frameworks view. The view arranges the OSGi frameworks in separate trees as you can unfold the tree of a connected framework and browse its components. An OSGi framework tree has two display modes - Bundles and Services. In the Bundles (default) mode, the main components of the tree are the bundles, organized by category. In the Services mode, the main components of the tree are the services registered in the OSGi framework.

Bundles Display Mode

You can observe the following hierarchy of components in the Bundles display mode:

Following is the complete structure provided by mToolkit including base features and available extensions.

• Framework
  • Bundles
    • Bundle category – Bundles are sorted by category according to the value of the Bundle-Category manifest header of the relevant bundle.

           Bundle node – Bundles are displayed by symbolic name as set in the corresponding Bundle-SymbolicName manifest header, or if the symbolic name is missing - by name as set in the corresponding Bundle-Name manifest header. If the Bundle-Name header is not available either, then the bundle is shown by its filename. Optionally, you can choose to display bundle IDs and bundle versions as well. This is done via respectively the Show Bundles IDs and the Show Bundle Versions commands that appear when you right-click a bundle. Depending on the state a bundle is in - started or stopped, the framework tree shows the bundle with different icons.

            Registered services – Contains all services currently registered by this bundle.

                      Service object class [Service ID] – Shows the service object class (aka service interface) under which a service of this bundle is registered. The ID of the service object implementing the object class is placed within the square brackets next to the object class name. Note that a single service object can be registered under more than one object class.

                       Service property (shown upon selecting Show Service Properties from Frameworks view's pull-down menu) – Represents a specific property that the service is registered with, such as objectClass, service.id, service.pid, etc.

            Used Services – Contains all services of other bundles in the OSGi framework used by this bundle.

                       Service object class [Service ID] – Shows the object class (aka service interface) of the used service object. The ID of the used service object implementing the object class is placed within the square brackets next to the object class name.

                       Service property (shown upon selecting Show Service Properties from Frameworks view's pull-down menu) – Represents a specific property that the used service is registered with, such as objectClass, service.id, service.pid, etc.

Services Display Mode

You can observe the following hierarchy of components in the Services display mode:

• Framework
  • Service – Services are shown by object class and with ID enclosed in square brackets. You can view the registration properties of a selected service by using the Properties command from the context menu.
    • Registered by – This node contains the bundle which has registered the service.

         Provider bundle node – Shows the bundle which has registered the service.

    • Used by – This node contains the bundles which are currently using the service.

         Consumer bundle – Shows the bundle which is using the service.