Enterprise-OSGi-Anwendungen werden nicht selten als Webanwendungen umgesetzt. Damit diese Kombination gelingt, muss der verwendete Servlet Container in der Lage sein, auch im Umfeld von OSGi betrieben werden zu können. Wie verbindet man Jetty mit OSGi und welche Möglichkeiten gibt es, Webanwendungen zu betreiben?
Building a tool based on Eclipse
Jetty als Alternative zu Apache Tomcat bietet erstaunlich viele Möglichkeiten. So kann man einen Jetty-Server als HTTP-Server betreiben. Anders herum existieren in der Jetty-Distribution Bibliotheken, um HTTP-Clients zu realisieren. Die Entwicklung und der Betrieb von REST- und neuerdings auch WebSocket-Anwendungen gehören ebenso ins Portfolio. Über Jetty im Allgemeinen und WebSocket im Besonderen haben wir in vergangenen Ausgaben des Eclipse Magazins bereits ausführlich berichtet [1]. Auch wenn alle genannten Möglichkeiten sinnvolle Funktionen darstellen und man sich das Schreiben moderner Webanwendungen ohne REST und WebSocket kaum noch vorstellen kann, ist und bleibt Jetty in erster Linie jedoch ein Servlet Container zum Betrieb von Webanwendungen. In der aktuellen Version 9.1 werden alle hierfür relevanten Protokolle unterstützt: HTTP/1.1, RFC2616, WebSocket, SPDY und natürlich Servlet 3.0/3.1 und JSP 2.2.
Vielfältige Einsatzmöglichkeiten ...
Ein Jetty-Server kann auf unterschiedliche Weise betrieben werden. Der klassische Betriebsmodus ist zugleich auch der einfachste: Man lädt die Jetty-Distribution herunter, installiert diese und betreibt den Server anschließend auf ähnliche Weise wie Apache Tomcat. Über ein Shellscript im bin-Ordner wird der Server gestartet und gestoppt, und über die Konfigurationsdateien (verteilt über die ganze Distribution) wird die Umgebung eingerichtet. Analog zu Apache Tomcat gibt es ein webapps-Verzeichnis, in das Webanwendungen (.war) deployt werden können. Wer Maven einsetzt, kann Jetty direkt in sein Projekt einbinden und während der Entwicklung bei Bedarf einen eingebetteten Jetty-Server starten, um die gerade in Entwicklung befindliche Webanwendung zu testen oder zu debuggen. Selbstverständlich lassen sich die Jetty-Bibliotheken auch in eigene Softwareprojekte einbinden und Jetty komplett eingebettet betreiben. Über das bereitgestellte API lassen sich Serverinstanzen konfigurieren, hochfahren, programmatisch Servlet-Kontexte generieren und Servlets oder ganze Webanwendungen bereitstellen. Die Möglichkeiten gehen hier so weit, dass man in der Lage ist, mit nur einer JAR-Datei, die ausgeliefert wird, eine komplette Webanwendung bereitstellen zu können.
... bis hin zu OSGi
Jüngst, und damit sind wir beim Thema dieses Artikels angekommen, scheint ein weiterer Jetty-Betriebsmodus immer populärer zu werden: Jetty in OSGi. Im Umfeld der so genannten Enterprise-OSGi-Anwendungen (früher sprach man hier auch von „Server-side OSGi“) geht es darum, Enterprise-Java mit den Vorzügen der Modularität von OSGi zu verbinden. Das Frontend oder UI solcher Anwendungen besteht dabei meist aus einer Webanwendung. Um eine solche bereitzustellen, muss der dahinterliegende Servlet Container eben auch in der Lage sein, sich in eine OSGi Runtime wie beispielsweise Eclipse Equinox [2] oder Apache Felix [3] einbringen zu lassen. Dieser Artikel soll zeigen, wie man ausgehend von einer frischen Equinox-Installation die Umgebung so konfiguriert, dass Jetty 9 in dieser laufen kann. Außerdem soll gezeigt werden, wie man eine einfache Webanwendung, die als .war-Datei vorliegt, zu einem OSGi Bundle macht und welche Möglichkeiten es gibt, diese innerhalb der OSGi-Umgebung bereitzustellen. Für den Betrieb von Webanwendungen im Umfeld von Enterprise OSGi gibt es bereits eine Vielzahl von vorkonfigurierten OSGi-Laufzeitumgebungen: Egal, ob Sie auf Apache Felix, Eclipse Equinox oder auf Server wie Virgo zurückgreifen, meistens sind Bundles für den Betrieb von Servlet-basierten Webanwendungen bereits enthalten, und nicht selten basieren diese auf Jetty. Besorgt man sich eine aktuelle Equinox-Distribution, ist neben der eigentlichen OSGi-Plattform eine Vielzahl weiterer Bundles an Bord. Jetty ist auch dabei, allerdings in etwas älterer Version. Da wir mit der aktuellen Version 9 von Jetty arbeiten wollen, ist es also sinnvoll, sich zunächst die neueste Jetty-Version entweder über Maven zu besorgen oder die Standarddistribution [4] herunterzuladen, in der die meisten der benötigten Dateien enthalten sind.
Vorbereitungen
Ziel des Artikels ist es, quasi „from scratch“ zu beschreiben, wie man Jetty mit OSGi zusammenbringen kann. Deswegen und vor allem, um den Überblick über die verwendeten Bundles zu behalten, benutzen wir möglichst wenige Bundles aus der Equinox-Distribution selbst. Eigentlich benötigen wir zu Beginn lediglich das org.eclipse.osgi-Bundle, das sich im Plug-ins-Verzeichnis der Equinox-Distribution findet. Um mit der OSGi-Umgebung interagieren zu können, etwa um zu sehen, welche Bundles installiert sind, in welchem Status sie sich befinden usw., bietet sich die Verwendung der OSGi-Konsole an. Diese wurde früher mit folgendem Aufruf gestartet:
java –jar org.eclipse.osgi_3.9.1.v20130814-1242.jar –console
Leider funktioniert dieser Aufruf in den neuesten Equinox-Versionen so nicht mehr, da die Konsole modernisiert wurde. Es gibt nun zwei Möglichkeiten, um die Konsole zu starten: Entweder man sorgt dafür, dass neben der bereits genannten JAR-Datei noch mindestens vier weitere Bundles (Kasten: „OSGi Bundles starten“) gestartet werden, oder man benutzt einfach den Schalter
osgi.console.enable.builtin=true
um die (nach wie vor enthaltene) alte Shell zu reaktivieren. Legen Sie sich bitte ein neues, leeres Verzeichnis an, kopieren Sie das org.eclipse.osgi Bundle aus dem Plug-ins-Verzeichnis in diesen neuen Ordner und starten Sie die Konsole mit folgendem Aufruf:
java –Dosgi.console.enable.builtin=true –jar org.eclipse.osgi_3.9.1.v20130814-1242.jar –console
Wenn man in der Konsole jetzt den Befehl ss zur Auflistung aller Bundles in der aktuell laufenden OSGi-Umgebung ausführt, stellt man fest, dass nur das soeben gestartete org.eclipse.osgi Bundle läuft. Sauberer und übersichtlicher geht es eigentlich nicht. So kann es jetzt auch schon mit der Jetty-Integration losgehen. Jetty macht uns das Einbinden...

