hans.hu

夫天地者,万物之逆旅也;光阴者,百代之过客也。而浮生若梦,为欢几何?古人秉烛夜游,良有以也。况阳春召我以烟景,大块假我以文章。

Integrate non-OSGi Dependencies

Consider a scenario where you need to use a non-OSGi jar in your OSGi project. Most libraries are not OSGi bundles and we should repackage all them with OGSi headers to be loaded into the OSGi container. There are several ways to help you with these non-OSGi dependencies:
  • Embed these jar files into your OSGi bundle
  • Wrap these jar files within one OSGi bundle

For instance, you need to utilize fastjson library to serialize/deserialize json object in your OSGi bundle.

Embed these jar files into your OSGi bundle
<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>2.4.0</version>
    <extensions>true</extensions>
    <configuration>
        <instructions>
            <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName>
            <Bundle-Version>${project.version}</Bundle-Version>
            <Bundle-Activator>com.example.demo.Activator</Bundle-Activator>
            <Export-Package>
                com.example.demo*;version=${project.version}
            </Export-Package>
            <Import-Package>
                !org.springframework.*,
                *
            </Import-Package>
            <Embed-Dependency>fastjson;scope=compile|runtime|system;inline=true</Embed-Dependency>
        </instructions>
    </configuration>
</plugin>

If you want a dependency inlined instead of embedded add the inline=true.
inline=true inline=true
manifest_1 manifest_2

Wrap these jar files within one OSGi bundle
Karaf supports the wrap:protocol execution, so it allows for directly deploying third party dependencies into OSGi container:
install -s wrap:mvn:com.alibaba/fastjson/1.1.37
You can also create a wrap bundle for a third party dependency. This bundle is simply a Maven POM that shades an existing jar and package into a jar bundle.
<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>2.4.0</version>
    <extensions>true</extensions>
    <configuration>
        <instructions>
            <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName>
            <Bundle-Version>${project.version}</Bundle-Version>
               <Import-Package>!org.springframework.*,*</Import-Package>
            <Private-Package>!*</Private-Package>
            <Embed-Dependency>*;scope=compile;type=!pom;inline=true</Embed-Dependency>
            <Export-Package>com.alibaba.fastjson*</Export-Package>                  
        </instructions>       
    </configuration>
</plugin>

References
http://karaf.apache.org/manual/latest-2.3.x/developers-guide/creating-bundles.html
http://felix.apache.org/site/apache-felix-maven-bundle-plugin-bnd.html
http://baptiste-wicht.com/posts/2010/03/bundle-non-osgi-dependencies-maven.html
http://maksim.sorokin.dk/it/2011/08/09/maven-apache-felix-strategy-to-handle-non-osgi-dependencies/

posted on 2014-12-22 17:58  hans.hu  阅读(738)  评论(0编辑  收藏  举报

导航