Willemers Informatik-Ecke: Tomcat als Entwicklungsplattform

Tomcat und Eclipse

Eclipse als IDE verträgt sich sehr gut mit Tomcat als Application-Server.

Ergänzung von Eclipse zur JEE-Plattform

Dieser Schritt ist nur erforderlich, wenn Sie nicht die JEE-Variante von Eclipse installiert haben.

Damit unter Eclipse JEE-Anwendungen erstellt werden können, installiert man entweder die JEE-Version von der Eclipse-Homepage oder installiert WTP (Web Tools Platform nach.

Im Eclipse wird der Menüpunkt Help | Install New Software aufgerufen.
Im Dialog wird die Klappbox Work with geöffnet. Darunter befindet sich die Update-Site der Eclipse-Version. Diese anwählen.
Nach einem Augenblick des Wartens füllt sich die Liste. Darin wird der Punkt Web, XML, Java EE Development and OSGi Enterprise Development mit einem Haken ausgewählt.
Die Installation wird per Next über die nächsten Dialoge vervollständigt.
Zum Schluss möchte Eclipse neu starten.

Tomcat in Eclipse-JEE integrieren

Um mit Tomcat spielen zu können, ist es nicht einmal erforderlich, dass Tomcat separat installiert ist. Das kann aus dem Eclipse heraus erledigt werden.

Voraussetzung: Eclipse JEE ist installiert (getestet mit 2021-09)

Einrichten des Servers

Aus dem Hauptmenü aufrufen: New | Other | Server-Server
Button Next drücken
Im Dialog Define a New Server wählt man Apache/Tomcat v9.0 Server aus und klickt Next.
Man klickt auf Download and Install ...
Hier wird das Wurzel-Verzeichnis angegeben, in dem der Server später residiert. Ich habe hier einen Überordner Tomcat angelegt, in dem später die verschiedenen Tomcat-Versionen Platz finden.
Nun müssen noch die Lizenzbedingungen akzeptiert werden. Dann kann Finish geklickt werden.

Anschließend zieht Eclipse den Tomcat-Server aus dem Internet, installiert ihn unterhalb des angegeben Verzeichnisses und bereitet die gesamte Arbeitsumgebung vor.

Test der Entwicklungsumgebung

Erstellung eines JEE-Projekts

Zum Testen wird nun ein Web-Projekt angelegt und ausprobiert.

Das Projekt wird über das Menü angelegt: File | New | Project.
Im Dialog findet man unter dem Punkt Web das Dynamic Web Project. Mit Next geht es zur nächsten Dialogseite.

Projektname kann beispielsweise DynWebProj sein. Als Target Runtime wird Apache Tomcat verwendet. Nach dem Next-Klicken erscheint auf der letzten Seite Generate web.xml deployment descriptor. Den kann man anhaken, muss man aber nicht.

Sollte an dieser Stelle der Server Name leer bleiben und auch nicht beschreibbar sein, kann folgender Workaround verwendet werden:

Eclipse beenden.

Auf der Konsole ins Arbeitsverzeichnis wechseln, beispielsweise:

cd ~/workspace
cd .metadata/.plugins/org.eclipse.core.runtime/.settings
rm org.eclipse.wst.server.core.prefs
rm org.eclipse.jst.server.tomcat.core.prefs

Eclipse wieder starten.

Im Projekt ein Servlet erstellen

Um das Projekt zu testen, erstellen wir ein Servlet:

Das Projekt rechts anklicken: New | Other | Web | Servlet.
Der Name des Servlets wird angegeben. Er ist auch für die URL wichtig, mit der das Servlet gerufen wird.
```
http://hostname:8080/WebProjektName/ServletName
```
Falls Finish nicht möglich, ist der Server Tomcat noch nicht eingerichtet.

Eclipse erzeugt einen Quellcode für das Servlet. In der Methoe doGet wird folgende Anpassung vorgenommen:

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // TODO Auto-generated method stub
    response.getWriter().println("<h1>Hallo</h1>");
}

Den Server Tomcat im Eclipse starten.
Die oben angegebene URL in einem Browser eingeben. Nun sollte das Wort Hallo in großen Buchstaben erscheinen.