Libra/User Guide

From Eclipsepedia

Jump to: navigation, search

Installation

The Libra features can be installed from the p2 repository of the Indigo Simultaenous Release (since Indigo M6). As a prerequisite you may install Eclipse IDE for Java EE Developers.

The update site contains:

  • OSGi Bundle Facet feature that introduces:
    1. A new facet OSGi Bundle for Dynamic Web, JPA and Utility projects.
    2. Wizard for converting WTP standard projects to OSGi Enterprise bundle projects:
      • Dynamic Web projects to Web Application Bundle projects
      • JPA projects to Persistent Bundle projects
      • Utility projects and simple Java projects to OSGi Bundle projects
Both options modify project's MANIFEST.MF in order to become a valid OSGi bundle.

The facet may be enabled during the project creation or after that from the Properties page of the project. The wizard is available from project's context menu Configure > Convert to OSGi Bundle Projects...

Note that you may need to adjust your target platform accordingly.

LibraInstall.png

Create new Web Application Bundle

  1. Call the New Dymanic Web Project wizard: New > Project... > Web > Dynamic Web Project
  2. Enter the necessary project information like Project name, Target runtime, etc.
  3. Add the OSGi Bundle facet in the Configuration:
    1. Click on the Modify... button in the Configuration group.
    2. Choose the OSGi Bundle facet in the Project Facets dialog and click OK.
  4. Click Finish to create the Web Application Bundle project.

Configuring the Bundle Information and Bundle Dependency Graph editor parts

The Bundle Information and Bundle Dependency Graph editor parts are new features available since milestone 0.2 M3 (Juno M3). They appear in the server editor of the OSGi Framework server adapters (like Equinox, Felix and Knopflerfish). These editor parts display the state and the dependencies of the bundles that are installed in the OSGi Framework. They use the standard OSGi JMX Management Model for retrieving the necessary information from the OSGi Framework. The below steps shows how to enable OSGi JMX for your OSGi Framework.