Am Ende dieses Tutorials ist ein deploytes Java EE 6 Projekt mit JSF 2, CDI, EJB 3.1 und JPA 2 auf dem JBoss 6 vorhanden und aufrufbar. Dabei wird die Eclipse WTP Untestützung funktionieren, der JBoss direkt aus Eclipse heraus gestartet und Maven als Build Tool verwendet werden.

Kleine Anmerkung vorab: Nicht von der Länge des Tutorials abschrecken lassen – es sind eigentlich nur sehr viele Bilder. Kennt man die Technologien und Tools dauert das Erstellen dieses Projekts nur wenige Minuten.

Aufbau des Tutorials:

• Herunterladen der notwendigen Software und Tools
  • Eclipse herunterladen
  • JBoss AS herunterladen
  • Maven herunterladen
• Eclipse konfigurieren
  • JBoss Tools
  • JBoss 6 AS Server Runtime
  • Maven
  • Maven Extras – WTP
• Java EE 6 Projekt erstellen
  • Projekt mit Maven generieren
  • JSF Capabilities hinzufügen
  • CDI Support hinzufügen
  • Projekt auf den JBoss deployen
• Wie geht es weiter?

Herunterladen und Installieren aller benötigten Software und Tools

Eclipse Helios für Java EE Entwicklung herunterladen

Als erstes wird Eclipse in der Java EE Entwickler Version von eclipse.org heruntergeladen.

Das heruntergeladene Archiv am Ort deiner Wahl entpacken – z.B. einfach im Laufwerk C.

JBoss AS 6

In diesem Tutorial wird der JBoss 6 Final als Application Server verwendet denn dieser implementiert die Java EE Web Profile Spezifikation. Der JBoss AS kann unter jboss.org heruntergeladen werden.

Nach dem Herunterladen das Archiv auch wieder am Ort deiner Wahl entpacken – kann z.B. auch wieder das Laufwerk C: sein.

Maven 3

Um den Projektstart zu vereinfachen und alle Abhängigkeiten automatisch zu beziehen wird Maven 3 verwendet. Später wird auch das Grundgerüst unseres ersten Java EE Hello World Projekts mit Maven generiert. Somit muss Maven 3 “installiert” werden. Maven kann von http://maven.apache.org heruntergeladen werden:

Maven muss auch wieder an einem Ort deiner Wahl entpackt und anschließend das maven/bin Verzeichnis im Pfad (Umgebungsvariable PATH) angegeben werden damit der Befehl mvn in der Kommandozeile gefunden wird.

Installationsanleitung für Linux (Ubunutu 11.04) anzeigen.

Eclipse konfigurieren

Zuvor wurde bereits die die aktuelle Eclipse Helios (3.6) Java EE IDE heruntergeladen sowie entpackt und diese sollte spätestens jetzt gestartet werden. Beim ersten Start von Eclipse wir gefragt wo man seinen Workspace hinlegen möchte. Wieder einfach einen Ort deiner Wahl angeben und das Häckchen bei “nicht noch einmal fragen” setzen.

Für das Java EE Projekt mit Maven Unterstützung werden zum einen die JBoss Tools und zum anderen das Maven2Eclipse Plugin benötigt. Dabei spielen die JBoss Tools bei der Entwicklung von Java EE Projekten unter Eclipse generell eine sehr wichtige Rollen denn sie decken die meisten Themen wie z.B. JSF 2.0, CDI oder JPA sehr gut ab.

JBoss Tools Eclipse Plugin

Die aktuelle Version 3.2 der JBoss Tools gibt es dabei noch gar nicht so lange denn sie wurde erst Mitte Februar Final. Die JBoss Tools werden am einfachsten über die offizielle Update Seite installiert: http://download.jboss.org/jbosstools/updates/stable/helios/
Dazu in Eclipse im “Hauptmenü->Help->Install New Software…” klicken. Im aufkommenden Dialog den Button “Add” klicken um die Update Seite hinzuzufügen:

Diesen Dialog mit dem Button “Add” beenden und anschließend wird man erst einmal durch den Schriftzug “Pending…” sehen, dass das Repository geladen wird. Das kann unter Umständen eine ganze Weile dauern:

Sobald das Repository geladen wurde ist eine Liste mit allen möglichen Gruppen zu sehen. Die bisher bekanntesten Tools wie z.B. die JBoss AS Tools, Seam Tools oder Hibernate Tools befinden sich in der Gruppe “Web und Java EE Development”. Man könnte jetzt alles durchgehen und nur die benötigten Tools selektieren aber der Einfachheit halber selektiere ich “All JBoss Tools 3.2.0″:

Anschließend den Button “Next” klicken. Jetzt werden die Abhängigkeiten geprüft und das dauert auch wieder eine kleine Ewigkeit.
Sobald die Prüfung fertig ist sieht man noch einmal die Liste aller Tools die installiert werden sollen. In der Liste taucht sicherlich das ein oder andere Tool auf welches nicht wirklich benötigt wird aber es schadet auch nicht. Den Dialog mit “Next” beenden.
Auf dem letzten Dialog die Lizensvereinbarungen akzeptieren und den Button “Finish” klicken. Anschließend beginnt die Installation der JBoss Tools:

Die Installation verlangt einen Eclipse Neustart.

JBoss Server Runtime konfigurieren

Das spätere Projekt soll direkt von Eclipse heraus in den JBoss Server deployt werden. Dazu muss der JBoss als Server Runtime Environment in Eclipse konfiguriert werden. Um das zu tun die Eclipse Eigenschaften aufrufen “Hauptmenü->Window->Preferences” und die Optionen mit dem Wort “Server” filtern. Unter dem Punkt “Runtime Environments” wird der JBoss Server als Runtime hinzugefügt:

Den Button “Add” klicken und im nächsten Dialog unter “JBoss Community” den “JBoss 6.0 Runtime” auszuwählen. Der Einfachheit halber direkt die Checkbox “Create a new local server” selektieren – das erspart die anschließende Konfiguration einer Server Instanz:

Mit dem Button “Next” in den letzten Dialog wechseln und dort das Verzeichnis auswählen indem der JBoss entpackt wurde (z.B. C:\jboss-6.0.0). Als JRE muss das in Eclipse konfigurierte JDK ausgewählt werden. Unter Configuration default auswählen. Den Wizzard mit dem Button “Finish” beenden:

Nun ist die konfigurierte Server Runtime aufgelistet und kann verwendet werden:

In dem Server-Panel ist auch die lokale Instanz zu sehen:

Als letzte Konfiguration der eingebetteten JBoss Server Instanz wird jetzt noch das Deployment-Verzeichnis geändert. Per default wird die deployte Anwendung im lokalen Workspace in einen versteckten Ordner deployt. Ich mag es lieber wenn meine Anwendung auch mit direkt in den JBoss deploy Ordner deployt wird und dann auch dort zu finden ist.
Um das Deployment-Verzeichnis zu ändern mit einem Doppelklick auf die JBoss Server Instanz die Konfiguration öffnen. Anschließend am unterem Ende des Fensters auf den Tab “Deployment” klicken. Auf der Deployment Seite nun die Einstellung “Use JBoss deploy folder” selektieren und die Einstellungen speichern:

Nun kann der Server endlich durch klick auf den grünen Pfeil gestartet werden – er sollte ohne Probleme hochfahren. In der Console sollte am Ende die Startdauer zu sehen sein:

Im Browser lässt sich der JBoss auch bereits aufrufen:

Wunderbar – der Server läuft =).

Maven Unterstützung in Eclipse

Um Maven direkt aus Eclipse heraus verwenden zu können benötigt man das m2eclipse Plugin von Sonatype. Die Plugin Installation wird wieder über das “Hauptmenü->Help->Install New Software…” gestartet. In meiner Helios Version war die Update URL für das m2eclipse Plugin bereits konfiguriert. Ansonsten einfach folgende Update URL hinzufügen: http://m2eclipse.sonatype.org/sites/m2e
Ist dieses Update URL selektiert wird das Repository geladen. In diesem Fall ist nur ein Plugin selektierbar und das muss natürlich selektiert werden:

Den Dialog mit “Next” weiterführen.
Anschließend kommen wieder die Installationsdetails und die Lizensbedingungen. Den Wizzard mit “Finish” beenden und abwarten bis man aufgefordert wird Eclipse neu zu starten.
Es kann sein, dass nach dem Neustart das Maven Plugin meldet, dass Eclipse mit einem JDK gestartet werden muss:

In diesem Fall die Datei eclipse.ini öffnen (liegt direkt neben der Datei eclipse.exe) und unter dem Ausdruck openFile und oberhalb von -vmargs den Verweis auf die JDK angeben:

Mehr zu der Datei eclipse.ini findest du auch im Eclipse Wiki.

Nach dem Neustart kann in den Eclipse Preferences (Hauptmenü->Window->Preferences) die Maven Einstellungen konfigurieren. Darunter auch welches Maven verwendet werden soll. Das Plugin bringt eine Embedded-Version mit. In Eclipse reicht diese embedded Version eigentlich aus. Es empfiehlt sich aber die eigene Installation zu verwenden, so dass man auf der Kommandozeile die gleiche Maven Version verwendet wie in Eclipse. Dazu in “Maven->Installations” mit dem Button Add die eigene Installation hinzufügen:

Nachdem das Maven Plugin installiert wurde und man evtl. die Maven Installation angepasst hat dauert es einen Moment bis Maven seinen Index aktualisiert hat. Sofern das Maven Index Update noch läuft sieht man dies in dem Progress Panel:

Maven Extras – m2eclipse-extras

Es fehlt noch das Maven Integration for Eclipse WTP Plugin um mit Maven mit dem Eclipse Web Tools Project zu verbinden. Dazu noch einmal im Hauptmenü “Help->Install New Software..2 klicken und die Update URL auswählen oder hinzufügen: http://m2eclipse.sonatype.org/sites/m2e-extras

Anschließend den Wizzard wieder wie gewohnt durchgehen und das Plugin installieren.

Das erste Java EE 6 Projekt

Nun ist Eclipse konfiguriert und vorbereitet – es ist Zeit für das erste Java EE 6 Projekt mit Eclipse WTP und Maven Unterstützung.

Projekt mit Maven generieren

Um ein neues Projekt anzulegen im Hauptmenü “File->New->Other” klicken und im geöffneten Startfenster des Wizzards “Maven Project” auswählen:

Mit den Button “Next” weiter. Im zweiten Dialog “Select Project Name and Location” die Voreinstellung “Use default Workspace Location” selektiert lassen und Button “Next” klicken.
Im folgenden Dialog “Select an Archetype” nach “knappsack” filtern und ee6-sandbox-archetype auswählen. Falls dieser Archetype nicht verfügbar ist kann es sein, dass der Maven Index Update noch nicht vollständig durchlaufen ist – in diesem Fall sieht man in Eclipse unten rechts im Progress View, dass ein Prozess läuft und es hilft nur warten..
Die “knappsack” Archetypes wurden von Andy Gipson erstellt und ermöglichen einen sehr einfachen Start in das Projekt.
Wer ein Beispielprojekt mit einem vollständigem CRUD Beispiel haben möchte sollte das Archetype jee6-sandbox-demo-archetype verwenden.

Nach dem Selektieren des Archetypes den Dialog mit “Next” verlassen.

Auf der nächsten Seite müssen jetzt die Archetype Parameter gesetzt werden. Das ist zum Einen die Group Id und zum Anderen die Artifact Id. In die Group id kommt der übergeordnete Name der Package Struktur und als Artifact Id wird der Projektname gewählt:

Mit dem Button “Finish” den Wizzard beenden. Das Projekt wird nun generiert und das kann einen Moment dauern:

Nun ist das Projekt erstellt und man kann sich die Java, xhtml und Konfigurationsdateien ansehen die durch den gewählten Maven Archetype generiert wurden:

Diese generierten Java und xhtml Dateien sollen den Einstieg in JSF 2, CDI und JPA 2 vereinfachen.

Konfiguration in web.xml auf Servlet 3.0 umstellen

Der ausgewählte Maven Archetype hat in der web.xml als Servlet Spezifikationsversion 2.5 konfiguriert aber wir wollen 3.0 verwenden. Deswegen die web.xml Datei öffen: ALT-Shift-R -> web.xml oder im Verzeichnis src/main/webapp/WEB-INF. In dieser Datei steht auch schon als Kommentar der Hinweis, dass man für den JBoss Servlet Version 3 verwenden soll. Dazu die Zeile 10 löschen und die oberen Zeilen mit version=”3.0″ verwenden. Mein web-app Element sieht wie folgt aus:

JSF Capabilities dem Projekt hinzufügen

Öffnet man eine .xhtml Seite so öffnet sich der Visuell Editor von den JBoss Tools. Allerdings erscheint eine Fehlermeldung, dass die JSF Capabilities / JSF Unterstützung für dieses Projekt noch nicht konfiguriert ist:

Entweder in dieser Fehlermeldung direkt auf den Button “Add JSF Capabilities” klicken oder mit der rechten Maustaste auf das Projekt und aus dem Kontextmenü “Configure->Add JSF Capabilities” klicken. In beiden Varienten öffnet sich ein Wizzard mit dem ersten Dialog “Project Location”. Der vorgegebene Pfad für die web.xml Datei sollte eigentlich stimmen:

Mit den Button “Next” auf den nächsten Dialog “Project Folders” wechseln. Die vorgegebenen Pfade sollten auch hier stimmen. Die Checkbox “Add Libraries” darf nicht selektiert werden denn sonst kommt es später zu Fehlern.
Als Servlet Version muss 3.0, wie zuvor bereits in der web.xml abgeändert, ausgewählt werden.
Der Haken bei der Checkbox für “Target Server” bewirkt, dass dieses Projekt direkt dem konfigurierten JBoss hinzugefügt und mit deployt wird:

Den Wizzard mit dem Button “Finish” beenden. Man wird anschließend gefragt ob man in die Web Developer Perspektive wechseln möchte. Je nach Geschmack kann man sich die Web Developer Perspektive anschauen und verwenden oder wieder in die Java EE Perspektive wechseln.

Nun sollten sich alle .xhtml Seiten ohne Warnung im Visual Editor öffnen lassen und auch Autocomplete für JSF Tags möglich sein:

CDI (Context and Dependency Injection) Unterstützung dem Projekt hinzufügen

Als letztes müssen noch die CDI Unterstützung konfiguriert werden. Man merkt es daran, dass in der .xhtml Seite noch kein Autocomplete für die EL (Expression Language) zulässt. Wenn man z.B. in der home.xhtml den Cursor in die Expression #{demoCourseList} in Zeile 11 setzt und F3 drückt sollte die entsprechende Producer Methode der CDI Bean springen:

Die CDI Unterstützung wird genauso hinzugefügt wie die JSF Capabilites im Abschnitt zuvor. Im Kontextmenü des Projektes (rechte Maustaste auf den obersten Knoten des Projekts) Configure->Add CDI (Context and Dependency Injection) support.. klicken. Im geöffneten CDI Preferences Dialog die Checkbox selektiert lassen und den Button “Apply” drücken. Anschließend den Preferences Dialog mit dem Button “OK” wieder verlassen:

Nun den gleichen Versuch wie vorher schon in der home.xhtml machen und mit dem Cursor auf die Expression #{demoCourseList} in Zeile 11 setzen und F3 drücken. Nun öffnet sich der Java Editor genau an der richtigen Methode mit dem dazugehörigem CDI Producer:

Außerdem funktioniert nun auch Autocomplete direkt in der .xhtml Seite in einer Expression:

Projekt auf den JBoss deployen

Jetzt kommt der erste Test ob das generierte Projekt sich auch deployen und im Browser anzeigen lässt. Dazu im Server Panel überprüfen ob das Projekt dem Server hinzugefügt wurde – dazu einfach den JBoss aufklappen und vergewissern ob das jee6project zu sehen ist. Falls nicht muss das Projekt noch hinzugefügt werden: “rechte Maustaste auf JBoss 6.0 Runtime Server->Add and Remove…”. Anschließend den Server starten:

In der Console erscheinen dann irgendwann die folgenden Zeilen:

Nun die deployte Anwendung im Browser unter http://localhost:8080/jee6project aufrufen:

Die Seite die dargestellt wird stammt aus dem gewählten Knappsack Maven Archetype und soll die ersten Schritte in Java EE 6 bzw. in CDI vereinfachen.
Um zu prüfen ob die WTP Unterstützung funktioniert kann man das Hot Deployment ausprobieren. Hot Deployment funktioniert auf alle Web Resourcen wie z.B. .xhmtl, .css oder Bilddateien.
Um das zu testen einfach die home.xhtml öffnen und einen Text eingeben:

Nach dem speichern die Seite im Browser aktualisieren und der Text sollte direkt angezeigt werden.

Prinzipiell ist das Tutorial an dieser Stelle zu Ende – der JBoss läuft und das Java EE 6 Projekt ist deployt. Es lohnt sich als nächstes den Code durchzusehen und zu verändern. Im folgenden Abschnitt wird noch kurz auf ein paar Dinge im Source Code rund um CDI eingegangen.

Wie geht es weiter?

An diesem Punkt angekommen solltest du ein laufendes Java EE 6 Projekt im Web Profile auf dem JBoss Application Server haben. Nun kannst du dich mit Eclipse, Maven oder Java EE 6 weiter beschäftigen.
Hast du mit Java EE 6 noch überhaupt keine Erfahrungen solltest du dir dieses Projekt genauer ansehen und dich mit den bereits verwendeten Annotationen und Aufbau vertraut machen.

Viel Spaß beim ausprobieren =).

Eclipse Galileo entspricht der Version 3.5 und bringt seinerseits auch wieder viele neue Dinge mit. Neben den bisher schon bekannten Projekte wie z.B. WebTools, Data Tools oder C/C++ Tools bringt Galileo fünf neue Projekte mit an den Start. Persönlich finde ich das Memory Analyzer Projekt (MAT) am interessantesten. Wer einen Einblick in MAT bekommen möchte sollte sich mal das dazugehörige Blog und auch das Webinar aus dem letzten Jahr ansehen.

Nebem dem MAT sind auch noch die PHP Developer Tools, eine Mylyn WikiText Unterstützung, eine Unterstützung um XSL Tooling um XSL zu bearbeiten und zu debuggen und Verbesserungen für die Business Intelligence Reporting Tools (BIRT) mit Galileo veröffentlicht worden (siehe auch Release Notes).

Das schöne an Veröffentlichungen von Eclipse und deren Plugins sind die “New and Noteworthy” Seiten auf denen die interessantesten Erneuerungen mit einem Screenshot erläutert werden. Für Eclipse Galileo ist die Seite entsprechend der vielen Erneuerungen auch wirklich lang. Im folgenden ein paar Erneuerungen die ich auf Anhieb ganz interessant fand:

• Platform – Compare Editor enhancements
  Wirklich brauchbare Erneuerungen wie Go to line oder Open Resource und Type sowie die Möglichkeit den Encoding Type auf jeder Seite des Editors neu zu setzen.
  
• Platform – Open Resource dialog allows choice of editor
  Man kann nun den Editor für die zu öffnende Datei direkt im Open Resource Dialog auswählen, falls gewünscht:
  
• Install/Update Changes
  Wie auch bei der letzten Version wurde einiges an dem Install und Update Management gearbeitet und verbessert. Um nur eine Sache herauszugreifen im folgenden der Screenshot des vereinfachten Hinzufügen neuer Update Sites:
  
• Java Editor – Constructor completion
  Der Content Assistent bietet nun die verfügbaren Konstruktoren der Klasse zur Auswahl an:
  
• Java Editor – Open Implementation hyperlink
  Ein Feature auf das wohl sämtliche Entwickler lange gewartet haben. Von einem Interface direkt in die Implementierung via Hyperlink springen sofern nur eine Implementierung vorhanden ist. Sind mehre da werden diese in der type hierarchy aufgelistet und man kann dann direkt wählen. Den Hyperlink erhält man indem man die Taste STRG gedrückt hält und mit der Maus über die Methode fährt. Der Dialog sieht dann wie folgt aus:
  
• Java Editor – Quick Fix to start Rename refactoring
  Möchte man eine Methode mit Quick Fix (Strg-1) umbennen besteht nun die Möglichkeit auch ein Refactoring über das Projekt zu starten:
  
• Java Editor – Formatter option to preserve user line breaks
  Eine der bisher sehr nervigen Details am Formatter war, dass ich meine selbstdefinierten Zeilenumbrüche nicht behalten durfte. Das soll jetzt vorbei sein:
  

  Und nach dem formatieren:

  
• Java Refactoring and Source Actions – Generate toString()
  Ein ziemlich cooles Feature ist die Unterstützung für die toString() Methode. Man erhält diesen Dialog aus dem Context Menü unter “Source->Generate toString()…” und dieser sieht wie folgt aus:
  
• Java Refactoring and Source Actions – Comparing identical values
  Wenn zwei gleiche Variablen verglichen werden wird das nun als Warning angegeben:
  
• Java Refactoring and Source Actions – Missing hashCode() method
  Der Compiler kann nun fehlende hashCode() Methoden finden auch wenn equals() schon vorhanden ist. Dieses Feature ist per Default ausgeschalten – einschalten kann man es unter “Preferences > Java > Compiler > Errors/Warnings in the Potential programming problems”.
  

Es gibt noch einige mehr Erweiterungen die man sich auf der “New and Noteworthy” Seite ansehen kann.

Neben den neuen Projekten werden natürlich auch wieder fertige Projekt Packages angeboten – darunter auch wieder das JEE Package mit den Web Tools und Data Tools:

Startet man das Eclipse Galileo JEE Package sieht man auch an der Welcome Page eine deutlichen Änderung:

Auf dieser Welcome Page sind unter anderem die sieben wichtigsten im JEE Package durch die Web Tools Platform mitgebrachten Unterstützungen aufgelistet: Web Services, Web, XML Tools, Server Tools, Java EE, JSF, JPA. Die Web Tools Platform 3.1, welche auch erst im Juni veröffentlicht wurde, hat auch einige Erneuerungen mitgebracht die unter “Eclipse Web Tools Platform 3.1 – New and Noteworthy” im Detail angesehen werden können.

Natürlich steht auch wieder das leidige Thema Plugin Update auf der Liste und diesmal haben die JBoss Tools schon ein wenig vorgearbeitet. Schon am Anfang des Monats wurde auf dem offiziellen Blog verkündet, dass man den JBoss Tools 3.1 Milestone 1 für Eclipse Galileo installieren und testen kann. Der Update Site Link für die Developer Version ist: http://download.jboss.org/jbosstools/updates/development.

Ich habe die JBoss Tools 3.1 M1 unter Eclipse Galileo installieren und auch ohne erkennbare Probleme verwenden können. In einem ersten Versuch hat das Umbennenen ohne Probleme funktioniert. Den Rename Dialog erhält man am einfachsten aus der Seam Component View heraus. Insgesamt ein wirklich sehr nützliches Feature!
In ersten Tests mit einem bestehenden Projekt lies sich insgesamt problemlos arbeiten. Im About Dialog von Eclipse werden die entsprechenden Plugins auch korrekt angezeigt:

Auch zu den JBoss Tools 3.1 M1 gibt es eine “News and Noteworthy” Seite auf der die einzelnen nennenswerten Erneuerungen zu finden sind. Ich möchte nur kurz eins hervorherben welche ich ziemlich praktisch finde und zwar ist das der “Rename Seam Component” Dialog, der verfügbar ist wenn man in einer Klasse die mit @Name annotiert ist, sich in der components.xml oder in der Seam components view befindet. Verwendet man diesen Dialog wird der Name auch in den xhtml Dateien gefunden und dort refactored:

Der Übergang von Eclipse 3.4 auf Eclipse 3.5 mit den JBoss Tools scheint also vorerst problemlos zu funktioniern (im Gegensatz zu dem Umstieg von 3.3 auf 3.4).

Somit wünsche ich viel Spass beim ausprobieren!

Entity Bean mit JPA Annotationen	Dazugehöriges SQL Schema für diese Entity Bean

Meistens bringen die verschiedenen JPA Implementierungen eigene Tools mit. Verwendet man z.B. Hibernate kann man zum Beispiel die von Konsole Tools in Form eines ANT Tasks verwenden. Arbeitet man mit der Eclipse Ganymede IDE hat man mit dem Web Tools Subprojekt “Dali” (Dali JPA Tools) die Möglichkeit sich das DB Schema mit Hilfe eines Eclipse Dialogs generieren zu lassen. Ich habe schon mal bei der Vorstellung der JBoss Tools 3 Alpha Version darauf hingewiesen, dass das WTP Dali Projekt ab Version 3 unterstützt wird.

Nachdem ich diesen Artikel in der ausführlichen Version erstellt hatte kam mir dieser mehr doch sehr lang vor obwohl das Konfigurieren an sich relativ schnell geht. Dahier hier die wenigen Schritte in absoluter Kurzform:

• Projekt Facet “JPA Persistence” dem EJB Projekt hinzufügen (Projekt Properties)
• JPA Plattform und DB Verbindung konfigurieren (Projekt Properties)
• Im Cotextmenü auf dem EJB-Projekt “JPA-Tools->Generate DDL…” wählen
• Im DDL Generation Dialog das Zielverzeichnis, die Ausgabedatei und Hibernate Console- (konfigurierbar über die Hibernate Perspektive) oder DB-Konfiguration angeben. Dialog mit “Finish” beenden -> DDL Datei wird erstellt.

Im Folgenden wird anhand meines kleinen Java Schnipsel Projektes gezeigt wie das Datenbankschema, genauer gesagt die DDL (Data Definition Language) Datei, mit Eclipse generiert werden kann. Dieses Projekt verwendet Hibernate und somit werden aus den JBoss Tools Plugins das Hibernate Tools Eclipse Plugin benötigt. Nun sind die JBoss Tools 3.0.0 endlich offiziell Stable erschienen und da ist es an der Zeit dieses Feature mal auszuprobieren.

Im ersten Schritt sollte überprüft werden ob die Hibernate Tools installiert sind. Aus den JBoss Tools Eclipse Plugins wird für das Generieren der DDL Datei die Hibernate Tools benötigt. Für eine Installationsanleitung der JBoss Tools siehe hier.

Mein Beispielprojekt ist in der für Eclipse normalen JEE Projektstruktur erstellt worden (mit dem Seam Web Project Wizzard):

Hat man eine solche Projektstruktur muss man nun das JPA Project Facet hinzufügen. Dazu auf dem EJB Projekt aus dem Context Menü (recht Maustaste) “Properties” aufrufen. Im Properties Dialog “Project Facets” selektieren und dort das Facet “Java Persistence” auswählen:

Wenn das Facet “Java Persistence” selektiert wurde erscheint unten im gelben Hintergrund der Hinweis, dass weitere Konfigurationsmöglichkeiten bestehen (“Further configuration available”). Am einfachsten ist es diese Konfiguration direkt auszuwählen. Hat man die Einstellung mit “Apply” bestätigt einfach das Facet noch einmal deslektieren, Apply drücken und das Facet wieder selektieren.
In dem Dialog “Modify Facet Project -> JPA Facet” muss nun die verwendete JPA Platform und die DB Verbindung konfiguriert werden. Ich verwende Hibernate und habe meine MySQL Verbindung konfiguriert. Man kann direkt von diesem Dialog aus eine neue DB Verbindung konfigurieren, sofern man das noch nicht getan hat.

Die zwei weiteren dort möglichen Einstellungen habe ich bei mir auf “Use implementation provided by server Runtime” (Die Server Runtime kann in den Properties unter dem Punkt “Targeted Runtimes” konfiguriert werden – verwendet man keinen Server wie den JBoss kann man die JPA Jars auch direkt angeben) und “Discover annotated classes automatically” gesetzt. Anschließend den JPA Facet Dialog und anschließend den Properties Dialog mit “Ok” beenden.

Hat man allerdings den Properties Dialog schon vor den zusätzlichen JPA Einstellungen mit “Ok” beendet muss man noch einmal die Properties für das EJB Projekt aufrufen und kann dann aber den Menüpunkt “JPA” direkt selektieren und somit konfigurieren:

Nachdem die Java Persistence Project Facets dem JEE Projekt hinzugefügt wurden ist im Context Menü, sofern man dieses auf dem EJB Projekt aufruft, der Eintrag “JPA Tools” zu finden. Darin findet sich der Menüpunkt “Generate DDL”.

Erhält man nach dem Auswählen dieses Menüpunktes den Fehler “DDL Generation is not supported by the Generic Platform” hat man vergessen seinen JPA Platform (Hibernate, Toplink, ..) zu konfigurieren. Dazu einfach wieder in die EJB Projekt Properties und den Menüpunkt “JPA” selektieren und konfigurieren. Mehr Informantionen zu dieser Fehlermeldung auch hier.
Ist alles soweit korrekt konfiguriert öffnet sich der DDL Generation Dialog. Darin gibt man zuerst das Zielverzeichnis sowie den Namen der DDL Datei an. Die zweite wichtige Konfiguration ist der Hibernate Dialekt der verwendet werden soll. Dazu kann man entweder eine bereits durch die Hibernate Perspektive erstellte Hibernate Console Konfiguration verwenden und diese mit der Checkbox “Use Console Konfiguration” verwenden oder wie in meinem Fall die bereits konfigurierte Datenbankverbindung. Der Dialekt kann dabei automatisch erkannt werden (ich berichtete darüber) oder direkt angeben:

Ist alles korrekt konfiguriert wird durch den Button “Finish” das Generieren der DDL in der gewünschten Zieldatei gestartet. Das kann einen kleinen Moment dauern und anschließend ist diese Schemadatei auch unter der gewünschten Position (bei mir im EJB-Projekt im Ordner ejbModule) zu finden:

Gerade für die erste Entwicklungszeit und dem Erstellen der Entitäten ist diese einfach DDL Generierung sehr nützlich. Sieht man doch direkt was für Datenbanktypen aus den Java Attributen erstellt werden.

Alternativ kann man mit den Hibernate Tools über die Hibernate Perspektive das Schema auch direkt in der DB erstellen. Vor gut einem Jahr habe ich dazu einen kleinen Artikel erstellt.

Möchte man mit den JBoss Tools 3 arbeiten benötigt man Eclipse Ganymede. Es wird nicht empfohlen von Eclipse 3.3 auf Eclipse 3.4 via Update Manager zu wechseln. Viel praktischer ist es eine frische Eclipse Installation vorzunehmen und somit auch potentielle Fehlerquellen aus dem Weg zu gehen. Am einfachsten ist es wenn man die Eclipse 3.4 IDE for Java EE Developers herunterlädt. Auch hier gibt es mittlerweile das Release 2 Bundle, welches ca 170 MB groß ist.

Nachdem Eclipse heruntergeladen, entpackt und gestartet wurde einfach die JBoss Tools Update URL (http://download.jboss.org/jbosstools/updates/stable) im Eclipse Update Manager hinzufügen. Den Update Manager findet man im Hauptmenü unter Help->Software Updates. Dort den Reiter “Available Software” selektieren und rechts den Button “Add Site…” drücken:

Ist die Update Site hinzugefügt kann man nach dem Aufklappen alle angebotenen JBoss Tools sehen. Für meine Seam Entwicklung mit Hibernate, RichFaces auf dem JBoss AS installiere ich immer die folgende Tools (hervorgehobene Selektion):

Um die Installation fertigzustellen den Button “Install” drücken und den Anweisungen folgen.

Erstellt man über die JBoss Tools ein Seam Web Projekt sieht man schon die erste Erneuerung denn es wird jetzt auch Seam 2.1 direkt unterstützt, wie man auch bei der Konfiguration der Seam Runtime sehen kann:

Wer mit der Nightly Build oder 3.0.0 Alpha Version gearbeitet hat wird die neuen wirklich nützlichen Features wahrscheinlich schon gesehen und ausprobiert haben. Vor allem bei der Entwicklung von Facelets XHTML Seiten in Verbindung mit Seam Komponenten sind sehr schöne Features in die neue Version reingekommen. Ein paar davon, die ich persönlich absolut praktisch finde, sind im folgenden kurz aufgelistet.

Autocompletion:
Es werden alle mit @Name annotierten Seam Komponenten direkt im XHTML Editor gefunden und durch Autocomplete angeboten:

EL Warning:
Hat man eine Fehler in der Expression Language gemacht wie der typische “rechte-Klammer-fehlt” Fehler findet man diesen nun nicht mehr erst nach dem Deployment sondern direkt im Editor durch ein Warning:

Seam Komponenten und Links direkt aus dem Editor heraus öffnen:
Man kann nun direkt aus dem XHMTL Editor heraus durch halten von STRG und der Maus direkt in die Java Klassen der Seam Komponenten oder direkt in andere .xhtml Seiten springen:

Visueller Editor für die pages.xml:
Es gibt nun eine wirklich gute Unterstützung für die pages.xml. Darunter auch eine visuelle Ansicht für die Navigationsregeln, die in der pages.xml definiert werden:

Mehr Bilder zu den neuen Features findet man auch wie gewohnt im Kapitel “News and Noteworthy“.
Alles in allem ist es wirklich schön endlich eine funktionierende und offizielle Version der JBoss Tools für Eclipse Ganymede zu haben. Nun steht der Entwicklung von vielen schönen neuen Seam Projekten nichts mehr im Wege =).

Die offizielle Meldung für die JBoss Tools 3.0 findet man auch noch mal hier zum nachlesen.

Man kann den Funktionsumfang für die Formatierungsmöglichkeiten soweit abspecken, dass nur noch das nötigste für den Benutzer möglich ist:

Wer den Editor live ausprobieren möchte kann dies auf der RichFaces Live Demo direkt tun. Die einfachste Variante den Editor einzubinden und zu verwenden ist:

<rich:editor value="#{myBean.editorContent}"/>

Die Editor Komponente selbst basiert auf den sehr bekannten TinyMCE JavaScript WYSIWYG Editor und bisher musste man, wenn man einen solchen Rich Editor wollte, diesen manuell in sein Projekt einbinden.

Ich werde den Editor die Tage mal ausprobieren und dann wird man sehen ob er sich so einfach einbinden und verwenden lässt wie es bei den vielen anderen RichFaces Komponenten war.

Neben dem Editor ist noch eine weitere Ajax Komponente hinzugekommen: Ajax Queue. Mit dieser ist es möglich direkt hintereinander abgesetzte Ajax Request so zu managen, dass der zweite Ajax Request erst abgesetzt wird wenn der erste beendet wurde. Somit kann man parallele Ajax Requests verhindern.

Wer bisher noch nichts von den RichFaces bzw. das dazugehörige Ajax4Jsf gehört hat der sollte sich auf der Live Demo Seite die vielen Beispiele mal ansehen. Neben den fertigen Ajax Komponenten wie z.b. die DataTable, Inplace Edit, Tree oder File Upload (um nur einige zu nennen) ist vor allem der Ajax4Jsf Teil sehr interessant. Mit diesem lassen mit einfachen Mitteln bzw. Komponenten normale JSF Seiten “Ajaxifizieren” (a4j:support), es lassen sich JavaScript Methoden dynamisch erzeugen (a4j:jsfunction) die mit JSF Managed Beans reden oder Teile der JSF Seite neu Rendern oder man kann den Server mit Hilfe von Ajax Anfragen um z.B. einen Status abzufragen (a4j:poll).
Persönlich finde ich genau diesen Ajax4Jsf Teil und die gesamte Einfachheit der Verwendung der RichFaces Komponenten den Grund warum ich die JBoss RichFaces sehr empfehlen kann.

Noch ein letzter Tipp: Wer mit den RichFaces arbeitet sollte sich auf alle Fälle die JBoss Tools in Eclipse installieren um die direkte RichFaces Unterstützung im JSF Editor zu erhalten. Neben Autocomplete bei den Komponenten, dem Rich Editor für JSF oder xhtml Seiten erkennt er auch Expressions und kann auf die Methoden und Beans referenzieren.

Viel Spass beim ausprobieren!

Nun kommen wir wieder zu der Nightly Build Version zurück, denn JBoss hat jetzt die schon vor ein paar Monaten angekündigte Nightly Build Update Seite eingerichtet.
Die dazugehörige URL lautet: http://download.jboss.org/jbosstools/updates/nightly/trunk

Um die Update Seite in Eclipse zu verwenden im Hauptmenü wie gewohnt unter “Help->Software Updates…->Available Software Tab->Add Site…” die neue Nightly Build Update Seite URL hinzufügen und mit “Ok” bestätigen.

Wenn man schon die Update Seite hinzugefügt hat muss man die neuen Versionen der JBoss Tools doch natürlich auch gleich ausprobieren. Ich habe wie immer meine üblichen Tools für Hibernate, Seam, RichFaces und den JBoss AS für die Installation selektiert.

Anschließend noch überprüft ob auch wirklich die aktuellste Nightly Build Version installiert ist:

Man merkt die Weiterentwicklung aber auch im JBoss Tools XML Editor und dem JBoss Tools Property Editor denn in den früheren Versionen konnte man z.B. die Tastenkürzel Strg-D um eine Zeile zu löschen oder “Strg-Alt-Pfeil Unten” um einen Block zu kopieren nicht verwenden. Das funktioniert nun und allein das ist dieses Update schon wert gewesen =).

Wer sich direkt den aktuellen Stand der 3.0.0 Beta1 Version installieren möchte kann sich diese auch durch eine eigens dafür eingerichtete Update Seite installieren.

Wer Fehler/Bugs entdeckt kann sie in Jira reporten und so die Entwicklung unterstützen. Ob ein neuer Build stattgefunden hat bzw. ob es sich lohnt Eclipse zu updaten kann auch online abgefragt werden.

So, nun kann fleißig weiterentwickelt werden.

Damit klar ist mit welchen Tools und deren Versionen in diesem Tutorial gearbeitet wird hier eine kurze Auflistung. Es wird später noch einmal darauf eingegangen wenn die Tools heruntergeladen werden müssen:

• Eclipse Ganymede – IDE for Java EE Developers
• JBoss Application Server Version 4.2.2.GA
• JBoss Seam Version 2.0.2
• JBoss Tools Version 3.0.0 Alpha 1
• MySQL Version 5.0.x
• MySQL GUI Tools für die Version 5.0
• MySQL Connector for Java 5.1

Sobald die Entwicklungsumgebung mit den eben aufgelisteten Tools eingerichtet ist soll noch ein kleines “Hello World Seam Projekt” mit Hilfe der JBoss Tools Plugins aus Eclipse heraus erstellt werden. Das Ergebnis wird wie folgt aussehen:

Das Tutorial ist in folgende Abschnitte unterteilt:

• Herunterladen der notwendigen Software und Tools
  • Eclipse herunterladen
  • JBoss AS herunterladen
  • JBoss Seam herunterladen
  • MySQL herunterladen
• Ordnerstruktur und Eclipse vorbereiten
  • Eclipse und Projekt Workspace
  • JBoss AS und JBoss Seam
  • Fertige Verzeichnisstruktur
  • Eclipse Startparameter und Teststart
  • JBoss Tools Eclipse Plugins installieren
• MySQL Datenbank installieren und konfigurieren
  • MySQL Installieren
  • Datenbankschema in MySQL erstellen
  • Datenbankbenutzer in MySQL erstellen
  • MySQL Connector/J Treiber dem JBoss AS bekannt machen
• Erstes Hello World Seam Projekt erstellen
  • Projektgenerierung mit Hilfe von Seam Gen
  • JBoss Seam Web Projekt erstellen
  • Erster Wizzard Dialog “Seam Web Project”
  • Zweiter Wizzard Dialog “Web Module”
  • Dritter Wizzard Dialog “JSF Capabilities”
  • Vierter Wizzard Dialog “Seam Facet”
  • Projekt Generierung
  • Generierte Projektstruktur
• Erstes Deployment und das berühmte “Hello World”
  • Deployment Angaben für den JBoss überprüfen
  • Erster Start des JBoss AS aus Eclipse heraus
  • Erfolgreicher JBoss AS Start und Deployment
  • Aufruf der Web Anwendung im Browser
  • Erstes Editieren: “Hello World” Text hinzufügen
• Fazit
  • Wie geht es weiter?

Herunterladen der notwendigen Software und Tools

Ich möchte kurz erwähnen, dass die folgenden Beschreibungen sich auf Windows beziehen. Das ist zwar generell unabhängig, allerdings sind manche Angaben Pfadabhängig und gelten in diesem Fall für eine Windows Umgebung.

Als erstes muss Eclipse besorgt werden. Dazu auf eclipse.org gehen und im Menü auf Download klicken. Die einfachste Variante ist direkt das Eclipse für Java EE Developers Package herunterzuladen. Der Vorteil liegt darin, dass das Web Tools Projekt und andere notwendige Abhängigkeiten bereits vorinstalliert sind und mit dem angebotenen Eclipse zusammenspielen.

Weil JBoss Seam ein Framework für die einfache Verbindung zwischen EJB 3 und JSF ist sollten wir uns auch den passenden Application Server besorgen. JBoss Seam kann man auch auf einem Servlet Container, wie zum Beispiel Apache Tomcat, laufen lassen allerdings benötigt man dazu das Embedded JBoss Packet.
Den JBoss AS findet man auf seiner offiziellen Seite unter jboss.org und dort wieder auf den Button Download klicken. Für dieses Tutorial wird die letzte stabile Version 4.2.2.GA verwendet. Mit der zuletzt veröffentlichten Version 4.2.3.GA wird der Seam Phaselistener doppelt installiert, was zu einem fehlerhaften Zustand führt. Aus diesem Grund wird die vorherige Version 4.2.2.GA hier verwendet.

Und nun zu dem eigentlichen Framework um das es hier geht: JBoss Seam. Auch hier wird die letzte stabile Version 2.0.2 SP1 heruntergeladen.

Als Datenbank wird die MySQL verwendet. Dazu auch hier die letzte stabile Version 5.0 herunterladen.

Sehr nützlich für die Datenbankentwicklung mit der MySQL sind die MySQL Admin GUI Tools. Auch hier die letzte Version 5.0 herunterladen.

Um später von einer Java Anwendung aus auf die MySQL Datenbank zugreifen zu können müssen noch die Connector Treiber für Java “MySQL Connector/J” heruntergeladen werden.

Ordnerstruktur und Eclipse vorbereiten

Ich persönlich bevorzuge immer einen Projektordner der zu einem Thema ausgerichtet ist und alle für dieses Thema benötigten Tools enthält, sofern das möglich ist. In diesem Tutorial soll eine JBoss Seam Entwicklungsumgebung erstellt werden und dazu wurde der Ordner D:\Projekte\JBossSeam erstellt und sämtliche Tools darunter entpackt.

Gleich als erstes wird Eclipse Ganymede entpackt. Das heruntergeladene .zip einfach direkt im Projektordner entpacken. Anschließend sollte ein Verzeichnis eclipse vorhanden sein. Nun fehlt nur noch der Eclipse Workspace um eine glückliche Eclipse Installation fertigzustellen. Alle Eclipse Projekte in dieser Umgebung sollen im workspace Verzeichnis liegen. Dieses wird gleich neben dem eclipse Verzeichnis erstellt.

Für den JBoss AS und JBoss Seam wird ein Verzeichnis mit dem Namen jboss erstellt. Darin wird das JBoss AS und das JBoss Seam .zip entpackt. Anschließend sollte in dem Verzeichnis jboss die Ordner jboss-4.2.2.GA und jboss-seam-2.0.1.GA liegen.

Die fertige Verzeichnisstruktur sieht anschließend bei mir wie folgt aus:

Zum Starten von Eclipse habe verwende ich eine start_eclipse.bat Datei um Eclipse noch ein paar Startparameter wie den Workspace oder VM Speicherangaben mitzugeben:

Die Speicherangaben sind notwendig weil unter anderem der JBoss direkt aus Eclipse heraus gestartet werden soll und Eclipse somit genügend reservierten Arbeitsspeicher zur Verfügung hat. Ist eine solche .bat Datei oder eine Verknüpfung erstellt worden, sollte gleich getestet werden ob sich Eclipse auch starten lässt.

Ist dies der Fall fehlen noch die JBoss Tools Plugins in Eclipse und die Datenbank für das erste “Hello World” mit JBoss Seam.

Mit den JBoss Tools erhält man in Eclipse eine sehr gute Unterstützung für die Entwicklung mit den verschiedensten JBoss Elementen. Besonders schätze ich die Hibernate Tools, die Seam Tools und den RichFaces Visual Editor für die Syntax Unterstützung. Mit den Seam Tools wird später das Seam Projekt erstellt. Zuvor müssen diese allerdings erst installiert werden.
Bis vor kurzem mussten die einzelnen JBoss Tools Plugins noch als Nightly Build unter Eclipse Ganymede installiert werden. Seit ein paar Tagen ist allerdings die erste Version der JBoss Tools 3.0.0 (Alpha 1) veröffentlicht worden und man kann diese nun über den Eclipse Update Manager installieren.

Eclipse starten und im Hauptmenü unter “Help->Software Updates…->Available Software Tab->Add Site…” die JBoss Tools Development Update Seite http://download.jboss.org/jbosstools/updates/development hinzufügen.
Anschließend aufklappen und folgende im Screenshot sichtbar JBoss Tools Plugins selektieren:

Die Installation mit dem Button “Install…” starten, der Lizenz zustimmen und Eclipse nach der erfolgreichen Installation neu starten.

Wer eine ausführliche Beschreibung der Installation dieser 3.0.0 Alpha 1 Version sowie Schreenshots der neuen Features sehen möchte sollte sich den Artikel “JBoss Tools 3.0.0 Alpha1 – langsam geht es vorwärts” anschauen.

MySQL Datenbank installieren und konfigurieren

Die MySQL kann auf verschiedene Arten installiert werden. Ich verwende immer das Installationsprogramm und habe für meine Entwicklung eine MySQL Systemweit als Windows Dienst installiert. Den Dienst starte ich immer von Hand, wenn ich ihn benötige. Arbeitet man jeden Tag in dieser Umgebung kann man die Datenbank auch automatisch starten lassen.

Bei der Installation der Datenbank ist nichts zu beachten außer, dass man ein Passwort für seinen root User vergeben sollte an das man sich erinnert ;).
Anschließen noch die MySQL GUI Tools installieren. Ist beides Installiert kann man die Installation testen indem die Datenbank gestartet und sich über den MySQL Administrator (eines der GUI Tools) mit dem Benutzer root und dem vergebenen Passwort verbunden wird:

Es wird für das “Hello World Seam Projekt” eine Datenbank benötigt auf die wir vollen Zugriff haben. In MySQL muss dazu ein neues Schema erstellt werden. Am einfachsten und schnellsten geht das über das MySQL Administrator GUI Tool. Diesen also starten und sich als root auf localhost einloggen (Vorher natürlich noch MySQL starten).
Um ein neues Schema zu erstellen auf “Kataloge” klicken und anschließen darunter in der Liste der Schemata aus dem Context Menü (rechte Maustaste) “Neues Schema anlegen” selektieren.

Ich habe es seamprojekt genannt. Das neu erstellte Schema wird nun neben den anderen aufgelistet.

Nun fehlt noch der Benutzer für die Datenbankverbindung. Dazu auf den Punkt “Benutzerverwaltung” klicken und den Button “Neuen Nutzer anlegen” klicken (ist am unteren Rand zu finden). Username und Passwort vergeben – bei mir heißt hier seamdb mit dem Passwort seam – und den Button “Anwenden” drücken.

Als letztes müssen dem eben erstellten User noch die notwendigen Rechte vergeben werden. Dazu in dem User editieren Panel bleiben und das Tab “Schema-Berechtigungen” selektieren. Dort das zuvor erstellte Schema seamprojekt selektieren und sämtliche Rechte zuweisen. Das ganze mit dem Button “Anwenden” abschließen.

In einer Produktivumgebung vergibt man die Rechte natürlich selektiver – hier geht es lediglich um ein Testprojekt und erste Schritte mit Seam.

Damit der JBoss später von der deployten Anwendung aus auf die MySQL Datenbank zugreifen kann muss er den Datenbank Treiber im Classpath finden.
Dazu das heruntergeladene MySQL Connector/J Zip entpacken und das darin liegende mysql-connector-java-5.1.6-bin.jar in das lib Verzeichnis der JBoss Default Server Instanz legen (D:\Projekte\JBossSeam\jboss\jboss-4.2.2.GA\server\default\lib).

Nun ist die MySQL Datenbank und der JBoss soweit vorbereitet, dass es endlich an das erste Projekt gehen kann.

Erstes Hello World Seam Projekt erstellen

Nun gelangen wir endlich zu dem interessanten Teil: das “Hello World Seam Projekt” wird erstellt. Um ein solches Projekt zu erstellen bietet das JBoss Seam Framework uns die Möglichkeit das Grundgerüst eines Seam Projektes generieren zu lassen, was wir natürlich der Einfachheit halber ausnutzen wollen.

Seam liefert eine ziemlich coole Projektgenerierung mit dem Namen Seam Gen (seam-gen.bat) von Haus aus mit. In diesem Tutorial soll nicht mit Seam Gen ein Eclipse Projekt erstellt werden sondern mit den JBoss Tools Plugins, die einen Projekt Wizzard für Eclipse mitbringen. Wer einen Blick auf Seam Gen werfen möchte der kann dazu auch die ausführliche Anleitung aus der offiziellen Seam Dokumenation in Kapitel 2 lesen.

Noch ganz kurz zu dem elementaren Unterschied zwischen Seam Gen und den JBoss Tools Plugins: Mit Seam Gen wird ein einzelnes, erst einmal IDE unabhängiges, Projekt erstellt welches alle drei Teilbereiche (Web, EJB, EAR) sowie die Teststruktur in einem Ordner hält. Zusätzlich wird ein universelles Ant Build File für das Deployment, Erzeugung von neuen Seam Komponenten und Tests erstellt. Man kann später noch auswählen ob eine Projektstruktur für Eclipse oder Netbeans erstellt werden soll. Generell arbeitet man aber dennoch IDE unabhängig mit dem Ant Build File.

Das Utility “Seam Gen” befindet sich im Seam Verzeichnis unterhalb des Ordners seam-gen. Bei uns ist es somit im Verzeichnis “D:\Projekte\JBossSeam\jboss\jboss-seam-2.0.1.GA\seam-gen” zu finden.

Mit den Seam Tools Eclipse Plugin werden drei Einzelprojekte (Web, EJB, EAR) erstellt die zusammen ein ganzes ergeben. Das Testprojekt wird als viertes, auch separat liegendes Projekt, erzeugt, welches auf die anderen referenziert. Mehr zu dieser Projektstruktur sehen wir später noch. Arbeitet man also mit den Seam Tools legt man sich von vornherein auf die Eclipse als IDE fest und bekommt kein ANT Build File erstellt. Man deployt, erstellt und testet direkt aus Eclipse heraus.

Weil für die Projektgenerierung nicht das Batch File seam-gen.bat sondern das durch die Seam Tools verfügbare Eclipse Projekt Wizzard ist es wichtig, dass die JBoss Tools Plugins korrekt installiert wurden. Ist das der Fall kann eine JBoss Seam Perspektive in Eclipse ausgewählt werden.

In der Seam Perspektive stehen über das Hauptmenü (File->New) verschiedene Möglichkeiten für die Erstellung von Seam Komponenten (Action, Entity, Conversation, …) und einem Seam Web Projekt zur Verfügung. Wir selektieren natürlich die Auswahl “Seam Web Projekt“.

Es öffnet sich ein Projekt Wizzard mit dem ersten Dialog unter dem Namen “Seam Web Project” in dem schon einiges angegeben werden muss. Als erstes wird der Projektname vergeben – in diesem Beispiel soll das Projekt “HelloWorldSeamProjekt” benannt werden.

Als nächstes muss eine Server Runtime Target konfiguriert werden, wie auch im Dialog mit der Fehlermeldung “Target Runtime cannot be emtpy” angezeigt wird.

Um eine neue Server Runtime Target zu erstellen rechts neben der “Target Runtime” Auswahl auf den Button “New…” klicken um den JBoss AS 4.2 als Target Runtime zu selektieren.
In diesem Dialog werden unter zwei Ordnern JBoss AS Server Versionen angeboten. Wir verwenden “JBoss, a division of Red Hat” denn dieser wird durch die JBoss Tools mitgeliefert. Es muss natürlich die “JBoss 4.2 Runtime” selektiert werden und das Häckchen bei “Create a new local server” wird auch noch gesetzt. So ersparen wir uns später diesen Schritt.

Anschließend auf den Button “Next >” drücken. Im zweiten Schritt muss das Home Verzeichnis angegeben werden indem der JBoss AS liegt. Bei uns liegt er wie oben beschrieben unter “D:\Projekte\JBossSeam\jboss\jboss-4.2.2.GA”.

Button “Next >” drücken. Im letzten Schritt wird der Fehler “Deploy folder not specified” angeben, welcher ignoriert werden kann, denn das Deploy Directory ist ordentlich für die Default JBoss Server Instanz angegeben. Der Target Runtime Wizzard kann somit mit dem Button “Finish” beendet werden.

Man gelangt wieder in den ersten Dialog “New Seam Project” und die eben konfigurierte Target Runtime wurde angegeben. Auch der Target Server wurde durch das Setzen der Checkbox “Create a new local server” im Target Runtime Dialog unter dem Namen “JBoss 4.2 Server” erstellt und nun selektiert.

Als nächstes muss die “Dynamic Web Module version” ausgewählt werden. Wir verwenden die Version 2.5, welche wahrscheinlich auch schon vorselektiert wurde.

Die letzte wichtige Konfiguration auf diesem Dialog ist der letzte ganz unten unter “Configuration”. Dort muss “Dynamic Web Project with Seam 2.0″ selektiert sein.

Der fertig konfigurierte Dialog sieht anschließend wie folgt aus:

Mit dem Button “Next >” diesen ersten Dialog verlassen und in den nächsten Schritt gehen um das Web Modul zu konfigurieren.

In diesem zweiten Dialog “Web Module” kann angegeben werden unter welchem Context Root (Teil der Url: http://localhost:8080/) die Web Anwendung erreichbar sein soll. Ich persönlich verwende an dieser Stelle immer den Projektnamen und lass die Default Einstellung so stehen.
Die zweite Angabe ist das “Content Directory”. Die Default Angabe ist immer “WebContent” – ich änder das immer auf “web” ab. Aber das ist Geschmackssache. Das “Content Directory” ist im Web Projekt der Ordner unter dem die .xhtml Dateien, der /META-INF Ordner und die web.xml liegen.
Das “Java Source Directory” bleibt auf “src” und die Checkbox für “Generate deployment descriptor” ist selektiert.

Mit dem Button “Next >” diesen Dialog beenden und in den nächsten Schritt gehen um die JSF Einstellungen zu konfigurieren.

In diesem Dialog bleibt alles so wie vorgegeben.

Somit direkt mit dem Button “Next >” weitergehen um Seam zu konfigurieren.

In diesem Dialog “Seam Facet” muss die “Seam Runtime” angegeben werden wie auch die Fehlermeldung “Seam Runtime is not selected” aufzeigt.

Zuerst muss die Seam Runtime erstellt und konfiguriert werden.

Den Button “Add…” drücken um in einen Unterdialog für die Seam Runtime Konfiguration zu gelangen. In dem “Seam Runtime” Dialog den “Seam Home Folder”, also das Seam Verzeichnis, angeben. Bei uns liegt dieser neben dem JBoss AS unter “D:\Projekte\JBossSeam\jboss\jboss-seam-2.0.1.GA“.

Den Unterdialog mit dem Button “Finish” beenden.

Anschließend ist die “Seam Runtime” konfiguriert und da wir ein EAR Projekt erstellen wollen muss der EAR Radio Button noch selektiert werden.

Nachdem die Seam Runtime nun konfiguriert ist wird bemängelt, dass noch kein “Connection Profile” selektiert ist.

Um ein “Connection Profile” selektieren zu können muss erst einmal eines erstellt werden. Dazu zuerst unter “Database Type” die MySQL “MySQL 5 (InnoDB)” heraussuchen und selektieren. Anschließend neben der noch leeren “Connection Profile” Angabe den Button “New…” drücken. Es erscheint ein neuer Connection Profile Wizzard.
Darin den Connection Profile Type “MySQL” selektieren und einen Namen, z.B. “Lokale MySQL”, dafür vergeben.

Mit dem Button “Next >” in den nächsten Schritt gehen um den MySQL Treiber zu konfigurieren.
Es wird verlangt, dass man einen Treiber definiert und selektiert.

Dazu rechts neben der leeren Treiber Selektbox auf den Button (ist nur ein rundes gebliches Bild) “New Driver Definition” klicken. Anschließend im ersten Reiter “Name/Type” den Namen und Typ der MySQL angeben. Wir verwenden eine “MySQL 5.0″.

Im zweiten Reiter “Jar List” muss nun der MySQL Connector/J Treiber selektiert werden. Dazu erst den voreingetragenen Wert mit dem Button “Clear All” entfernen und anschließend mit dem Button “Add Jar/Zip” den im JBoss Default Server abgelegten MySQL Connector/J Treiber mysql-connector-java-5.1.6-bin.jar hinzufügen. Zur Erinnerung: der Treiber wurde im Projektordner im JBoss AS Verzeichnis abgelegt (D:\Projekte\JBossSeam\jboss\jboss-4.2.2.GA\server\default\lib).

Den Dialog mit “OK” beenden.
Anschließend können die Daten für die bereits eingerichtete Datenbank seamprojekt (url: jdbc:mysql://localhost:3306/seamprojekt ) angegeben (user: seamdb & pw: seam) werden.

Mit dem Button “Test Connection” kann die konfigurierte Verbindung getestet werden. Die Prüfung sollte positiv mit einer “Ping succeeded!” Meldung enden.

Wenn dem nicht so ist sollte überprüft werden ob die Datenbank generell läuft (MySQL Administrator), ob der User und das Passwort richtig vergeben sind (man kann sich z.B. mit dem MySQL Query Browser gegen die Datenbank mit dem User verbinden) und ob die Angaben in dem Dialog korrekt eingegeben wurden.

Funktioniert die Datenbankverbindung kann der Dialog mit “Finish” beendet werden.
Nun ist das Connection Profile eingerichtet und als letztes muss noch das Datenbank Schema angegeben werden. In unserem Fall heißt es wie die konfigurierte Datenbank selbst: “seamprojekt”.

Der letzte in diesem Dialog zu konfigurierende Punkt sind die Package Vorgaben für die Code Generation. Wenn das Projekt erstellt wird, werden initial einige Java Klassen erstellt. Die hier konfigurierten Package Namen werden dafür verwendet. Aber auch für die später über die verfügbaren Seam Dialoge (File->New…) erstellten Klassen werden diese Angaben hier verwendet. Aus diesem Grund sollten wir sie also richtig anpassen. Man kann als Package Namen verwenden was man möchte – ich nehme natürlich de.javathreads.helloworldseamprojekt (Java Packages sollten übrigens klein geschrieben werden).
Mein vollständiges Dialogfenster mit konfigurierter Seam Runtime, dem Connection Profile und den Package Angaben sieht nun wie folgt aus:

Den Projekt Wizzard mit dem Button “Finish” beenden.

Das “Hello Word Seam Projekt” EAR Projekt wird nun automatisch erstellt und mit allen Grundkonfigurationen versehen.

Es werden insgesamt vier Teilprojekte von den Seam Tools erstellt. Dabei sind drei für das EAR Projekt direkt relevant und das letzte ist ein Projekt für die Unit Tests.

Erstes Deployment und das berühmte “Hello World”

Nachdem nun die Entwicklungsumgebung eingerichtet ist und das Projekt scheinbar ordentlich erstellt wurde kann man es direkt auf den JBoss AS deployen. Es wurde ein lauffähiges EAR Projekt mit der Verwendung von Hibernate, Sun JSF-RI 1.2, RichFaces und Facelets erstellt und vorkonfiguriert. Das Projekt müsste eigentlich auch automatisch dem konfiguriertem JBoss Server für das Deployment hinzugefügt worden sein.

Aber es lohnt sich das noch einmal selbst kurz zu überprüfen. Um das Projekt auf dem JBoss zu deployen muss die JBoss Server View geöffnet werden. Diese sollte sogar schon sichtbar sein ansonsten über das Hauptmenü die JBoss Server View öffnen: “Windows->Show View->Other…->Server->JBoss Server View”. Um das Projekt dem Server für das Deployment bekannt zu machen mit der rechten Maustaste auf den Server klicken und “Add and Remove Projects…” selektieren.

Anschließend ist ein Dialog zu sehen in dem auf der linken Seite alle für ein Deployment verfügbaren Projekte und rechts alle Projekte die auf diesem JBoss deployt werden sollen zu sehen. In unserem Fall sieht man das HelloWorldSeamProjekt.ear und eine Datasource Konfiguration HelloWorldSeamProjekt-ds.xml. Diese Datei muss mit auf den JBoss deployt werden weil es die Datenkbankkonfiguration für unser Hello World Projekt enthält. Auf einem JBoss werden die Datenbankkonfigurationen in einem bestimmten XML Format in die Server Instanz gelegt und somit bekannt gemacht.
Der Dialog kann mit Finish beendet werden und anschließend ist das Projekt und die Datasource unter JBoss 4.2 sichtbar.

Der JBoss kann nun gestartet werden. Dazu mit der rechten Maustaste auf den JBoss 4.2 Server->Start oder den Server selektieren und den grünen runden Start Button in der Server View drücken. Unter Windows kann es passieren, dass man gefragt wird ob der Server oder Java weiterhin geblockt werden sollen aber wir erlauben natürlich die Ausführung dieser Programme.

Ist der Server einmal gestartet so steht als Status “Started”, was noch nicht bedeuten muss, dass dieser auch erfolgreich gestartet ist.

In der Console sind die Log Ausgaben des JBoss Servers zu sehen. Man sollte die Logausgaben des JBoss AS immer auf Fehler überprüfen. Dazu die Console View selektieren und einmal komplett nach oben scrollen um sich zu vergewissern, dass keine Exception während des Starts geworfen wurde.

Bei mir kam z.B. beim ersten Start folgende Exception:

Und Tatsächlich hatte sich in meiner Datasource Konfiguration in dem Passwort ein falsches Zeichen am Ende eingeschlichen (das PW lautet nur “seam” und nicht “seamd”). Die Datasource Konfiguration HelloWorldSeamProjekt-ds.xml befindet sich übrigens im EAR Projekt HelloWorldSeamProjekt-ear unterhalb des resources Ordner:

  
    HelloWorldSeamProjektDatasource
    jdbc:mysql://localhost:3306/seamprojekt
    com.mysql.jdbc.Driver
    seamdb
seamd
  

Das falsche Zeichen habe ich nun entfernt und den Server neu gestartet.

Nun ist dieser ohne Exceptions zu werfen, wie es auch sein sollte, hochgefahren und gestartet. Das korrekte Deployment kann in der Console nachgeprüft werden. Die letzte Zeilen sagen aus, dass das Projekt deployt wurde und der Server erfolgreich gestartet ist.

Alle deployten Anwendungen werden, wie weiter oben in dem Server Runtime Environment konfiguriert, in die JBoss Default Server Instanz deployt. Im Jboss liegen alle Anwendungen im Verzeichnis default unterhalb des JBoss Server Instanz Verzeichnisses. Unsere eben deployte Anwendung befindet sich somit im Verzeichnis D:\Projekte\JBossSeam\jboss\jboss-4.2.2.GA\server\default\deploy, wie auch der Screenshot zeigt:

Der lokale JBoss bzw. dessen Management Konsole ist per Default unter dem Port 8080 erreichbar. Mit der Adresse http://localhost:8080 gelangt man somit auf die Einstiegsseite des lokalen JBoss AS:

Und der Aufruf zu dem generierten “Hello World Seam Projekt” ist unter der URL http://localhost:8080/HelloWorldSeamProjekt erreichbar:

Als letztes fehlt uns noch zu unserem Glück der eigentliche “Hello World” Text. Dazu öffnen wir im Visual Page Editor, welcher per default für die Dateien mit der Endung .xhtml unter Eclipse verknüpft ist, die home.xhtml. Diese Datei befindet sich im Web Projekt, welches das einzige Projekt ohne Zusatz ist und als Icon eine Weltkugel über dem Ordner hat. Alternativ kann natürlich auch mit STRG-SHIFT-R der “Open Resource” Dialog geöffnet werden um die Datei zu öffnen.

Speichert man die Änderungen startet das Hot Deployment der geänderten Dateien auf den JBoss AS. Per default wird das Hot Deployment erst nach 15 Sekunden durchgeführt.

Anschließend im Browser F5 drücken oder in der Adressleiste noch einmal die URL aufrufen und das eben erstellte “Hello World” erscheint.

Fazit

Obwohl es viel und evtl. sogar kompliziert aussieht werden diejenigen, die ein solches Projekt schon einmal von Hand aufgesetzt und konfiguriert haben merken, dass es nun wesentlich schneller und einfacher ging. Vor allem für einen schnellen Einstieg in die Entwicklung eines JBoss Seam JEE5 Projektes aber auch für ein gewöhnliches Web Projekt ist dieser Weg sehr bequem.
Hat man diesen Projekt Wizzard erst einmal initial konfiguriert kann man bereits konfigurierte Teile für die Erstellung eines nächsten Projektes wiederverwenden.
Ist man erst einmal vertraut mit dem Projekt Wizzard erstellt man ein neues Projekt binnen ein paar Minuten.

Meiner Meinung nach ist der größte Vorteil der, dass verschiedenen Frameworks wie Facelets, JBoss RichFaces, JBoss Seam und JSF 1.2 RI bereits so konfiguriert sind, dass sie miteinander arbeiten. Unerfahrene Leute benötigen allein an der Konfiguration für das Zusammenspiel der einzelnen Frameworks sehr viel Zeit.

Wer mit JBoss Seam, JBoss RichFaces, Facelets oder gar JSF generell noch nicht vertraut ist sollte damit Anfangen das generierte Projekt zu erkunden und damit herumspielen. Das fängt bei der Verwendung von Facelets mit dem Template und Tags an, geht über die Verwendung der RichFaces Komponenten bis hin zu Ajax, dann kommt JBoss Seam mit seinen verschiedenen Komponenten (Authentifizierung, EntityQuery, EntityHome, Scopes) bis zuletzt zu der Verwendung von JEE 5 Technologien wie EJB 3.0 und JPA/Hibernate für die Persistierung.
Man kann allein bei dem generiertem Projekt viel lernen und ausprobieren. Viel kaputtmachen kann man nicht denn zur Not erstellt man sich das Projekt einfach schnell noch einmal neu.

Wer sich mit den Technologien auskennt sollte das Projekt nach seinem Geschmack anpassen wie z.b. das erstellen des Domänenmodells, Packages anpassen, Testprojekt aufsetzen usw..

Insgesamt sollte dieses Tutorial nur aufzeigen wie man in ein solches Projekt für JBoss Seam aufsetzen kann und mein Fazit darüber ist, dass es noch nie so einfach war ein solches Projekt zu starten bzw. sich zu erstellen.
Ich werde wohl in Zukunft noch des öfteren auf diese Tutorial Bezug nehmen – vor allem wenn ich einzelne Teile von Seam oder sonstiger JSF Entwicklung beschreiben werde.

Viel Spass beim ausprobieren!

This is an alpha version so do not just throw us away when your computer blows up while using this version..

Bisher war die einzige Möglichkeit die JBoss Tools als Nightly Build unter Eclipse Ganymede zu verwenden. Somit ist neben der allgemeinen Nachricht, dass eine erste offizielle Vorabversion Alpha 1 existiert, ist die zweite schöne Nachricht, dass man die JBoss Tools 3.x nicht mehr manuell herunterladen muss (Nightly Build) sondern diese über eine Eclipse Update Seite angeboten werden.
Die URL zu der JBoss Tools Development Update Seite ist:
http://download.jboss.org/jbosstools/updates/development
Diese wie gewohnt in Eclipse im Hauptmenü unter “Help->Software Updates…->Available Software Tab->Add Site..” hinzufügen und anschließend aufklappen um die einzelnen Plugins zu selektieren.

In der Alpha 1 Version der JBoss Tools 3.0.0 bestehen schon einige Erneuerungen, die auch schon durch die Nightly Build Version dem ein oder anderen bekannt sind:

• Seam Tools – grafische pages.xml
• Visual Page Editor – EL Ersetzung, CSS Editor und Geschwindigkeitsverbesserungen
• Hibernate Tools – Dali Unterstützung für Hibernate
• JBoss AS Tools – Konfigurierbare Server Ports
• Web Services – Eclipse WTP WebServices Unterstützung für JBossWS

Im folgenden die einzelnen neuen JBoss Tools Plugins Features mit Screenshots.

Die Konfigurationsdatei für die Navigation über die xhtml Seiten einer Seam Anwendung haben in der pages.xml ihren Platz. Diese können nun auch grafisch dargestellt werden:

Die dazugehörige Outline der grafischen Ansicht sowie der allgemeinen Konfiguration ist auch vorhanden:

Wer mit dem Visual Page Editor für xhtml/jsf Seiten arbeitet erhält auch noch zwei interessante Erweiterungen. Die erste erlaubt für die visuelle Vorschau im Editor eine konfigurierbare EL Ersetzung. So kann z.b. der Pfad zu einem Bild, welcher über eine EL (z.B. #{projectConst.imgPath}) durch einen Ausdruck ersetzt werden.

Bisher wurden EL Ausdrücke nicht interpretiert sondern einfach ausgegeben.

Die zweite Erweiterung ermöglicht den Aufruf eines CSS Editors mit Vorschau für Style Angaben direkt an einem Element. Selektiert man ein Element (Komponente) im Visual Page Editor ist es möglich über die Eigenschaften (Properties View) den CSS Editor zu öffnen.

Jetzt ist man wieder einem Schritt näher eine Seite komplett im Visual Editor bearbeiten zu können. Ich bin allerdings immer noch der Meinung, dass es brauchbarer ist ein funktionierendes Hot Deployment zu haben und nur im HTML Code direkt zu arbeiten.

Die letzte nennenswerte Erweiterung ist der Performance Update bei der visuellen Vorschau der Seite. Diese läuft nun in einem separatem Thread und blockiert Eclipse nicht mehr.

Ein interessanter Schritt ist die Hibernate Unterstützung für die Dali Plugins für Eclipse WTP. So kann man zukünftig mit Hilfe der Hibernate Tools ein JPA Projekt auf Basis von Hibernate erstellen.

In einem Dali JPA Projekt kann man nun zudem die DDL (Data Definition Language – SQL Schema) Beschreibung direkt aus dem JPA Menü generieren lassen:

Alternativ besteht natürlich immer noch die Möglichkeit sich die DDL mit dem HibernateTool Ant Task generieren zu lassen:

Bei den JBoss AS Tools kam die Möglichkeit den Ports für den JBoss manuell zu konfigurieren. Bisher wurden diese immer automatisch erkannt/gesetzt. Weitere Konfigurationen, wie z.b. Timeouts oder Server polling, sind in den JBoss AS Server Editor verschoben worden. Bisher waren diese nur über die Eclipse Preferences zu konfigurieren.

Arbeitet man mit Web Services unter dem JBoss (JBossWS) so besteht ab sofort die Möglichkeit die Eclipse WTP WebServices Unterstützung mit JBossWs zu nutzen. Dazu besteht ein eigenes Project Facet:

Bei mir sind die JBoss Tools an zwei Stellen fehlerhaft. Zum einen war das die JBoss Server View, die nicht mehr aufgerufen werden konnte und sich direkt mit einer Exception verabschiedet hat. Dieses Problem konnte man aber einfach mit der normalen WTP Server View umgehen, da diese auch die aktuellen JBoss Server unterstützt.
Zum anderen funktionierten die Hibernate Tools unter Ganymede nicht mehr. Es kam ständig die Exception java.lang.NoClassDefFoundError: org/eclipse/ui/internal/util/SWTResourceUtil, welche eine wirkliche Nutzung der Hibernate Tools unmöglich macht.

Es bestehen nun zwei Möglichkeiten, wenn man die Hibernate Tools dringend benötigt oder nicht auf sie verzichten möchte.

Die wirklich einfachste Variante ist, wieder Eclipse Europa zu verwenden und warten bis JBoss eine neue Version der JBoss Tools mit Unterstützung für Eclipse Ganymede veröffentlicht.
JBoss hat in ihrem JBoss Tools Forum angekündigt, dass die aktuelle Version 2.1.x die letzte Version ist, die gegen Eclipse Europa (Version 3.3) entwickelt wurde. Ab sofort wird gegen Eclipse Ganymede (Version 3.4) entwickelt und dafür wurden im ersten Schritt erst einmal alle Compile Fehler beseitigt, was auch als bleeding edge betitelt wird.

The first build was made possible by simply fixing all compile errors that was found. Thus this is as bleeding edge as it gets – we can’t guarantee anything ;)

Aber genau diese erste Fehlerbeseitigung bringt uns direkt zur zweiten Möglichkeit: Die JBoss Tools Nightly Build verwenden. Die Installation der Nightly Build Version ist eigentlich recht einfach durchzuführen und auf den ersten Blick funktionieren die wichtigsten Plugins, wie z.B. für mich die Hibernate Tools, bei mir in Eclipse Ganymede ohne Probleme (zumidestens bei den ersten Versuchen).

Da wie auch ich manche User im JBoss Tools Forum mit den “bleeding edges” leben können sind im folgenden die notwendigen Schritte notiert, die nötig sind um die Nightly Build Version zum laufen zu bekommen:

• Herunterladen der letzten JBoss Tools Nightly Build Version. Empfehlen würde ich das “ALL”-Zip in dem alle Plugins enthalten sind, denn damit erspart man sich Probleme mit den Abhängigkeiten.
• Entpacken des Zips in einen Order der Wahl, z.B. D:\\eclipse-plugins\jbosstoolsnightly
• Unter dem Eclipse Ganymede Installationsordner einen links Ordner erstellen.
• In diesen Links Ordner eine .link Datei erstellen – z.B. jbosstoolsnightly.link
• In dieser Link Datei den Pfad zu den JBoss Tools Plugin Ordner angeben in dem der entpackte Nightly Build liegt: path=d:/eclipse-plugins/jbosstoolsnightly
• Die alten JBoss Tools aus Eclipse Ganymede deinstallieren (Hauptmenü->Help->Software Updates…->Installed Software Tab->Die verschiedenen JBoss Tools Plugins selektieren und “Uninstall” klicken)
• Eclipse Ganymede mit dem Parameter “-clean” neu starten.

Alternativ kann man das Nightly Build auch direkt in den Eclipse Ordner kopieren allerdings hat man dann eher Schwierigkeiten die verschiedenen Plugins sowie Abhängigkeiten wieder zu deinstallieren. Von daher ist die sauberere Methode die Plugins in einem separatem Ordner zu entpacken und in Eclipse nur darauf zu verweisen. Der Vorteil liegt darin, dass man die Plugins sehr einfach aktualisieren oder wieder entfernen kann.

Eine mögliche Alternative zu dem manuellen Installieren der Nightly Build Version wurde auch schon im Forum angekündigt: Man möchte eine Update Seite für die Nightly Build Versionen zur Verfügung stellen um das Updaten der Plugins so einfach wie möglich während der Entwicklung zu machen.

We are going to provide update-site for nightly builds to have easy way to get updates for JBoosTools during development cycle.

Ich glaube irgendwo gelesen zu haben, dass die JBoss Tools 3.0 erst gegen Ende des Jahres rauskommen sollen (Version GA). Von daher kann die hier beschriebene Lösung doch für den ein oder anderen nützlich sein.

Nach einiger Zeit ist die erste offizielle JBoss Tools Alpha 1 veröffentlicht worden und über die Development Update Seite verfügbar. Es bestehen zwei Möglichkeiten auf diese Version zu updaten:

Dazu unter den Software Updates das “Installed Software” Tab die installierten Plugins selektieren und den Button “Update…” drücken.

Anschließend noch bestätigen und die neue Alpha 1 Version wird installiert.

Weil ein für die Nightly Build Version ein separater Ordner verwendet wurde kann dieser einfach gelöscht oder umbenannt werden. Anschließend die .link Datei aus dem eclipse/links Ordner entfernen und Eclipse mit dem Paramter -clean neu starten.
Die JBoss Tools Nightly Build sind nun nicht mehr vorhanden und können neu und sauber über die Development Update Seite http://download.jboss.org/jbosstools/updates/development neu installieren.
Einen ausführlicheren Bericht über die Alpha 1 Version ist in dem Artikel “JBoss Tools 3.0.0 Alpha1 – langsam geht es vorwärts” zu finden.

Mittlerweile besteht die Möglichkeit die JBoss Tools Nightly Build Version auch über eine Update Seite zu installieren.

[21.10.] Link zur Beschreibung der JBoss Tools Nightly Build Update Seite hinzugefügt

Aber wie am besten starten und was gibt es neues in Ganymede? Dieser Artikel ist in folgenden Abschnitte unterteilt:

• Eclipse Ganymede Packages
• Erweiterungen und Änderungen in Ganymede
• Was macht Eclipse für JEE Entwickler interessant?
• Die JBoss Tools in Ganymede
• Fazit

Um die Entwicklung mit Eclipse zu starten bietet es sich an ein vorkonfiguriertes Eclipse Package herunterzuladen. Insgesamt stehen 7 große Packages und etliche Projekte für Ganymede zum Download bereit. Neben der generellen Übersicht, wie sie auch im folgenden Screenshot zu sehen ist, kann man die einzelnen Packages miteinander vergleichen und sieht so auf einen Blick welche Tools (z.B. Mylin, Web Tools oder XML Tools) in einem Package direkt mitgeliefert werden.

Neben den altbekannten Packages wie zum Beispiele das Eclipse Classic oder die Eclipse IDE for Java Developers wird für die folgenden Erläuterungen das Eclipse IDE for Java EE Developers verwendet. Neu hinzugekommen ist übrigens das Package Eclipse BIRT (Business Intelligence and Reporting Tools), welches für die Entwicklung von Java und Java EE Anwendungen mit Reporing Belangen entsprechen soll. Dabei wird die Unterstüztung für das Projekt BIRT schon in Eclipse mitgeliefert.

Ein weiteres sehr interessantes Projekt ist die IDE for C/C++ Developers mit der man, wie der Name schon vermuten lässt, C oder C++ Anwendungen entwickeln kann. Gerade in diesem Bereich sah es lange Zeit sehr mau aus und man konnte entweder zu dem großen kommerziellen Bruder Visual Studio oder einem einfachen Editor greifen. Selbst habe ich letztes Jahr einiges mit der C/C++ Entwicklungsumgebung gearbeitet und war damals auch schon positiv überascht, auch wenn es noch einige komische Verhaltensmuster aufgezeigt hat. Mit Ganymede wird auch die neueste CDT Version mitgeliefert, so dass man da auch einige Verbesserungen erwarten kann. Jedenfalls erobert an dieser Stelle Eclipse einen komplette anderen Bereich außerhalb von Java.

Software Updates
Mit dieser neuen Eclipse Version hat sich auch einiges geändert. Was einem wohl mit als erstes auffallen dürfte ist, dass das Plugin Management komplett umgebaut wurde und nun “Software Updates” heißt. So ist das Installieren und Verwalten von Eclipse Plugins jetzt zentraler und dadurch einfacher gestaltet und kann durch das Hauptmenü (Help->Software Updates) aufgerufen werden.

Neben diesem neuen Auftreten mit dem Update Manager ist es nun möglich installierte Features/Plugins auf ihre Aktualität zu prüfen. Dafür ist der Automatic Update Scheduler zuständig. So kann zum einen der Zeitpunkt an dem nach möglichen Updates geschaut werden soll konfiguriert werden wie z.B. bei jedem Starten von Eclipse (Default Einstellung) oder aber auch nur einmal in der Woche. Für den Fall, dass neue Updates für Features gefunden wurden kann entschieden werden was passieren soll. In der Voreinstellung wird man lediglich darauf hingwiesen, man kann aber auch einstellen, dass das neue Update direkt installiert werden soll. Allerdings wäre ich mit dieser Einstellung vorsichtig. Natürlich kann man diese Überprüfung auf neue Updates auch ausschalten

Java Editor
Eclipse Ganymede hat aber auch einige Erweiterungen für die Java Entwicklung im Editor und Refactoring mitgebracht. Welches mit am schnellsten auffallen dürfte ist die Java Editor Breadcrumb Trail. Diese Editor Breadcrumb Trail kann man entweder über das Context Menü (rechte Maustaste im Editor), über die Toolbar (Icon links neben dem Hervorheben Icon) oder über die Tastenkombination “Alt+Shift+B” eingeschaltet werden. Im folgenden Screenshot ist das Contextmenü zu sehen.
Darin sieht man auch gleich eine weitere neue Kleinigkeit die bei dem Hervorheben von dem Vorkommen eines Attributs in der Klasse zu sehen ist. Während bisher immer nur generell das Vorkommen/Verwenden eines in der Klasse grau hervorgehoben wurde, wird in Ganymede zwischen einer lesenden und einer schreibenden Aktion unterschieden. Überschreibt man ein Attribut, wie hier in diesem Beispiel im Setter die Referenz der Adresse, so wird dieses Attribut anders hervorgehoben als bei einer lesenden Aktion. Dieses Erweiterung scheint klein, aber während der Entwicklung kann sich das als sehr nützlich erweisen.

Ist die Editor Breadcrumb Trail einmal geöffnet kann man in dieser wie im Package Explorer zwischen den Packages, Klassen und Attributen navigieren.

Wie diese Veränderungen in der Verwendung aussehen zeigt der Screencastblog sehr schön in einem kurzen Video. Erläutert werden dabei die neuen Funktionen “Klasse extrahieren – Refactoring”, “Neue Schnell-Assistenten” und der “Java Editor Breadcrumb”.

Dieser Abschnitt ist eigentlich genereller Natur, aber wenn man gerade bei dem Thema ist kann man auch hier noch ein oder zwei Worte verlieren. Einer der wirklich großen Vorteile in der Entwicklung einer Web oder JEE Anwendung ist die Toolunterstützung für die verschiedenen Aspekte bei der JEE Entwicklung. Es beginnt bei der Verwendung von JPA in Verbindung mit einer Datenbank, bei dem Schreiben der Deployment Descriptoren oder Konfigurationsfile über Entwicklung der Oberfläche und dem Autocomplete im HTML/JSP Editor bis hin zum Deployen der Anwendung und Hot-Deployment auf einen Server. All das bietet mittlerweile Eclipse in seinem IDE for Java EE Developers Package von Haus aus in einer mittlerweile ausgereiften Version. Das Package ist ca 160 MB groß und man kann direkt nach dem herunterladen mit der Entwicklung starten.

Eines der meiner Meinung nach wichtigsten Features ist die direkte Server Unterstützung in Eclipse. Entwickelt man eine Anwendung für den Tomcat ist das schnelle Starten und Stoppen sowie Hot Deployment einfach unersätzlich. In der Server View lässt sich der Server direkt Starten und Stoppen und einmal gestartet werden Änderungen im Source Code automatisch oder mit Verzögerung direkt deployt.

Es werden mittlerweile viele Server von Haus aus unterstützt aber alle gängigen Server, wie zum Beispiel der Glassfish, bieten einen Server Adapter für das WTP Plugin an.

Mitlerweile ist auch das Portieren eines Java Projektes hin zu einem WTP Projektes nicht mehr so unmöglich wie früher.
Im Bereich der Oberflächen hat sich die Unterstützung für die Entwicklung von JSF Seiten sehr verbessert. So werden z.b. konfigurierte Backing Beans in der Autocomplete Funktion bei der Expression Language erkannt und Methoden sowie Attribute daraus angeboten. Aber auch die Validierung von HTML oder XML Seiten direkt im Editor ist sehr praktisch.

Ein weiterer interessanter Punkt ist die Data Tools Plattform, welche im JEE Package schon mit enthalten sind. So kann man direkt aus Eclipse heraus sich mit einer Datenbank verbinden und Operationen darauf ausführen.

Passend zu diesen kurzen Vorstellungen bietet sich das Tutorial “Creating Database Web Applications with Eclipse” aus den eclipse.org Resourcen an um einen weiteren Überblick über die Entwicklung einer Web Anwendung mit der Toolunterstützung von Eclipse zu erhalten.

Aktuell arbeite ich sehr viel mit den JBoss Tools und die habe ich dann natürlich auch in Ganymede installiert. Es gilt nach wie vor die gleich Update URL (http://downloads.jboss.org/jbosstools/updates/stable) lediglich die Art des Installieren weicht ein wenig von der Europa Version ab. Zum hinzufügen der Update URL über den Software Manager gehen (Hauptmenü->Help->Software Updates..) dort den Reiter “Available Software” anklicken und mit dem Button “Add Site…” die Update Seite hinzufügen.

Es scheint auf den ersten Blick keine kaum Probleme mit der neuen Ganymede Version zu geben. Leider gibt es Probleme bei der Verwendung der JBoss Tools Plugins mit Ganymede. Konkret funktioniert die JBoss Server View sowie die Hibernate Tools nicht mehr richtig.

Für die JBoss Server View besteht die Möglichkeit die Servier View des WTP Projektes zu verwenden. Da in der aktuellen WTP Version alle JBoss Application Server bis hin zur Version 5.0 von Haus aus unterstützt werden kann man den JBoss AS somit auch über die normale Server View starten und stoppen.

Bei den Hibernate Tools sieht das ganze schon etwas anders aus. Wechselt man in die Hibernate Perspektive so erscheint in Ganymede eine NoClassDefFoundError Exception (java.lang.NoClassDefFoundError: org/eclipse/ui/internal/util/SWTResourceUtil – ein JIRA Eintrag besteht schon). Anschließend werden die Icons der Hibernate Configurations nicht angezeigt und bei jedem klick wird die Exception neu geworfen und blockiert die Eclipse. Somit sind die Hibernate Tools nicht wirklich brauchbar.
Eine vorläufige Abhilfe kann das Verwenden der Hibernate Tools ANT Unterstützung sein um schnell Schema DDLs oder Updates direkt auf der Datenbank durchzuführen. Andernfalls muss, wenn die Verwendung der Hibernate Tools zwingend ist, wieder auf Eclipse Europa zurückgegangen werden bis eine neue Version des Plugins verfügbar ist.

Als wirklich brauchbare Alternative um die JBoss Tools weiterhin zu verwenden besteht die Möglichkeit die JBoss Tools Nightly Build Version in Ganymede installieren. Mehr Infos wie z.b. die Installationsanleitung gibt es hier.

Wie man die JBoss Tools bzw. das Subprojekt Hibernate Tools am besten einrichtet und was man damit anstellen kann, wird in dem Artikel “Unterstützung für JPA – Hibernate Tools in Eclipse” ausführlich erläutert.

Als Fallback Variante habe ich immer noch den VIM auf dem System installiert aber solange mein Eclipse irgendwie läuft möchte ich nicht darauf verzichten. Mit Eclipse Ganymede ist wieder ein schöner Schritt nach vorne gemacht worden und immer mehr Facetten der Entwicklung werden unterstützt. Man kann sehr gespannt sein wie es weitergeht.