Creating a plugin system with Karaf and OSGi µServices


When we started to design calvaDrive, it became clear that we can only achieve true feature flexibility if we implement a plugin system. Of course we could have created it from scratch, but why? If you implement a plugin system you have to think about dynamics, class loaders, interfaces and a couple of other things you do not even have in mind until they ruin your schedule. On the other hand we already had begun to use OSGi to split our monolithic application into small modules.

OSGi and µServices

If you have never heard of OSGi before, it may be worth to have a look at it. In short it is a Java-based framework which supports modularization by encapsulating JAR files (called OSGi bundles). The OSGi Alliance provides a nice overview as well as all specifications.

One of the key features of OSGi is the service registry which allows to implement µServices. The concept of µServices was created by Peter Kriens and described in a blog post back in 2010. Though they sound like Microservices, they are in fact older and much more light-weight. Microservices are designed to split monolithic business applications into smaller parts, which are distributed across several nodes in a network. OSGi and µServices also help you to break up your monoliths, while still running on a single JVM. Therefore, µServices do not require all that network communication overhead but still give you the ability to design clean interfaces and to separate them from their implementations.

OSGi enables dynamism, class loaders and interfaces. It introduces a component model and services. And it also allows you to install, update and remove code bundles at runtime – everything you need to build a plugin system. But before you can start, you need to choose an OSGi server implementation which runs your application and the plugin code. For calvaDrive, we have decided to use Apache Karaf. It offers all the aspects you need to build an OSGi application and can easily be extended to a full-featured web server using a concept called features. A feature is essentially a group of bundles with optional dependencies and configuration data. Karaf already provides features to install, e.g. a Jetty web server or JPA support.

Karaf provides base functionality for plugin system

Karaf enables us to build calvaDrive as modern modular web application consisting of one hundred OSGi bundles at the moment (not counting third-party dependencies like Apache Commons). The core application defines extension points for plugins as Java interfaces. A plugin implements the extension point interface and provides its implementation as µService. But a plugin might not only consist of one bundle – it might integrate several bundles, configuration data and dependencies. Sounds familiar? Karaf not only provides for us OSGi support, it also helps us to install plugins. In fact, our plugins are just Karaf features. They become installed using the Karaf Feature Service – which is provided as OSGi service, itself.

One of our first plugins we created was the Watch System plugin. The plugin can be installed on-the-fly without a restart of calvaDrive. After activation, it provides new options in the menus for observing a file or folder. If an observed file is downloaded, the system sends an e-mail to the observer. For this purpose, we have implemented an extension point in the context menu. The core application detects registered extensions and delegates all rendering and execution tasks to that extension. If the plugin becomes uninstalled, the menu options disappear and no e-mails will be send in the future.


OSGi µServices provide you with the architectural power of Microservices but without network overhead. They are perfect if you want to break up a monolithic application into small manageable pieces of code. And they help you to comply with principles like SOLID. Apache Karaf is an extendible OSGi server offering many useful features with it. Together, µServices and Karaf helped us to build a flexible plugin system for calvaDrive.

Zurück zur Übersicht

2 Kommentare zu “Creating a plugin system with Karaf and OSGi µServices

  1. Hey Lkvb, nice to see more people using Karaf and OSGi!
    In calvaDrive, we use a hashing mechanism to validate plugins before installing them. Since we create the plugins ourself, we just update the list of allowed hashes when needed. The hash is calculated based on the released plugin archive.
    When opening the system for third-party developers, this might be too cumbersome, unless you want to establish some kind of manual validation process (like Apple does with the AppStore).

    Regarding plugin updates: the calvaDrive plugins consist of the karaf feature and additional metadata. Our plugin manager reads the metadata, which also contains the plugin version. If a newer plugin is installed, the manager removes the old plugin feature and installs the new one.
    The plugin manager is an OSGi service itself and can be used via REST or our admin interface. Basically, we store the list of currently installed plugins (including the version) and use that information to process plugin updates.

  2. Hello I have seen that you have created a plugin based architecture in your application. I am currently also developing a plugin system using osgi karaf. I have developed it so far that I am able to recognize plugins with core application etc.

    But I was wondering how you would validate a plugin to the core application. Because I want third party developers able to make plugins too and on what basis would you want the plugin to be used by the core application? Based on registration to the core application by for example checking if the plugin has registered to the core application with a token or something?

    Also how would you handle the update of plugins? Do you have a kind of osgi plugin manager?

    I am looking forward to your reply.

Kommentar verfassen

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert