I got a lot of hits to my article about how to connect an Eclipse Rich Client Project to JBoss and EJB 3. Most of these hits came from people outside of germany and they left right after entering the page. So I think that there is some interest in an english version of this article.

Our goal

We want to create an Eclipse Rich Client Project (RCP for now on) consisting of the RCP-plugin and a second plugin containing the JBoss client JARs. To keep things simple, the EJB-Classes will be hold directly in the RCP-Plugin. In a later article I will show how to extract the business-classes in an extra plugin to ensure better maintainablity.

The problem

The OSGI-Classloader from Eclipse creates an extra Classpath for any plugin it loads. Classes from other plugins are therefore invisible. This behavior is pretty good in generel because it allows Eclipse e.g. to enable or disable plugins at runtime. But sometimes it is necessary to give plugin A access to classes in plugin B. This can be archived by declaring a dependency between A and B.

But for our problem we need access in both directions. Our RCP needs “to see” the JBoss classes and JBoss needs access to our EJBs. And because this is not possible you will get a lot of

Javax.naming.CommunicationException [Root exception is java.lang.ClassNotFoundException: bz.jmc.blog.tutorial.rcp_with_jboss.ejb.MyTestStatelessSessionRemote (no security manager: RMI class loader disabled)]

and other errors.

The solution

As mentioned above, you can’t set a dependency in both directions. We need another solution for this particular problem and this solution is called “Buddy Classloading”. So it is possible to “open” one plugin for others. Other Plugins can register as a buddy and give access to their classes.

In some upcoming articles I will create a small tutorial project with screenshots, illustrating the buddy classloading solution.

• Part 2
• Part 3
• Part 4
• Part 5

English language version here

Als ich neulich das erste Mal aus einer Eclipse RCP heraus auf JBoss zugreifen wollte, bekam ich gleich die unschönen Seiten des OSGI-Classloading zu spüren. Meine Suche im Web nach einer Lösung förderte eigentlich nur die Fragen von anderen zu diesem Thema zu Tage. Daher nun hier mein Versuch, ein kleines Howto zu schreiben damit andere schneller zu einem funktionierendem Ergebnis kommen.

Das Ziel

Ziel soll sein, ein Eclipse Rich Client Project (ab jetzt nur noch RCP) zu erstellen, dass aus dem eigentlichen RCP-Plugin und einem Plugin mit den JBoss-Client-Bibliotheken besteht. Die EJB-Klassen werden wir in diesem Fall erstmal direkt in das RCP-Plugin integrieren, in einem späteren Beitrag werden sie dann, zwecks besserer Wartbarkeit, in ein eigenes Plugin ausgelagert. Die Anwendung soll dann ihre Daten als Session- und Entity-Beans vom JBoss beziehen.

Das Problem

Der OSGI-Classloader von Eclipse erzeugt für jedes geladene Plugin einen eigenen Classpath. Die Klassen von anderen Plugins sind dadurch unsichtbar. Dieses Vorgehen ist auch sinnvoll, denn es ermöglicht unter anderem das (de-) aktivieren von Plugins zur Laufzeit der Anwendung. Sofern ein Plugin (nennen wir es A) sich als Abhängig von einem anderen Plugin (B) erklärt (unter Dependencies im Plugin-Editor) werden die Klassen von B für A sichtbar.

In unserem Falle benötigen wir aber eine beidseitige Sichtbarkeit. Unser RCP muss die JBoss-Klassen sehen und JBoss muss die im RCP vorhandenen EJB-Klassen sehen können. Ist dies nicht gegeben hagelt es

javax.naming.CommunicationException [Root exception is java.lang.ClassNotFoundException: bz.jmc.blog.tutorial.rcp_with_jboss.ejb.MyTestStatelessSessionRemote (no security manager: RMI class loader disabled)]

und ähnliche Fehler.

Die Lösung

Da nicht beide Plugins sich gegenseitig unter Dependencies angeben können benötigen wir eine andere Lösung. Die heisst für uns “Buddy Classloading”. Hiermit wird es möglich, dass sich ein Plugin schon während der Implementierung für die Klassen von anderen Plugins “öffnet”. Andere Plugins können sich so als Buddy registrieren und Ihre Klassen dem anderen Plugin zur Verfügung stellen.

Auf den folgenden Seiten habe ich ein kleines, mit Screenshots versehenes Tutorial zusammengestellt, dass die Lösung anhand eines einfachen Beispiels erläutert.

Seit einiger Zeit versuche ich mir das Thema Java EE näher zu bringen. Bisher habe ich dazu 3 deutschsprachige Bücher gelesen, die sich alle aber noch mit J2EE 2.1 beschäftigt haben. Mit Version 2.1 ist das Thema aber doch sehr komplex sodass ich kurz davor war meine Bemühungen einzustellen.

Seit der JavaOne 2006 ist aber ja nun die neue Spezifikation 3.0 für Java EE final und vereinfacht das ganze Modell doch erheblich. Und O’Reilly hat gerade eines der ersten Bücher veröffentlicht die sich dediziert mit 3.0 beschäftigen.

Einen Nachteil, den das Büch für viele deutschsprachige hat, will ich vorweg nicht verschweigen: es ist z.Zt. noch ausschließlich in der englischen Originalversion erhältlich. Wer des Englischen aber einigermaßen mächtig ist wird mit dem Buch gut zurechtkommen.

“EJB 3.0″ ist sehr strukturiert aufgebaut. Nach 2 Kapiteln mit einer Einleitung und einem generellen Überblick über die Java EE Architektur werden in den folgenden 19 Kapiteln alle Aspekte von Java EE behandelt. Neben den grundlegenden Bean-Typen, die in aller Ausführlichkeit besprochen werden, widmet sich das Buch sehr intensiv der Java Persistence API. Anhand von vielen Beispielen werden alle Möglichkeiten der Objekt-Relationalen Abbildung erleutert.

Um dem Leser die Einordnung des gelernten in einen realen Kontext zu ermöglichen entwickeln die Autoren durch das gesamte Buch hindurch ein Buchungssystem für eine virtuelle Kreuzfahrtlinie namens “Titan Cruises”. Die Anwendung wird mit jedem Kapitel fortentwickelt. Themen wie Webservices und Security werden anhand von externen Reisebüros erklärt, die ebenfalls Zugriff auf das Buchungssystem benötigen.

Ein besonderes Schmankerl für alle an JBoss Interessierten ist der zweite Teil des Buches. Als Arbeitsbuch gehalten wird die konkrete Umsetzung der vorherigen Kapitel mit JBoss erläutert. Dies muß auch nicht wirklich verwundern, da der Autor Bill Burke “Chief Architect” bei JBoss Inc. ist.

Das das Buch sehr aktuell ist (15.05.06), zeigte sich schon auf dem Klappentext. Dort wird schon erwähnt, das JBoss nun zu RedHat gehört.

Abschliessend kann ich mich dem ebenfalls auf dem Klappentext zitierten Marc Fleury (CEO JBoss) nur anschliessen: “If you work on Enterprise applications, this is the only EJB book you need”.

Enterprise JavaBeans 3.0
Bill Burke & Richard Monson-Haefel
O’Reilly, 5. Auflage
ISBN: 059600978X
733 Seiten