07.04.2017
(Wow das Bild dieses Beitrages ist so schön, gibt es mehr davon? Ja, gibt es hier)
Im Artikel Zwei WARs kommunizieren auf einem Tomcat habe ich beschrieben, wie zwei WAR Dateien, also zwei Webapplikationen, auf einem Tomcat miteinander kommunizieren können. In diesem Beitrag mache ich ein konkretes, kleines Codebeispiel. Ich verwende dabei EclipseEE, welche speziell für Java EE Developers gemacht wurde.
Den Code zu diesem Artikel kann in folgendem ZIP heruntergeladen werden:
Klick mich für Code Download
MD5 Hash der Datei: 4de528a30d236dc2526f98da02c52fbf
(Kann etwa mit dem kostenlosen Tool WinMD5Free überprüft werden)
1. Erste Webapplikation erstellen
Als Erstes erstelle ich eine erste Webapplikation namens War1. Dazu gehe ich in Eclipse auf File -> New -> Dynamic Web Project und gebe den Projektnamen ein. Ein Klick auf Add project to working sets stellt sicher, dass das Projekt gleich in der Projektliste angezeigt wird. Mit Finish erstelle ich das Projekt.
Damit das Projekt im Browser angesprochen kann, mache ich als nächstes ein kleines Servlet. Dazwischen erstelle ich aber noch ein eigenes Package. Dazu rechtsklicke ich auf den src Folder und wähle New -> Package und gebe ihm den Namen war1package. Dann rechtsklicke ich auf das neue Paket und wähle New -> Servlet und gebe dem Servlet den Klassenname War1Servlet.
Falls Klassen wie HttpServletRequest nicht gefunden werden können halte ich die Maus über die Klasse und wähle im erscheinenden Dialog Fix Project setup und dann Add tomcat-embed-core-8.0.28 to build path of War1. Dies wird in Kapitel 4. Drei Maven Projekte machen mit einer Maven Dependency gefixt.
Erstellt man das Servlet auf diese Weise, wird automatisch eine doGet und doPost Methode inklusive dem HttpRequest und Response als Parameter angelegt. Im doGet erstelle ich nun für das Beispiel einen PrintWriter für eine einfache HTML Page.
War1Servlet doGet Methode:
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
PrintWriter writer = response.getWriter();
writer.println("<html>");
writer.println("<head><title>Hello World Servlet 1</title></head>");
writer.println("<body>");
writer.println("<h1>Hello World from Servlet 1!</h1>");
writer.println("</body>");
writer.close();
}
Das Servlet kann jetzt bereits auf einen Tomcat geladen und gestartet werden. Im Tab Servers erstelle ich mit New -> Server einen Tomcat 8.0 Server. Im Dialog Add and Remove… lade ich das neue War1 auf den Server und starte diesen anschliessend.
Gehe ich nun im Browser auf http://localhost:8080/War1/War1Servlet sehe ich, wie mir das Hello World from Servlet 1! beinahe ins Gesicht springt. Die erste Beispiel-Webapplikation ist bereit.
2. Webapplikation erstellen
Nun erstelle ich eine zweite Webapplikation genau wie im vorherigen Kapitel, einfach mit War2 als Projekt und War2Servlet als Servletname. Im doGet kann ich den gleichen Code verwenden, um zu testen, ob es funktioniert – Bitte nicht vergessen, das Projekt dem Tomcat ebenfalls hinzuzufügen und den Tomcat neu zu starten.
Am Ende habe ich also zwei lauffähige Beispielapplikationen und will nun erreichen, dass War2 eine Methode SecretCode aus War1 aufrufen kann.
3. Shared Jar erstellen
Damit die zwei Applikationen miteinander sprechen können, müssen wir ein geteiltes Java Archiv erstellen, in welchem die Schnittstellen als Interfaces abgespeichert sind. Das hat den Vorteil, dass jede der beiden Parteien genau wissen, wie die Signaturen der einzelnen Methoden aussehen.
Ich mach also noch ein Projekt, dieses mal aber ein normales Java Projekt! New -> Java Project und nenne es SharedSecretCode.
Darin erstelle ich erstmal ein Interface namens SecretCode mit der Methode executeSecretCode. (Ich weiss, das ganze Projekt hat eigentlich nichts mit Security zu tun, mir gefällt einfach die Vorstellung, dass eine WAR Datei quasi den geheimen Code der zweiten WAR Datei ausführt.)
SecretCode.java:
public interface SecretCode {
void executeSecretCode();
}
Was wir nun noch brauchen, ist ein eine InstanceHolder Klasse. Diese Klasse fungiert dabei als Singleton, es gibt sie also nur einmal beziehungsweise der InstanceHolder muss nicht instanziert werden. In diesem Holder erstellen wir ein Typ von dem eben erstellten SecretCode Interface inklusive Getter und Setter. Das Ziel ist es, dass War1 eine SecretCode Instanz erstellt, diese im InstanceHolder setzt und War2 dann auf diese Instanz mit dem Getter zugreifen kann.
Also auf das Package New -> Class und den InstanceHolder reingepappt. Merke: Da der Holder statisch ist, braucht es keine setInstance() Methode.
Holder.java:
public class Holder {
// Klasse ist ein Singleton
private static Holder instance = new Holder();
private SecretCode service;
public static Holder getInstance() {
return instance;
}
public SecretCode getService() {
return service;
}
public void setService(SecretCode service) {
this.service = service;
}
}
Am Besten richtet man sich den Projektaufbau so ein, dass man vom SharedSecretCode gleich eine richtige JAR Datei erstellt und diese in den Projekten War1 und War2 als externe JAR Datei importiert. Das kann ich mit der Hilfe von Maven machen.
4. Drei Maven Projekte machen
Aus den drei Projekten mache ich nun drei Maven Projekte. Dazu rechtsklicke ich auf ein Projekt und wähle configure -> convert to maven project. Eclipse wird mir dann in jedem Projekt ein pom.xml erstellen.
In jedem Projekt muss ich nun noch eine Configuration laufen lassen, damit das Projekt gebuilded wird. Der Prozess ist dabei bei jedem Projekt gleich: Ich rechtsklicke etwa das pom.xml vom Projekt SharedSecretCode und wähle Run As -> Maven Build… (mit den drei Punkten!) und fülle folgendes aus:
Name: SharedSecretCode clean install Goals: clean install
Und diesen Build lasse ich dann mit Run laufen. Alle drei Projekte sollten von Maven auf ein BUILD SUCCESS kommen, damit alles stimmt.
Im Projekt SharedSecretCode wird dabei eine Datei SharedSecretCode-0.0.1-SNAPSHOT im Ordner target erstellt.
Im pom.xml von War1 und War2 füge ich noch die korrekte Version des tomcat-servlet-api ein, damit er Klassen wie HttpServletRequest findet. Maven braucht das JAR File ebenfalls als Maven Dependency, damit er zufrieden ist.
War1 und War2 pom File:
<dependencies>
<dependency>
<artifactId>SharedSecretCode</artifactId>
<groupId>SharedSecretCode</groupId>
<version>${project.version}</version>
<scope>system</scope>
<systemPath>C:\eclipseWorkspaces\SpringEE\SharedSecretCode\target\SharedSecretCode-0.0.1-SNAPSHOT.jar</systemPath>
</dependency>
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-servlet-api</artifactId>
<version>8.0.43</version>
<scope>provided</scope>
</dependency>
</dependencies>
Nicht vergessen, die War1 und War2 ebenfalls mit clean install laufen zu lassen, damit die entsprechenden Pakete runtergeladen werden. Falls irgendwelche Fehlermeldungen kommen, ist es nie schlecht, einen Rechtsklick auf die Projekte zu machen und Maven -> Maven -> Update project laufen zu lassen.
5. Den SecretCode im War1 implementieren
Im War1 mache ich nun eine konkrete Implementation von dem Code, der von War2 ausgeführt werden soll. Ich nenne die Klasse SecretCodeImpl und implmentiere das vorher erstellte Interface SecretCode.
SecretCodeImpl.java:
public class SecretCodeImpl implements SecretCode {
public void executeSecretCode() {
System.out.println("Ich bin der supergeheime Code aus SecretCodeImpl");
}
}
Das Ziel ist also, dass War2 die Methode executeSecretCode ausführen kann. Sobald dies geschafft ist, ist es egal, was sich hinter dieser Methode verbirgt. Die Methode könnte Daten aus einer Datenbank lesen oder ein Programm ausführen, ganz egal. In diesem Beispiel mache ich einen einfachen println zur Demonstation.
6. SecretCodeImpl dem InstanceHolder übergeben.
Den aufzurufenden Code habe ich jetzt, nun erstelle ich im doGet von War1 eine Instanz von SecretCodeImpl und übergebe diese dem InstanceHolder, damit später War2 darauf zugreifen kann. Merke dass hier die Klassen Holder und SecretCode importiert werden müssen, damit diese bekannt sind.
Nötige Imports:
import mypackage.Holder;
import mypackage.SecretCode;
War1Servlet doGet Methode:
// Hier wird die Implementation dem Holder Singleton übergeben
SecretCode secretCode = new SecretCodeImpl();
Holder.getInstance().setService(secretCode);
System.out.println("Holder Instanz gesetzt");
7. Den geheimen Code im War2 aufrufen
Der letzte Schritt ist nun, den geheimen Code in War2 aus dem InstanceHolder zu holen und die entsprechende Methode aufzurufen. In der doGet Methode im War2 hole ich die Instanz und rufe die Methode auf. Auch bei War2 müssen die zwei Klassen importiert werden, damit diese bekannt sind.
Nötige Imports: import mypackage.Holder; import mypackage.SecretCode; War2Servlet doGet Methode: SecretCode secretCode = Holder.getInstance().getService(); secretCode.executeSecretCode();
8. Es funktioniert nicht -> Shared Jar konfigurieren
Probiere ich jetzt, den Server zu starten, kriege ich eine Fehlermeldung:
Caused by: java.lang.NoClassDefFoundError: mypackage/SecretCode
Jetzt kommt der eigentliche Trick hinter dem ganzen Zwei WAR Dateien kommunizieren miteinander: Die zwei WAR Files haben zwar beide das Shared JAR als Abhängigkeit drin, es handelt sich aber jeweils um eine eigene Kopie – Beziehungsweise der Classloader jeder Webapplikation lädt sein eigenes JAR. Siehe auch die Theorie im Artikel Zwei WARs kommunizieren auf einem Tomcat
Ich sage den zwei WAR Dateien nun, dass sie dasselbe JAR verwenden sollen. Sie sollen beide das JAR vom Shared ClassLoader erhalten beziehungsweise auf das gleiche JAR zugreifen.
Dazu muss ich den Shared Loader Eintrag in der Datei Catalina.Properties um die Class Dateien des Shared JAR ergänzen.
catalina.properties ist normalerweise im Installationsordner von Tomcat – Meistens gibt es aber eine eigene Kopie. Der einfachste Weg, um den Pfad zu finden, ist es, den Server zu starten und nach dem Eintrag CATALINA_BASE Ausschau zu halten.
INFORMATION: CATALINA_BASE: C:\eclipseWorkspaces\SpringEE\.metadata\.plugins\org.eclipse.wst.server.core\tmp0
In diesem Ordner hat es einen Unterordner Conf und darin findet sich die catalina.properties Datei.
Darin ergänze ich den Eintrag Shared Loader um den Pfad zu SharedSecretCode -> Target -> Classes.
shared.loader=C:/eclipseWorkspaces/SpringEE/SharedSecretCode/target/classes
Merke dass man Schrägstriche verwenden muss und nicht Backslashes wie in Windows Explorer.
9. Fertig -> Geheimen Code aufrufen
Ist alles kompiliert und der Tomcat neu gestartet, kann es also losgehen. In diesem Beispiel muss ich zuerst http://localhost:8080/War1/War1Servlet aufrufen, damit der InstanceHolder gesetzt wird (sonst gibt es eine NullPointerException). In einem echten Projekt würde man diesen Code etwa beim Start des Tomcats ausführen lassen.
In der Konsole sehe ich nach dem Aufruf von Web1Servlet:
Holder Instanz gesetzt
Wenn ich im Browser dann http://localhost:8080/War2/War2Servlet aufrufe, sollte aus War2 der geheime Code von War1 ausgeführt werden.
Und tatsächlich sieht man in der Konsole den println:
Ich bin der supergeheime Code aus SecretCodeImpl
War2Servlet hat also den Code aus War1Servlet über das SharedJar hinaus ausgeführt.
Zero Knowledge My A$$ 