The iPOJO Eclipse plugin is now hosted and supported in the iPOJO Toolbox project.
iPOJO is based on a byte code manipulation. So, it requires a different packaging process as "normal" bundle. This plug-in allow to build an "iPOJO bundle" directly from Eclipse. Moreover, by collaborating with BND (see http://www.aqute.biz/Code/Bnd), it simplifies the creation of bundles.
The plug-in requires Eclipse 3.3 (Europa) or higher. The plug-in can be installed from the following update site : http://clement.plop-plop.net/update/
Once installed, create a Java project to use the plug-in.
The new java project wizard appears. Enter the project name without spaces. Configure the Java project as you want.
Then, right click on the new project, go inside the iPOJO sub-menu and click on "create both files". This action will create two file in your java project. The $project_name.bnd file configure BND and contains the declaration of imported, private and exported packages. The second file (metadata.xml) contains the iPOJO bundle configuration.
As you create the two file, you should obtain something like :
Imagine that you implement a simple component displaying each message pushed inside the OSGi™ Log Service. The following code snippet shows one possible implementation of this component :
Once implemented, you need to fill out the BND file with following information:
Then, the metadata.xml file needs to be filled out. We declare the LogCons component type with a simple service requirement on the LogReaderService and two lifecycle callbacks. To finish, we declare an instance of this component type.
Once all is complete, we can build the bundle by doing a right-click on the metadata.xml file. Then go to the iPOJO sub-menu and click on Create Bundle.
If all is correctly configured, the following message appears, else warnings or errors are displayed in a message box too.
Your project contains now the build bundle. The bundle has the same name as your project.
- Create both files : create both the BND file and the metadata.xml file (replace existing one)
- Create metadata.xml file : create only the metadata.xml file
- Create BND file : create only the BND file
- Manipulate bundle: take an already created bundle and manipulate it. This option is use when you don't use BND to create a bundle
- Create bundle: create a bundle "from scratch", first create a bundle with BND and then manipulate it.
This page has presented the iPOJO Eclipe plug-in.
Subscribe to the Felix users mailing list by sending a message to email@example.com; after subscribing, email questions or feedback to firstname.lastname@example.org