Willemers Informatik-Ecke: Eclipse und Glassfish

JDK-Installation

Stand 2018: Es gibt Probleme mit Java Version 9 bis 11. Alle Installationen sind darum für Java Version 8 (bzw. 1.8) beschrieben.

Die Java-Version können Sie von der Seite von Oracle herunterladen:

www.oracle.com/technetwork/java/javase/downloads

Linux-Anwender können das OpenJDK aus dem Repository installieren. Achten Sie aber darauf, dass es sich um die Version 1.8 und nicht 1.11 handelt.

Eclipse-Installation

Für die JEE-Entwicklung wird eine JEE-Version von Eclipse benötigt. Glassfish ist die JEE-Referenzimplementierung. Also wollen Sie vermutlich Eclipse für JEE haben. Achten Sie darauf beim Download.

www.eclipse.org/downloads/packages

Glassfish-Installation

Auf der folgenden Seite erhalten Sie unter dem Namen Java EE 8 SDK den Glassfish in der Version 5 angeboten.

http://www.oracle.com/technetwork/java/javaee/downloads/index.html Unter dem Link Previous Releases gelangen Sie zum Download der Version 4. Dort finden Sie unter dem Schriftzug Java Platform, Enterprise Edition 7 SDK Update 3 die Datei java_ee_sdk-7u3.zip zum Download angeboten. Akzeptieren Sie zunächst die Lizenzbedingungen, sonst gelingt es nicht.

Die ZIP-Datei müssen Sie entpacken! Sie enthält das Verzeichnis glassfish5, das Sie beispielsweise in Ihrem Benutzerverzeichnis ablegen können. Wichtig ist, dass Sie wissen, wo sich Glassfish auf Ihrer Festplatte befindet.

Hinweis: Beim Mac gibt es ein Problem, wenn der Glassfish auf einem SMB-Laufwerk oder einem FAT-USB-Stick laufen soll. Der Mac lässt das Starten von Programmen von solchen Devices nicht zu.

Glassfish-Tools

Für die Einbindung von Glassfish in Eclipse wird ein Plugin namens Glassfish Tools benötigt. Dies wird aus Eclipse heraus installiert.

Glassfish-Tools für Glassfish bis Version 4

Die Glassfish-Tools für die alten Glassfish-Versionen beißen sich auch mit neueren Eclipse-Versionen. Im Zweifelsfall versuchen Sie Eclipse-Verionen Neon oder älter.

Im Eclipse-Menü rufen Sie Help | Eclipse Marketplace.
Im Dialog neben der Lupe Glassfish eintippen und suchen lassen.
Es erscheint Glassfish Tools und ein Button Install. Den Anweisungen folgen.

Glassfish-Tools für Glassfish ab Version 5

Die neueren Glassfish-Tools befinden sich nicht im Marketplace. Sie werden über New Software installiert.

Im Eclipse-Menü rufen Sie Help | New Software.
Dort geben Sie folgende URL ein:
http://download.eclipse.org/glassfish-tools/1.0.0/repository
Die Glassfish-Tools erscheinen in der Liste, Davor einen Haken setzen. Next
Die Folgeseite zeigt Details. Next
Die Lizenz akzeptieren. Finish.
Unten rechts im Fenster sieht man Installationsvorgang mit Prozentzahl. Dann erscheint ein Dialog, ob Eclipse neu gestartet werden soll. Restart Now

Einrichtung des Glassfish-Servers in Eclipse

Im Eclipse-Menü rufen Sie File | New | Other auf.
Es erscheint ein Dialog in dem Sie unter Server den Unterpunkt Server anklicken. Next.
Aus der Liste klappen Sie Glassfish auf. Darin befindet sich ein Unterpunkt Glassfish. Klicken Sie Next.
Nun sollen Sie den Pfad für Glassfish angeben und darunter den Pfad der Java-Umgebung, die sich um Glassfish kümmern soll. Zur Unterstützung können Sie bei beiden die Browse-Buttons rechts verwenden.
Das Glassfish-Verzeichnis ist das Verzeichnis glassfish, dass sich in glassfish4 (bzw. glassfish5) befindet.
Die Java location ist bei
- Linux im Verzeichnis /usr/lib/jvm, beispielsweise jdk1.8.0_121.
- Bei Windows dort, wo Sie es installiert und hoffentlich gemerkt haben.
- Der Mac füllt es typischerweise von selbst aus.
Klicken Sie Next
Auf der nächsten Seite wird Administrationsbenutzer und Passwort eingestellt. Standardmäßig heißt der Administrator admin und hat kein Passwort. Finish.

Kurzer Test

Mit File | New | Dynamic ein Web-Project anlegen.
Mit File | New | HTML-File eine HTML-Datei erzeugen. Ggf. kann man den Namen in index.html ändern.
Zwischen die body-Tags ein wenig Text schreiben.
Projekt öffnen. Unter WebContent liegt index.html.
Mit rechter Maustaste anklicken. Run As | Run on Server anklicken. Finish anklicken.
Es vergeht einige Zeit, bis der Glassfish erstmals gestartet wurde. Viel Geduld, dann erscheint der eingegebene Text im Browser von Eclipse.

Manche Deployment-Fehler

... lassen sich durch folgende Einstellung beheben:

Manche Deploy-Fehler sind folgendermaßen zu beseitigen.

Server mit der rechten Maustaste anklicken.
Monitoring | Properties
Glassfish: Haken setzen bei Use JAR archives for deployment