Remark: With the release of the OSGi enterprise edition R7, OSGi-CDI integration is part of the specifications (chapter 152). The code here is before this release and should be handled as such. This means that it does not follow the standard although some ideas and solutions are similar.
Getting JEE7 to work in OSGi can be a real pain: there are a lot of (open source) projects going on to implement more or less the OSGi R5/R6 enterprise standard, but to integrate them is problematic. Not the least because of the dependencies that are required for some projects and mismatches in implementation versions.
The repository here is meant as a one-stop solution for the following JEE7 standards on OSGi:
- CDI 1.2. Implemented using the Weld CDI reference implementation, that can be downloaded here.
- JPA 2.1. Implemented using the standard JPA 2.1 interfaces only and tested with Eclipselink (although it works with Hibernate as well).
- JTA 1.1. A transaction manager that can be used in local solutions in case of the absence of a genuine transaction manager.
- JSF 2.2. The standard JSF solutions are OSGi aware, but this extender helps in integrating CDI with JSF. For this a standard OSGi web extender is needed with some additional functionality for finding Faces configuration files and tag libraries. This is functionality provided by the web extender present in this project although also alternatives can be used, like PAX-WEB.
Documentation about the usage of this extender can be found here.
The extenders are split over multiple bundles, so you are able to use either JPA/JTA only, CDI only, CDI + JSF or the whole package together.
To set-up the environment, perform the following actions:
- Download an eclipse version with plugin development enabled, for example the JEE version.
- Import all the projects from this repository.
- Open the file Runtime/Target.target in eclipse.
- And set it as target environment.
Code is written using Java 8 lambdas and streams, so you need Java 8.