Allgemeine Infos

Installation von Eclipse

• JDK 1.4.2 (http://java.sun.com/) installieren. Aktuell ist 1.4.2_09
• Eclipse 3.1.1 (http://www.eclipse.org/)


• Eclipse-Plugins:
  • EMF 2.1.1 (http://www.eclipse.org/emf) als Vorbedingung für WebTools-/VisualEditor). Wir benötigen SDO- und XSD-Runtime !
  • GEF Runtime 3.1.1 (http://www.eclipse.org/gef) als Vorbedingung für WebTools-/VisualEditor).
  • Der WebTools-Plugin erfordert außerdem die JEM-Runtime 1.1.0.1 . Diese erhalten wir auch über den Visual-Editor-Plugin 1.1.0.1 (http://www.eclipse.org/vep), den wir sowieso für Swing-Oberflächen benötigen.
  • Jetzt endlich können wir den WebTools-Plugin 1.0M8 (=Milestone Build 8) ( http://www.eclipse.org/webtools) installieren. Der Grund dafür dass wir nicht die Version 0.7.1 verwenden liegt in einem nervigen Bug mit dem Caching von XML-DTDs (siehe JBoss-Doku).
• Ein fertig gebündeltes Pakt mit Eclipse und allen erforderlichen Plugins gibt es hier: eclipse3.1.1.zip

Eclipse-Projekte

Welches Projekt ?

Eclipse-Projekt ohne Web-Unterstützung erstellen

Dieses Projekt können wir verwenden wenn wir nur Java-Klassen verwenden, also EJBs und Application-Client-Dateien.
Erstellen eines Projekts: Im Menü "File" den Menüpunkt "New" -> "Project" wählen.
Als Typ wird "Java Project" gewählt und der Projektname eingegeben.
Als "Contents" kann man den Default (Workspace) belassen, oder einen eigenen Ordner angeben.
Ich empfehle, die Pfade für Quelldateien und Klassendateien anzupassen, da ansonsten eine Vermischung "droht". Deshalb den Radiobutton "Create separate Source and output folders" wählen.

Nach einem Klick auf "Next" gelangen wir in die "Java Settings". Hier sehen wir dass die Quellen in einem Unterverzeichnis "src" im Projekt liegen, die erzeugten Java-Klassen in einem Unterverzeichnis "bin".

Wir klicken auf "Finish" und unser Projekt steht.

J2EE.JAR referenzieren

Hier gibt es zwei Vorgehensweisen: Das JAR im Sun-Appserver-Pfad referenzieren, oder es lokal in das Projekt zu packen. Ich bevorzuge letzteren Weg, weil dadurch auch ein compilieren ohne installierten App-Server oder auf einem Betriebssystem mit anderen Pfaden möglich ist . Deshalb wird hier letzteres Vorgehen beschrieben.
Hinweis: falls wir einen der drei oben genannten WTP-Projekttypen verwenden würden könnten wir einen Server definieren und über diese Definition würde "j2ee.jar" referenziert.

Hinzufügen eines Ordners, in dem später alle abhängigen JARs landen sollen: Rechtsklick auf das Projekt, "New" -> "Folder" wählen. Als Verzeichnisnamen "lib" angeben.

Importieren von J2EE.JAR in dieses Verzeichnis. Rechtsklick auf das neu erstellte Verzeichnis, "Import" wählen. Im Dialog "Import" wird als import source "Filesystem" gewählt.
Anschließend zum Verzeichnis "C:\Programme\Sun\AppServer\lib" wechseln. In der Liste rechts werden alle JARs aufgelistet. Einen Haken vor J2EE.JAR setzen.

Hinzufügen des JARs zu den Projektreferenzen: Rechtsklick auf das Projekt, "Properties" wählen. Im Bereich "Java Build Path" zur TabPage "Libraries" gehen.

Rechts auf "Add Jars..." klicken. Der Dialog "JAR Selection" erscheint, der alle lokal im Projekt verfügbaren JARs anbietet.

J2EE.JAR sollte in der Liste der Libraries auftauchen:

Das Ergebnis (nach Hinzufügen der Klassen und Interfaces) sollte so aussehen:

Eclipse-Projekt mit Web-Unterstützung erstellen

Vorbereitung: wir müssen einen J2EE-Server deklarieren. Dazu über "Window" -> "Preferences..." in die Eclipse-Konfiguration gehen. In der Kategorie "Server" -> "Installed Runtimes" klicken wir auf "Add".
Der Dialog zum Deklarieren eines Servers öffnet sich. Da der WebTools-Plugin keine Unterstützung für den SunAppServer mitbringt wählen wir eine "J2EE Runtime Library".

Wir geben dem Gerät einen schönen Namen und wählen das lib-Verzeichnis des AppServer aus.

Das Ergebnis sollte so aussehen (nicht vergessen den Haken vor dem Server zu setzen):


Jetzt legen wir mit dem Projekt los. Über "File" -> "New" -> "Other..." gelangen wir in den Dialog zum Hinzufügen von beliebigen Elementen. Wir wählen "Web" -> "Dynamic Web Project" aus.

Der Assistent für ein Dynamic Web Project startet. Wir geben dem Projekt einen Namen und klicken auf "Show Advanced >>". Als unterstützte Modul-Version wählen wir "2.4" (Servlet-Spezifikation). Der Haken bei "Add module to EAR application" wird entfernt und unser schöner neuer Server ausgewählt.

Jetzt auf "Finish" klicken.
Die anschließende Abfrage ob wir in die J2EE Perspektive wechseln wollen ignorieren wir.

Das Ergebnis sieht so aus:

Jetzt können wir Bean-Klassen und Interfaces wie im obigen Projekt zufügen. Alle Java-Dateien/Packages sollten im Verzeichnis "JavaSource" landen, alle statischen Inhalte wie JSP- und HTML-Dateien in "WebContent" (im Bild markiert). Die Fehlericons bitte ignorieren, dies lag nur daran dass keine Internetverbindung bestand und deshalb das XML-Schema zu "web.xml" nicht geladen werden konnte.
Die gesamten JSP-Seiten des Projekts werden jetzt korrekt compiliert und wie alle anderen Java-Fehler behandelt.

Das Hinzufügen von Bean-Klassen über den Assistenten würde ich nicht empfehlen da dessen Bean-Klassen eine andere ist und wir die gesamten Standard-Bean-Methoden von Hand zufügen müßten.

WICHTIG: In WebToolsPlugin 1.0M8 hat sich ein Bug eingeschlichen der dafür sorgt dass das Anlegen eines neuen Projekts mit Unterstützung für den SunAppServer nur dann möglich ist wenn der Server in der aktuellen Eclipse-Sitzung angelegt wurde. Ist das nicht der Fall dann enthält der BuildPath des Projekts nicht die JDK/JRE-Klassen (z.B. java.lang.Object), d.h. das Projekt ist zu nichts zu gebrauchen. Lösung: Vor dem Anlegen eines Dynamic Web Project die Definition des SunAppServer löschen und neu anlegen.

Hinzufügen eines Packages

Auf das Project einen Rechtsklick ausführen, "New" -> "Package" wählen. Einen sinnvollen Namen des Packages angeben.

Hinzufügen der Klassen

Jetzt kann man per Rechtsklick auf das Package die EJB-Klassen und EJB-Interfaces zufügen.
Hinzufügen der Bean-Klasse (zu beachten: die Klasse soll "abstract" sein, außerdem den Haken bei "Generate Comments" setzen, wir haben schließlich ein Herz für Kommentare):

Hinzufügen des Remote-Interfaces: Rechtsklick auf das Package, "New" -> "Interface" wählen.

Hinzufügen des Home-Interfaces:

Export und Import eines Standard-Java-Projekts

Zum Export des Projekt wählen und per Rechtsklick -> "Export..." in den Export-Dialog gehen. Als "export destination" wird ein "Archive file" gewählt.

Im Exportdialog müssen wir den Haken vor dem gewünschten Projekt entfernen und setzen sie dafür vor allen Unterverzeichnissen und den Projektdateien ".classpath" und ".project". Wichtig ist auch dass die Option "Create only selected directories" gesetzt ist. Ansonsten hätte die Pfadstruktur in der Zip-Datei eine Ebene zu viel und der Re-Import würde nicht klappen. Noch ein Ziel wählen. Das wars.


Re-Import:
Wir legen ein neues, leeres Standard-Java-Projekt an (mit den Einstellungen wie im obigen Beispiel, sprich "source and output folder"). Der Name des Projekts muss nicht der gleiche sein. Der Rest wird überschrieben. Rechtsklick auf das neue Projekt, "Import..." wählen. Der Typ ist natürlich wieder "Archive file". Wir wählen die Export-Datei aus und sind damit eigentlich schon fertig.

Export und Import eines WebTools-Projekts

Eclipse-Codeformatter

Infos zum Application Server

Einrichten der FH-Umgebung

Allgemeine Infos zum Application Server

Infos zur Pointbase-Datenbank

Infos zu Application Clients